如何使用Golang开发天气查询工具_Golang API数据获取项目讲解

用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 字段完全一致（含大小写），否则解析为空。

发起 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 文档字段、正确解码、以及处理常见异常。