用Golang开发天气CLI调用API教程

本文详细介绍了如何使用 Golang 开发一个实用的天气查询命令行工具（CLI），并符合百度SEO优化。文章从选择合适的天气API（如OpenWeatherMap、WeatherAPI或和风天气）并获取API Key开始，逐步讲解了如何利用 `flag` 包处理用户输入的城市参数，以及如何构造HTTP请求并解析返回的JSON数据。核心步骤包括发起GET请求、定义结构体解析响应内容，并展示了关键代码示例。此外，文章还提供了可选的优化建议，如从环境变量读取API Key，增加错误提示，提升用户体验。掌握这些HTTP请求和JSON解析方法，你就能快速构建自己的天气查询CLI工具。

用 Golang 开发天气查询 CLI 工具的核心步骤包括：1. 选择 API 并获取 Key，如 OpenWeatherMap、WeatherAPI 或和风天气；2. 使用 flag 包处理命令行参数，获取用户输入的城市名；3. 发起 HTTP 请求并解析返回的 JSON 数据，构造 URL、发送 GET 请求、定义结构体解析响应内容；4. 可选优化包括从环境变量读取 API Key 和增加错误提示。整个过程依赖基础的 HTTP 请求与 JSON 解析能力，注意细节处理可提升用户体验。

用 Golang 开发一个天气查询的 CLI 工具，其实并不复杂。核心流程就是：获取用户输入、调用公开 API、解析返回数据、输出结果。只要掌握基本的 HTTP 请求和 JSON 解析方法，就能快速上手。

下面我来分几个步骤讲讲整个实现过程。

1. 准备工作：选好 API 和获取 Key

首先，你需要找一个提供天气信息的公开 API。比较常用的有：

• OpenWeatherMap（https://openweathermap.org/api）
• WeatherAPI（https://www.weatherapi.com/）
• 和风天气（适合中文用户）

这些服务通常都提供免费额度，注册账号后可以获取到一个 API Key。

以 OpenWeatherMap 为例，它的当前天气接口地址是：

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

你只需要替换 {city} 和 {YOUR_API_KEY} 就能发起请求了。

2. 编写命令行参数处理逻辑

Golang 中可以使用 os.Args 或者更方便的 flag 包来处理命令行参数。

比如我们想让程序支持这样的用法：

weather --city beijing

就可以这样写：

var city string
flag.StringVar(&city, "city", "", "城市名称")
flag.Parse()

if city == "" {
    fmt.Println("请指定城市名，例如：--city shanghai")
    os.Exit(1)
}

这样就能从命令行拿到用户输入的城市名了。

3. 发起 HTTP 请求并解析响应

这一步是整个程序的核心。我们需要构造请求 URL，发送 GET 请求，并解析返回的 JSON 数据。

示例代码如下：

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 {
    log.Fatalf("请求失败：%v", err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)

// 定义结构体用于解析JSON
type WeatherResponse struct {
    Name string `json:"name"`
    Main struct {
        Temp float64 `json:"temp"`
    } `json:"main"`
}

var wr WeatherResponse
json.Unmarshal(body, &wr)

fmt.Printf("城市：%s\n", wr.Name)
fmt.Printf("温度：%.2f K\n", wr.Main.Temp)

注意：OpenWeatherMap 返回的温度单位是开尔文（K），如果需要摄氏度，可以用 Temp - 273.15 转换。

4. 可选优化：封装配置和错误提示

为了不让 API Key 硬编码在代码里，你可以把它放到环境变量中：

apiKey := os.Getenv("WEATHER_API_KEY")
if apiKey == "" {
    log.Fatal("请设置环境变量 WEATHER_API_KEY")
}

另外，还可以增加一些人性化的提示，比如网络异常、城市不存在等情况：

• 如果返回状态码不是 200，说明出错了
• 检查 JSON 解析是否有误
• 提示用户检查拼写或重试

基本上就这些步骤。开发一个简单的 CLI 天气查询工具不需要太多依赖，但如果你希望它看起来更专业，也可以引入第三方库来美化输出，比如用 github.com/fatih/color 来加颜色，或者用 github.com/spf13/cobra 做成更复杂的 CLI 工具。

不复杂但容易忽略的是细节处理，比如错误判断和格式转换，这些才是真正影响用户体验的地方。

本篇关于《用Golang开发天气CLI调用API教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！