用Golang标准库可开发轻量稳定天气查询工具:注册获取API密钥,定义匹配JSON字段的导出结构体,用net/http发起GET请求并解析响应,通过flag支持命令行参数,友好提示各类错误,格式化输出温度、湿度、天气描述。

用 Golang 开发天气查询工具,核心是调用公开天气 API(如 OpenWeatherMap、和风天气等),发送 HTTP 请求、解析 JSON 响应、结构化输出。整个过程不依赖框架,标准库就能完成,轻量且稳定。
注册 API 并获取密钥
大多数免费天气 API 需要注册账号并申请 API Key。以 OpenWeatherMap 为例:
- 访问 https://openweathermap.org/api,点击 “Sign Up” 注册
- 登录后进入 API Keys 页面,复制生成的 32 位字符串(如
abc123def456...) - 免费版默认支持每分钟 1000 次请求,足够本地开发和小规模使用
定义结构体匹配 JSON 返回
API 返回的是嵌套 JSON,需用 Go 结构体精准映射。例如 OpenWeatherMap 的当前天气接口返回包含 main.temp、weather[0].description 等字段:
type WeatherResponse struct {
Name string `json:"name"`
Main struct {
Temp float64 `json:"temp"`
Humidity int `json:"humidity"`
} `json:"main"`
Weather []struct {
Description string `json:"description"`
} `json:"weather"`
}
注意字段首字母大写(导出)、tag 中的 json: 名称要与 API 字段完全一致(含大小写),否则解析为空。
立即学习“go语言免费学习笔记(深入)”;
发起 HTTP 请求并处理响应
使用 net/http 发起 GET 请求,带上 API Key 和城市参数(支持城市名或经纬度):
- 构造 URL:如
https://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=YOUR_KEY&units=metric - 用
http.Get()获取响应,检查resp.StatusCode是否为 200 - 用
json.NewDecoder(resp.Body).Decode(&data)解析到结构体 - 记得
defer resp.Body.Close()防止连接泄漏
封装命令行交互与错误提示
用 flag 包支持命令行参数,让工具更实用:
- 运行时输入:
./weather -city Shanghai -key abc123 - 对空城市名、网络超时、API 错误码(如 404 城市未找到)分别给出友好提示
- 成功时格式化输出:温度、湿度、天气描述,例如
上海 | 22.5°C | 多云 | 湿度 68%
基本上就这些。不需要第三方库,Go 标准库 + 一次 API 调用 + 合理结构体,就能跑通一个可用的天气查询小工具。关键在理解 API 文档字段、正确解码、以及处理常见异常。










