Golang开发天气查询命令行工具

本文深入讲解了如何用 Go 语言开发一个健壮、实用的命令行天气查询工具，聚焦 net/http 实战中的五大关键细节：安全构造带中文参数的 GET 请求（避免手拼 URL）、从环境变量加载 API 密钥保障安全性、精准使用 JSON tag 解析嵌套且字段名不规范的响应结构、轻量高效地用 flag 而非过度设计的框架处理命令行参数，以及为 HTTP 客户端配置超时与连接级超时以防止假死；同时强调对可选字段、单位转换、坐标精度等易踩坑点的提前应对，让开发者避开常见陷阱，写出真正可靠、可维护的 CLI 工具。

怎么用 net/http 发起带 query 参数的 GET 请求

天气 API 大多靠 URL 查询参数传城市名或经纬度，比如 https://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=xxx。别手拼 URL 字符串——容易漏转义、丢 & 或 =。net/url 的 url.Values 是标准解法。

• 先用 url.Parse 解析基础地址，再用 url.Values.Set 填参数，最后用 u.RawQuery = params.Encode() 组装
• 中文城市名（如 “上海”）必须走 url.QueryEscape，否则服务端收不到或返回 400
• 别把 appid 拼在 URL 里硬编码，读环境变量更安全：os.Getenv("WEATHER_API_KEY")

解析 JSON 响应时 struct 字段 tag 写不对就全为零值

OpenWeatherMap 返回的 JSON 字段名是 main、wind 这类小写加下划线的，Go struct 默认只匹配首字母大写的导出字段，且忽略下划线。不写 json: tag，json.Unmarshal 就不会把数据塞进去，所有字段都是零值。

• Temp 字段得写成 Temp float64 `json:"temp"`，不是 "Temp" 或 "temperature"
• 嵌套对象如 main 对应的 struct 要单独定义，tag 里写 main，不能省略或改成 Main
• 可选字段（比如某些城市没 rain）用指针类型 + omitempty： Rain *struct{ OneHour float64 } `json:"rain,omitempty"`

命令行参数解析用 flag 就够了，别上 cobra

这个工具只需要一个 -city 或 -lat/-lon，没子命令、没交互、不生成 help 文档——cobra 是过度设计，还引入隐式全局状态和额外编译体积。

• 用 flag.StringVar(&city, "city", "", "城市名，如 shanghai")，然后 flag.Parse()
• 检查是否至少传了一个参数：if city == "" && (lat == 0 || lon == 0)，直接 log.Fatal("需指定 -city 或 -lat/-lon")
• 别忘了调 flag.Usage = func(){...} 自定义提示，否则默认输出一堆 -v -h 等无关项

HTTP 超时没设，请求卡住就整个程序挂住

默认 http.DefaultClient 没超时，遇到网络抖动或 API 无响应，client.Do() 会一直等下去，命令行工具就“假死”。这不是 bug，是没配。

• 必须显式创建 http.Client 并设 Timeout：&http.Client{Timeout: 10 * time.Second}
• 别只设 Timeout，还要考虑 DNS 解析慢：用 http.Transport 配 .DialContext 和 ResponseHeaderTimeout
• 错误处理别只看 err != nil，要区分 url.Error 中的 Timeout() 结果，方便提示用户“请求超时，请重试”

天气 API 的响应结构松散、字段可选、单位不统一（开尔文 vs 摄氏）、坐标精度要求高——这些细节不提前对齐，跑通第一版后很快就会在解析温度或定位上海时掉坑里。

理论要掌握，实操不能落！以上关于《Golang开发天气查询命令行工具》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！