Golang开发天气查询工具教程详解

本教程将带你使用 Golang 从零开始打造一个实用的天气查询工具。首先，你需要准备一个可用的天气 API，例如 OpenWeatherMap，并获取 API Key。接着，我们将利用 Golang 的 `net/http` 库发起 HTTP 请求，调用该 API 并处理返回的 JSON 数据。通过定义结构体，解析 JSON 数据并进行温度单位转换，让数据更易读。最后，我们将使用 `flag` 包，实现通过命令行参数输入城市和 API 密钥，让你的天气查询工具更加灵活。文章将详细讲解每个步骤，并提醒你注意错误处理、参数验证以及数据格式转换等关键细节，助你轻松掌握 Golang 天气查询工具的开发。

用Golang开发天气查询工具的步骤如下：1.准备可用的天气API如OpenWeatherMap并获取API Key；2.使用net/http库发起HTTP请求调用API并处理响应；3.定义结构体解析JSON数据并转换温度单位；4.通过flag包支持命令行参数输入城市和密钥。整个过程需注意错误处理、参数验证及数据格式转换等细节。

用Golang开发一个天气查询工具其实并不难，尤其是当你打算调用现成的第三方API时。核心思路是：获取用户输入的城市名 → 调用天气API获取数据 → 解析返回结果并展示给用户。

下面我来一步步讲讲怎么实现这个过程，以及需要注意的地方。

1. 准备一个可用的天气API

首先你需要找一个提供天气信息的第三方接口。常见的有：

• OpenWeatherMap
• HeFeng Weather
• 和风天气（中文文档友好）

以 OpenWeatherMap 为例，注册账号后可以获取一个免费的 API Key，然后就可以使用类似如下的接口地址：

http://api.openweathermap.org/data/2.5/weather?q={city}&appid={your_api_key}

你可以先在浏览器或者 Postman 中测试一下这个接口是否能正常返回数据。

2. 使用Go语言发起HTTP请求

接下来就是用 Go 发起 HTTP 请求去调用这个 API。标准库 net/http 就足够完成任务。

大致流程如下：

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func getWeather(city string, apiKey string) {
    url := fmt.Sprintf("http://api.openweathermap.org/data/2.5/weather?q=%s&appid=%s", city, apiKey)

    resp, err := http.Get(url)
    if err != nil {
        fmt.Println("请求失败:", err)
        return
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

这里只是简单演示了如何发送请求和读取响应体。实际开发中你可能还需要处理状态码、超时等问题。

3. 解析JSON响应数据

API 返回的数据通常是 JSON 格式，你需要定义结构体来解析它。例如：

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"`
}

然后把上面的 body 解析进去：

var data WeatherResponse
err = json.Unmarshal(body, &data)
if err != nil {
    fmt.Println("解析失败:", err)
    return
}

fmt.Printf("城市: %s\n", data.Name)
fmt.Printf("温度: %.2f°C\n", data.Main.Temp-273.15)
fmt.Printf("湿度: %d%%\n", data.Main.Humidity)
fmt.Printf("天气描述: %s\n", data.Weather[0].Description)

注意：OpenWeatherMap 的温度单位是 Kelvin，需要减去 273.15 才能得到摄氏度。

4. 加入用户输入和命令行参数

为了让程序更实用，你可以让用户输入城市名而不是写死在代码里。可以用 os.Args 或者用 flag 包来支持命令行参数。

示例：

city := flag.String("city", "Beijing", "请输入城市名称")
apiKey := flag.String("key", "", "请输入你的API密钥")
flag.Parse()

if *apiKey == "" {
    fmt.Println("请提供API密钥")
    return
}

getWeather(*city, *apiKey)

这样运行的时候就可以指定城市和密钥了：

go run main.go -city=Shanghai -key=your_api_key_here

写在最后

整个流程其实不复杂：选个合适的 API → 发起请求 → 解析数据 → 展示结果。但有些细节容易被忽略，比如错误处理、超时控制、城市名拼写是否正确等。

如果你希望做得更完善，还可以加上缓存、并发查询、CLI 美化等功能。

基本上就这些，照着做一遍应该就能写出一个属于自己的天气小工具了。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang开发天气查询工具教程详解》文章吧，也可关注golang学习网公众号了解相关技术文章。