Golang开发天气查询工具API与JSON解析教程

本文深入讲解了使用 Golang 开发命令行天气查询工具的关键实践与常见陷阱，聚焦于如何安全、健壮地调用天气 API：必须显式设置 HTTP 客户端超时避免“假死”，严格对城市名进行 URL 编码以支持中文和空格，正确构造带 appid 的请求 URL 防止 401/400 错误；同时详解 JSON 解析的典型坑点——导出字段命名、结构体标签映射、可选字段处理及动态响应应对策略；还涵盖命令行参数优雅解析（flag 包最佳用法）、本地调试技巧（禁用缓存、Mock 响应）、API Key 安全管理（环境变量）以及时区转换等实战细节，直击新手最易卡住的两大痛点——超时缺失与编码遗漏，助你快速构建稳定可靠的 Go 天气工具。

怎么用 net/http 发起天气 API 请求不卡死

Go 默认的 http.Client 没设超时，遇到网络抖动或服务无响应，Get 会一直挂起，命令行工具就“假死”。必须手动加超时控制。

• 用 &http.Client{Timeout: 10 * time.Second} 显式设置超时，别依赖默认值
• 天气 API（比如 OpenWeatherMap）要求带 appid 查询参数，漏了会返回 401 错误：{"cod":"401","message":"Invalid API key"}
• 请求 URL 中城市名要 url.QueryEscape 处理空格和中文，否则 400；例如北京得传 "Beijing" 或 %E5%8C%97%E4%BA%AC，不能直接拼 "北京"
• 别用 http.Get 简写——它用的是全局默认 client，没法单独控超时或复用连接

解析天气 JSON 时 struct 字段为什么总为空

Go 的 json.Unmarshal 对字段可见性很敏感：只有首字母大写的导出字段才能被赋值。另外，API 返回的嵌套结构、字段名大小写、可选字段都容易踩坑。

• 检查 struct 字段是否以大写字母开头，比如 Temp ✅，temp ❌
• 用 json:"temp" 标签对齐 API 字段名，OpenWeatherMap 的温度在 main.temp，对应 struct 要写成 Main struct { Temp float64 `json:"temp"` }
• 如果某些字段可能不存在（如 rain.1h 在没雨时压根不返回），字段类型别硬写 float64，改用 *float64 或 struct{ OneH *float64 `json:"1h,omitempty"` }
• 用 json.RawMessage 延迟解析不确定结构（比如不同天气服务返回的风向字段名不统一），避免一解就 panic

如何让命令行支持 -city 和 -unit 参数又不写一堆 flag 判断

手写 if os.Args[1] == "-city" 容易错位、难维护。flag 包是标准解法，但要注意默认值和类型转换的隐含行为。

• 用 flag.String("city", "", "城市名，必填")，然后必须调 flag.Parse()，否则 flag.Arg(0) 这类老方式会漏参数
• -unit 推荐限定为 metric / imperial，别接受自由字符串——API 只认这两个值，多一个就 400
• 必填参数（如 -city）要在 flag.Parse() 后立刻检查：if *city == "" { log.Fatal("缺少 -city 参数") }，别等 HTTP 请求发出去才报错
• 别把 flag 变量声明在函数里再传参，直接定义为包级变量更清晰，也方便测试 mock

本地调试时反复请求 API 被限流或返回缓存结果怎么办

OpenWeatherMap 免费版每分钟最多 1000 次，但更常见的是你改了代码重跑，API 却返回旧数据——其实是 DNS 或 HTTP 层缓存，不是 API 问题。

• 加请求头禁用缓存：req.Header.Set("Cache-Control", "no-cache")
• 开发时把 API 响应先写到本地文件，比如 curl -s "https://api.openweathermap.org/..." > mock.json，然后用 os.ReadFile("mock.json") 替代真实请求，省时间也防限流
• 环境变量管理 API key：os.Getenv("WEATHER_API_KEY")，别硬编码；本地跑前执行 export WEATHER_API_KEY=xxx
• 注意时区：API 返回的 dt 是 Unix 时间戳（UTC），用 time.Unix(dt, 0).Local() 转成本地时间，否则显示的“当前时间”可能差 8 小时

实际跑起来最常卡住的地方不是 JSON 解析，而是没设 HTTP 超时 + 忘了 URL 编码城市名——这两条一错，命令行就停在那儿不动，连错误都看不到。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~