要开发golang天气查询应用，核心在于处理http请求与解析api响应。1.选择openweathermap等api时，关注数据覆盖、免费额度和文档质量，并通过注册获取api密钥，避免硬编码敏感信息；2.使用net/http库发送get请求，配合http.client设置超时机制，检查状态码并用defer关闭响应体，确保资源不泄露；3.解析json需定义匹配结构体字段，利用json.unmarshal映射数据，注意大小写、可选字段及类型一致性问题，必要时手动处理复杂类型。
用Golang开发一个天气查询应用，核心就是搞定两件事：一是怎么跟外部的天气API说话（HTTP请求），二是怎么听懂它说的话（数据解析）。说白了，就是把远程服务的数据抓过来，然后按我们想要的方式展示出来。
构建一个Golang天气查询应用，我们得从获取第三方API数据和解析它们入手。这可不是什么高深莫测的事，但要做好，里头有些门道值得琢磨。
package main import ( "encoding/json" "fmt" "io" "net/http" "os" "time" ) // WeatherResponse 结构体定义，用于匹配OpenWeatherMap API的JSON响应 // 这里只取了部分关键字段，实际应用可能需要更多 type WeatherResponse struct { Weather []struct { Description string `json:"description"` Icon string `json:"icon"` } `json:"weather"` Main struct { Temp float64 `json:"temp"` FeelsLike float64 `json:"feels_like"` TempMin float64 `json:"temp_min"` TempMax float64 `json:"temp_max"` Humidity int `json:"humidity"` } `json:"main"` Name string `json:"name"` // 城市名称 Cod int `json:"cod"` // 状态码 } // getWeatherData 从OpenWeatherMap API获取天气数据 func getWeatherData(city string, apiKey string) (*WeatherResponse, error) { // 构建API请求URL // 确保API Key和城市名正确编码，这里简单处理 apiURL := fmt.Sprintf("http://api.openweathermap.org/data/2.5/weather?q=%s&appid=%s&units=metric&lang=zh_cn", city, apiKey) // 创建一个HTTP客户端，设置超时 client := &http.Client{Timeout: 10 * time.Second} // 发送GET请求 resp, err := client.Get(apiURL) if err != nil { return nil, fmt.Errorf("请求天气API失败: %w", err) } // 确保响应体被关闭，避免资源泄露 defer resp.Body.Close() // 检查HTTP状态码 if resp.StatusCode != http.StatusOK { // 尝试读取错误信息，如果API有返回的话 bodyBytes, _ := io.ReadAll(resp.Body) return nil, fmt.Errorf("API请求返回非成功状态码: %d, 响应: %s", resp.StatusCode, string(bodyBytes)) } // 读取响应体 bodyBytes, err := io.ReadAll(resp.Body) if err != nil { return nil, fmt.Errorf("读取API响应失败: %w", err) } // 解析JSON数据到WeatherResponse结构体 var weatherData WeatherResponse err = json.Unmarshal(bodyBytes, &weatherData) if err != nil { return nil, fmt.Errorf("解析JSON数据失败: %w", err) } // 检查API返回的内部状态码，有些API会在JSON中提供业务错误码 if weatherData.Cod != http.StatusOK { // OpenWeatherMap在城市未找到时Cod会是404 return nil, fmt.Errorf("API返回业务错误码: %d, 城市可能不存在", weatherData.Cod) } return &weatherData, nil } func main() { // 从环境变量获取API Key，这是更安全的做法 apiKey := os.Getenv("OPENWEATHER_API_KEY") if apiKey == "" { fmt.Println("错误：请设置环境变量 OPENWEATHER_API_KEY") fmt.Println("示例：export OPENWEATHER_API_KEY=你的API密钥") return } city := "Beijing" // 默认查询城市，也可以从命令行参数获取 // 尝试获取天气数据 weather, err := getWeatherData(city, apiKey) if err != nil { fmt.Printf("获取天气数据时发生错误: %vn", err) return } // 打印天气信息 fmt.Printf("%s当前天气：n", weather.Name) if len(weather.Weather) > 0 { fmt.Printf(" 描述: %sn", weather.Weather[0].Description) } fmt.Printf(" 温度: %.1f°C (体感: %.1f°C)n", weather.Main.Temp, weather.Main.FeelsLike) fmt.Printf(" 湿度: %d%%n", weather.Main.Humidity) fmt.Printf(" 最高温: %.1f°C, 最低温: %.1f°Cn", weather.Main.TempMax, weather.Main.TempMin) }
如何选择合适的第三方天气API并获取API密钥？
选择一个合适的天气API，对我来说，首先看的是它的数据覆盖面和准确性，其次是免费额度是否够用，以及文档是否清晰。市面上可选的不少，比如OpenWeatherMap、AccuWeather、Weatherbit.io等等。我个人比较常用OpenWeatherMap，因为它有比较慷慨的免费层级，而且API接口相对直观。
立即学习“go语言免费学习笔记（深入）”；
获取API密钥的流程大同小异。以OpenWeatherMap为例，你得先去它官网注册一个账号。注册成功后，通常在你的用户Dashboard或者API Keys的页面就能找到你的专属密钥。这个密钥就是你访问他们数据服务的“通行证”。拿到密钥后，切记不要直接硬编码在代码里，那可是安全大忌。更好的做法是把它存在环境变量里，或者通过配置文件加载，这样代码和敏感信息就分开了。
在Golang中如何高效地发送HTTP请求并处理API响应？
在Golang里发送HTTP请求，
net/http
这个标准库简直是神器。它提供了非常简洁的接口来完成这些操作。最直接的就是
http.Get()
，它能帮你快速发起一个GET请求。但如果想更精细地控制，比如设置请求超时时间，那就得用
http.Client
了。我通常会创建一个
http.Client
实例，然后给它配个
Timeout
，这样可以避免网络状况不佳时程序一直卡住。
处理API响应，我觉得最关键的是错误处理。网络请求本身就充满了不确定性。首先，要检查请求本身有没有出错，比如网络不通、域名解析失败之类的。接着，要看HTTP状态码，不是所有的200 OK都代表成功，有时候404、500这些错误码会告诉你服务器出了问题，或者请求的资源不存在。然后才是读取响应体，
io.ReadAll
是个好帮手，它能把响应内容全部读出来。最后，也是最容易被忽视的一点，就是别忘了用
defer resp.Body.Close()
来关闭响应体，这能有效防止资源泄露，尤其是在循环请求的场景下。我有时候会遇到API返回的JSON里，某个字段本来是字符串，结果偶尔来了个数字，这种类型不一致的问题也得考虑。
Golang中解析复杂JSON数据结构的技巧与常见陷阱？
JSON解析在Golang里，
encoding/json
包是主力。它的
json.Unmarshal
方法能把JSON数据直接映射到Go的结构体上，非常方便。关键在于，你的Go结构体字段名要和JSON的键名对应上。如果不一样，就得用
json:"json_key_name"
这样的
tag
来明确映射关系。
处理复杂JSON时，嵌套结构体是家常便饭。比如天气API里，
main
字段下面又有一堆温度、湿度信息，那就在Go里定义一个
main
结构体，然后把这个结构体嵌入到
WeatherResponse
里。如果是JSON数组，比如
weather
字段可能是一个天气描述的数组，那就用
[]struct{}
来表示。
我遇到过一些坑：
- 字段名大小写不匹配：Go习惯驼峰命名，JSON可能用蛇形命名，
tag
这时候就不能省。
- 可选字段：有些JSON字段可能不一定每次都出现，如果你的Go结构体里没有对应的
omitempty
标签，那么当这个字段缺失时，
json.Unmarshal
可能会报错或者赋给零值，这需要根据业务逻辑来判断是接受零值还是视为错误。
- 类型不一致：这是最头疼的，比如API文档说某个字段是字符串，但偶尔会返回数字。这时，简单的
json.Unmarshal
就不够了，你可能需要实现
json.Unmarshaler
接口来自定义解析逻辑，或者先解析到
map[string]interface{}，再手动进行类型断言和转换。当然，对于一个天气应用，通常API的数据结构会比较稳定，所以直接映射到结构体是最高效的。如果实在遇到这种问题，我一般会先打印出原始JSON，看看它到底长啥样，再决定怎么处理。
评论（已关闭）
评论已关闭