用 golang 开发天气查询 cli 工具的核心步骤包括:1. 选择 api 并获取 key,如 openweathermap、weatherapi 或和风天气;2. 使用 flag 包处理命令行参数,获取用户输入的城市名;3. 发起 http 请求并解析返回的 json 数据,构造 url、发送 get 请求、定义结构体解析响应内容;4. 可选优化包括从环境变量读取 api key 和增加错误提示。整个过程依赖基础的 http 请求与 json 解析能力,注意细节处理可提升用户体验。

用 Golang 开发一个天气查询的 CLI 工具,其实并不复杂。核心流程就是:获取用户输入、调用公开 API、解析返回数据、输出结果。只要掌握基本的 HTTP 请求和 JSON 解析方法,就能快速上手。

下面我来分几个步骤讲讲整个实现过程。

1. 准备工作:选好 API 和获取 Key
首先,你需要找一个提供天气信息的公开 API。比较常用的有:
立即学习“go语言免费学习笔记(深入)”;
OpenWeatherMap(https://www.php.cn/link/a5aef5357bc5d38853c0b0d3cca7bf8c)WeatherAPI(https://www.php.cn/link/875ffa7f896a4da039e296e2d1f54937)和风天气(适合中文用户)
这些服务通常都提供免费额度,注册账号后可以获取到一个 API Key。

以 OpenWeatherMap 为例,它的当前天气接口地址是:
http://api.openweathermap.org/data/2.5/weather?q={city}&appid={YOUR_API_KEY}
你只需要替换 {city} 和 {YOUR_API_KEY} 就能发起请求了。
2. 编写命令行参数处理逻辑
Golang 中可以使用 os.Args 或者更方便的 flag 包来处理命令行参数。
比如我们想让程序支持这样的用法:
weather --city beijing
就可以这样写:
var city stringflag.StringVar(&city, "city", "", "城市名称")flag.Parse()if city == "" { fmt.Println("请指定城市名,例如:--city shanghai") os.Exit(1)}
这样就能从命令行拿到用户输入的城市名了。
3. 发起 HTTP 请求并解析响应
这一步是整个程序的核心。我们需要构造请求 URL,发送 GET 请求,并解析返回的 JSON 数据。
示例代码如下:
url := fmt.Sprintf("http://api.openweathermap.org/data/2.5/weather?q=%s&appid=%s", city, apiKey)resp, err := http.Get(url)if err != nil { log.Fatalf("请求失败:%v", err)}defer resp.Body.Close()body, _ := io.ReadAll(resp.Body)// 定义结构体用于解析JSONtype WeatherResponse struct { Name string `json:"name"` Main struct { Temp float64 `json:"temp"` } `json:"main"`}var wr WeatherResponsejson.Unmarshal(body, &wr)fmt.Printf("城市:%sn", wr.Name)fmt.Printf("温度:%.2f Kn", wr.Main.Temp)
注意:OpenWeatherMap 返回的温度单位是开尔文(K),如果需要摄氏度,可以用 Temp - 273.15 转换。
4. 可选优化:封装配置和错误提示
为了不让 API Key 硬编码在代码里,你可以把它放到环境变量中:
apiKey := os.Getenv("WEATHER_API_KEY")if apiKey == "" { log.Fatal("请设置环境变量 WEATHER_API_KEY")}
另外,还可以增加一些人性化的提示,比如网络异常、城市不存在等情况:
如果返回状态码不是 200,说明出错了检查 JSON 解析是否有误提示用户检查拼写或重试
基本上就这些步骤。开发一个简单的 CLI 天气查询工具不需要太多依赖,但如果你希望它看起来更专业,也可以引入第三方库来美化输出,比如用 github.com/fatih/color 来加颜色,或者用 github.com/spf13/cobra 做成更复杂的 CLI 工具。
不复杂但容易忽略的是细节处理,比如错误判断和格式转换,这些才是真正影响用户体验的地方。
以上就是怎样用Golang开发一个天气查询CLI 调用公开API的完整流程的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1393800.html
微信扫一扫
支付宝扫一扫