用Golang做天气查询应用的核心三步是:选OpenWeatherMap等免费API、用net/http发请求并解析JSON、结构化输出;需注意URL编码、坐标查询、结构体tag、状态码与cod字段校验、缓存及错误提示。

用 Golang 做一个天气查询应用不难,核心就三步:选一个稳定免费的天气 API、用 net/http 发请求并解析 JSON、把数据结构化输出(命令行或简单 Web)。下面直接说实用做法,不绕弯。
选一个开箱即用的第三方天气 API
推荐 OpenWeatherMap(https://www.php.cn/link/a5aef5357bc5d38853c0b0d3cca7bf8c),注册免费账号就能拿到 API Key,每分钟 1000 次调用、每天 1000 次,够个人学习和小工具用。它支持按城市名、坐标、ZIP 码查天气,返回 JSON 清晰,文档友好。
示例请求地址(当前天气):
https://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=YOUR_API_KEY&units=metric
立即学习“go语言免费学习笔记(深入)”;
-
注意 units 参数:填
metric返回摄氏度,imperial是华氏度 -
中文城市要 URL 编码,比如 “上海” 要写成
q=%E4%B8%8A%E6%B5%B7,或者直接用英文名q=Shanghai - 如果想查更准,建议用经纬度接口:
/geo/1.0/direct?q={city}先查坐标,再用/weather?lat={}&lon={}
用 Go 写 HTTP 请求 + JSON 解析
不用额外框架,标准库就够了。关键点是定义好结构体,字段名要和 JSON key 对应(注意 tag)。
示例结构体(精简版):
type WeatherResponse struct {
Name string `json:"name"`
Main struct {
Temp float64 `json:"temp"`
FeelsLike float64 `json:"feels_like"`
Humidity int `json:"humidity"`
} `json:"main"`
Weather []struct {
Main string `json:"main"`
Description string `json:"description"`
} `json:"weather"`
}
- 用
http.Get()发请求,记得检查err和resp.StatusCode - 用
json.NewDecoder(resp.Body).Decode(&data)解析,别用json.Unmarshal读全部字节——对大响应不友好 - API 返回错误时(比如城市不存在),OpenWeatherMap 仍返回 200,但带
{"cod": "404", "message": "city not found"},需手动判断cod字段
结构化输出:命令行友好格式
终端里看天气,别堆 JSON。按逻辑分块打印,加点颜色(可选)提升可读性:
- 第一行:城市名 + 当前时间(用
time.Now().Format("Jan 2 15:04")) - 第二行:温度 + “体感” + 天气描述(如 “晴,少云”)
- 第三行:湿度 + 风速(如果 API 返回 wind.speed)
- 用
\t或固定宽度对齐,避免换行错乱
进阶可加 flag 支持:weather -city Beijing -unit imperial,用 flag.String 解析参数。
可选增强:缓存与错误处理
天气变化慢,本地缓存 10 分钟很合理。用 sync.Map 存 map[string]WeatherResponse,key 是 city+unit,value 带时间戳。每次查先判缓存是否过期。
错误处理重点不是“优雅”,而是“有用”:
- 网络失败 → 提示 “网络不通,请检查代理或重试”
- API 返回非 200 → 打印 OpenWeatherMap 的
message字段 - JSON 解析失败 → 检查结构体 tag 是否写错,或打印原始响应前 200 字符辅助调试
基本上就这些。不复杂但容易忽略细节,跑通一次,后面加功能(比如 5 天预报、CLI 自动补全、Web 页面)就顺了。










