用 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 string
flag.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)
// 定义结构体用于解析JSON
type WeatherResponse struct {
Name string `json:"name"`
Main struct {
Temp float64 `json:"temp"`
} `json:"main"`
}
var wr WeatherResponse
json.Unmarshal(body, &wr)
fmt.Printf("城市：%s\n", wr.Name)
fmt.Printf("温度：%.2f K\n", 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 工具。
不复杂但容易忽略的是细节处理，比如错误判断和格式转换，这些才是真正影响用户体验的地方。
