登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Golang实战：开发天气查询程序教程

时间：2026-05-01 13:05:00 322浏览 收藏

本文手把手教你用 Golang 开发一个简洁实用的天气查询程序：从注册 OpenWeatherMap 获取免费 API 密钥，到构建精准匹配 JSON 响应的结构体，再到使用 net/http 发起请求、encoding/json 安全解析数据，最后在终端清晰输出城市名、国家、实时温度与湿度——整个过程无需第三方依赖，代码直观易懂，充分展现 Go 语言处理 HTTP 和 JSON 的天然优势，是入门实战与 API 集成的绝佳范例。

如何用 Golang 编写一个天气查询程序_Golang API 调用与 JSON 解析实战

想用 Golang 写一个天气查询程序？其实不难。核心是调用公开的天气 API，获取 JSON 数据，然后解析并展示结果。下面一步步带你实现，从 API 调用到结构体定义，再到 JSON 解析，实战走起。

选择天气 API 并获取密钥

我们以 OpenWeatherMap 为例，它提供免费的天气数据接口。你需要先注册账号，获取一个 API Key。

关键接口地址：
https://api.openweathermap.org/data/2.5/weather?q=城市名&appid=你的密钥&units=metric
其中 units=metric 表示温度单位为摄氏度。

定义结构体来映射 JSON 响应

Golang 解析 JSON 的关键是定义与返回数据结构匹配的 struct。API 返回的数据较复杂，我们只提取关心的部分：

type Weather struct {
    Main struct {
        Temp     float64 `json:"temp"`
        Humidity int     `json:"humidity"`
    } `json:"main"`
    Name string `json:"name"`
    Sys  struct {
        Country string `json:"country"`
    } `json:"sys"`
}

字段标签 json:"xxx" 告诉解析器 JSON 中的键名。比如 Temp 对应的是 main.temp。

发送 HTTP 请求并解析响应

使用标准库 net/http 发起 GET 请求，再用 encoding/json 解码：

func getWeather(city, apiKey string) (*Weather, error) {
    url := fmt.Sprintf("https://api.openweathermap.org/data/2.5/weather?q=%s&appid=%s&units=metric", city, apiKey)
    
    resp, err := http.Get(url)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()

    if resp.StatusCode != 200 {
        return nil, fmt.Errorf("天气服务错误: %s", resp.Status)
    }

    var weather Weather
    err = json.NewDecoder(resp.Body).Decode(&weather)
    if err != nil {
        return nil, err
    }

    return &weather, nil
}

注意检查 HTTP 状态码，避免服务端出错时继续解析。

主函数调用并输出结果

在 main 中调用函数，打印天气信息：

func main() {
    apiKey := "your_api_key_here"
    city := "Beijing"

    weather, err := getWeather(city, apiKey)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("城市: %s, 国家: %s\n", weather.Name, weather.Sys.Country)
    fmt.Printf("温度: %.1f°C\n", weather.Main.Temp)
    fmt.Printf("湿度: %d%%\n", weather.Main.Humidity)
}

运行后你会看到类似：

城市: Beijing, 国家: CN
温度: 22.3°C
湿度: 65%

基本上就这些。Golang 处理 API 和 JSON 非常直接，只要结构体对得上，解析几乎零负担。你可以扩展支持多个城市、命令行输入，或者加上缓存机制。实战中多看 API 文档，结构体就能写准。

好了，本文到此结束，带大家了解了《Golang实战：开发天气查询程序教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！

golang 天气查询
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>