怎样用Golang开发一个天气查询CLI 调用公开API的完整流程

用 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。比较常用的有：

立即学习“go语言免费学习笔记（深入）”；

• OpenWeatherMap（https://www.php.cn/link/a5aef5357bc5d38853c0b0d3cca7bf8c）
• WeatherAPI（https://www.php.cn/link/875ffa7f896a4da039e296e2d1f54937）
• 和风天气（适合中文用户）

这些服务通常都提供免费额度，注册账号后可以获取到一个 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 包来处理命令行参数。

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

AliGenie 天猫精灵开放平台

天猫精灵开放平台

42

查看详情

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的完整流程的详细内容，更多请关注php中文网其它相关文章！