首页/资讯中心/详情

C++实战：从零构建网络天气查询工具，贯通面向对象与JSON解析

C++实战：从零构建网络天气查询工具，贯通面向对象与JSON解析
📅 发布时间：2026/7/23 6:14:44

1. 项目概述：从零构建一个实用的C++天气查询工具

最近在整理自己的项目库，翻到了一个几年前写的在线天气查询系统，感觉挺有代表性的。它不是什么复杂的分布式架构，但麻雀虽小五脏俱全，完整地走了一遍从需求分析、技术选型、编码实现到问题排查的全过程。对于想用C++练手、巩固面向对象设计、或者学习网络编程和JSON解析的朋友来说，这个项目是个不错的切入点。它解决的问题很直接：用户输入一个城市名，程序就能从互联网上的天气API获取并展示当前的天气信息，比如温度、湿度、天气状况和未来几天的预报。

这个项目的价值在于“贯通”。很多C++初学者学了一堆语法和STL，但不知道如何把它们组合起来解决一个实际的小问题。这个项目恰好能把字符串处理、网络请求、第三方库集成、数据解析和格式化输出这些知识点串联起来。你会看到如何用C++11/14的现代特性写出更安全的代码，如何处理网络I/O这种异步操作，以及如何设计一个结构清晰、易于扩展的小型应用。无论你是正在准备课程设计的学生，还是想通过一个完整项目来复习C++的开发者，跟着这个思路走一遍，收获会比单纯看教程大得多。

2. 核心需求与整体设计思路

2.1 需求拆解：这个系统到底要做什么？

首先，我们得把“在线天气查询系统”这个模糊的需求具体化。经过分析，核心功能可以分解为以下几点：

  1. 用户交互：提供一个简单的界面，让用户能够输入要查询的城市名称。这个界面可以是控制台命令行，也可以是简单的图形界面（比如用Qt），为了降低复杂度，我们首选控制台。
  2. 网络通信：程序需要能够访问外部的天气数据服务。这意味着我们必须实现HTTP/HTTPS客户端的功能，向指定的API地址发起GET请求，并接收返回的数据。
  3. 数据解析：目前绝大多数开放的天气API（如和风天气、OpenWeatherMap等）返回的数据格式都是JSON。因此，我们的程序需要具备解析JSON数据的能力，从中提取出我们关心的字段，如temp（温度）、humidity（湿度）、text（天气描述）等。
  4. 数据展示：将解析后的天气信息，以清晰、友好的格式输出给用户。例如，不仅仅是打印数字，还可以加上单位（℃、%），并用中文描述天气状况。
  5. 错误处理：网络请求可能失败（城市不存在、网络超时、API密钥无效等），JSON数据可能格式错误。一个健壮的系统必须能妥善处理这些异常情况，并给出明确的错误提示，而不是直接崩溃。

2.2 技术选型与架构设计

基于以上需求，我们来做技术选型。核心决策点在于网络库和JSON库，因为C++标准库没有直接提供这两样东西。

  • 网络库：实现HTTP客户端。可选方案有：

    • cURL：这是行业标杆，功能极其强大且稳定。它的C API很经典，但在C++项目中直接使用C风格的curl_easy系列函数，在资源管理和异常安全上需要多费心思。
    • libcurl的C++封装，或者像cpp-httplib这样的轻量级纯C++库。cpp-httplib只有一个头文件，集成简单，API对C++开发者更友好，适合我们这个轻量级项目。
    • Boost.Beast：功能强大，是学习Asio和网络编程的绝佳材料，但复杂度较高，有点杀鸡用牛刀。我的选择：为了聚焦于C++项目本身的逻辑，我们选用cpp-httplib。它足够简单，能让我们快速发起HTTP请求，把更多精力放在业务逻辑和C++特性应用上。

  • JSON库：解析和生成JSON数据。可选方案有：

    • nlohmann/json：目前C++社区最流行、评价最高的JSON库。API设计非常直观，支持现代C++语法，几乎可以像脚本语言一样操作JSON。
    • RapidJSON：性能极高，但API相对底层一些，需要自己管理内存（分配器）。
    • JsonCpp：比较老牌，但API不如nlohmann/json优雅。我的选择：毫无疑问，选择nlohmann/json。它的易用性可以极大提升开发效率，让代码更简洁易懂。

  • 整体架构：我们采用一个简单的分层设计思想。

    1. 表示层 (Presentation Layer)：负责与用户交互，接收输入，格式化输出。对应我们的main函数和控制台I/O。
    2. 业务逻辑层 (Business Logic Layer)：核心的WeatherFetcher或WeatherService类。它协调网络请求和数据解析，是项目的“大脑”。
    3. 数据访问层 (Data Access Layer)：封装对网络API的调用细节。可以有一个WeatherAPI类，专门负责构造请求URL、发送HTTP请求、接收原始响应。
    4. 工具层 (Utility Layer)：包含JSON解析器、配置读取器等共用组件。

    这样的设计虽然不是企业级，但做到了关注点分离。未来如果想换图形界面，只需修改表示层；想换天气API提供商，只需修改数据访问层。

2.3 开发环境准备

工欲善其事，必先利其器。你需要准备好以下环境：

  1. 编译器：支持C++11及以上标准的编译器。GCC (MinGW-w64)或Clang在Windows/macOS/Linux上均可，MSVC (Visual Studio)在Windows上。确保编译器已加入系统PATH。
  2. 构建工具：强烈推荐使用CMake。它是跨平台构建的事实标准，可以方便地管理依赖库。在你的项目根目录创建一个CMakeLists.txt文件。
  3. 依赖库集成：
    • 对于nlohmann/json，最简单的方式是使用CMake的FetchContent模块，直接从GitHub拉取。或者下载单头文件json.hpp放到你的项目include目录。
    • 对于cpp-httplib，它本身就是单头文件库，直接下载httplib.h放到项目include目录即可。
  4. 代码编辑器/IDE：VS Code或CLion是很好的选择。VS Code需要配置CMake Tools和C/C++插件。CLion对CMake原生支持极佳。如果用Visual Studio，确保安装了“使用C++的桌面开发”工作负载。

注意：在Windows上使用cpp-httplib并开启HTTPS支持（访问天气API基本都是HTTPS），需要额外链接OpenSSL库。这是新手常踩的坑。在CMake中需要找到OpenSSL开发包并链接。如果觉得麻烦，初期可以先用免费的、支持HTTP的API做测试，但务必知道生产环境必须用HTTPS。

3. 核心模块实现与代码解析

接下来，我们深入到代码层面，看看各个模块如何实现。我会先给出关键代码片段，然后解释其背后的设计和考量。

3.1 数据模型定义：用结构体封装天气信息

首先，我们需要定义程序内部表示天气数据的方式。这里使用struct来定义，清晰明了。

// weather_data.h #ifndef WEATHER_DATA_H #define WEATHER_DATA_H #include <string> #include <vector> // 当前天气状况 struct CurrentWeather { std::string cityName; std::string updateTime; // 数据更新时间 double temperature; // 温度，摄氏度 int humidity; // 湿度，百分比 std::string condition; // 天气状况，如“晴”、“多云” double windSpeed; // 风速 std::string windDirection; // 风向 // 可以继续添加气压、能见度等字段 void print() const; // 一个用于打印的成员函数 }; // 未来几天的天气预报（简化版） struct Forecast { std::string date; double tempDay; double tempNight; std::string conditionDay; // ... 其他字段 }; #endif // WEATHER_DATA_H

在对应的.cpp文件中实现print方法，用于格式化输出。

// weather_data.cpp #include “weather_data.h” #include <iostream> #include <iomanip> void CurrentWeather::print() const { std::cout << “=== 当前天气 ===” << std::endl; std::cout << “城市: “ << cityName << std::endl; std::cout << “更新: “ << updateTime << std::endl; std::cout << “温度: “ << std::fixed << std::setprecision(1) << temperature << ” °C” << std::endl; std::cout << “湿度: “ << humidity << “%” << std::endl; std::cout << “天气: “ << condition << std::endl; std::cout << “风力: “ << windSpeed << “级 “ << windDirection << std::endl; std::cout << “================” << std::endl; }

设计思考：为什么用struct而不是一堆独立的变量？封装成结构体有利于数据作为一个整体传递和管理，提高了代码的可读性和可维护性。print成员函数将数据与显示逻辑弱关联，符合面向对象思想。这里没有使用复杂的class和继承，是因为当前模型足够简单，struct的公有成员访问更直接。const成员函数保证了打印不会修改对象状态。

3.2 网络请求模块：封装HTTP客户端

我们创建一个WeatherAPI类，专门负责与远程服务器通信。这里隐藏了cpp-httplib的细节。

// weather_api.h #ifndef WEATHER_API_H #define WEATHER_API_H #include <string> #include “weather_data.h” class WeatherAPI { public: WeatherAPI(const std::string& apiKey, const std::string& baseUrl = “https://devapi.qweather.com”); ~WeatherAPI() = default; // 获取当前天气 bool fetchCurrentWeather(const std::string& cityName, CurrentWeather& result); // 获取天气预报（可选实现） // bool fetchForecast(const std::string& cityName, std::vector<Forecast>& result); private: std::string apiKey_; std::string baseUrl_; // 内部方法：构建请求URL std::string buildCurrentWeatherUrl(const std::string& cityName) const; // 内部方法：执行HTTP GET请求 std::string performHttpGetRequest(const std::string& url) const; }; #endif // WEATHER_API_H

实现部分（weather_api.cpp）是重点，包含了网络请求和初步的错误处理。

#include “weather_api.h” #include “httplib.h” // 单头文件库 #include “nlohmann/json.hpp” #include <iostream> #include <sstream> using json = nlohmann::json; WeatherAPI::WeatherAPI(const std::string& apiKey, const std::string& baseUrl) : apiKey_(apiKey), baseUrl_(baseUrl) { // 可以在这里初始化一些网络参数，比如超时设置（通过cpp-httplib的Client配置） } std::string WeatherAPI::buildCurrentWeatherUrl(const std::string& cityName) const { std::ostringstream oss; // 示例使用和风天气API的格式，你需要替换成自己的API Key和实际接口路径 oss << baseUrl_ << “/v7/weather/now?location=” << cityName << “&key=” << apiKey_; return oss.str(); } std::string WeatherAPI::performHttpGetRequest(const std::string& url) const { // 解析主机和路径 std::string host, path; // 这里需要写一个简单的URL解析逻辑，或者直接使用cpp-httplib的URL构造功能 // 为了示例清晰，我们简化处理，假设baseUrl是”https://devapi.qweather.com” // 实际项目中应使用更鲁棒的URL解析方法 httplib::Client cli(“devapi.qweather.com”); // 注意：这里需要从url中提取host // 启用SSL（HTTPS） // cli.enable_server_certificate_verification(false); // 仅用于测试，生产环境应验证证书 auto res = cli.Get(path.c_str()); // path需要从url中提取 if (res && res->status == 200) { return res->body; } else { std::cerr << “HTTP请求失败！状态码: “; if (res) { std::cerr << res->status; } else { std::cerr << “未知 (可能网络错误)”; } std::cerr << std::endl; return “”; // 返回空字符串表示失败 } } bool WeatherAPI::fetchCurrentWeather(const std::string& cityName, CurrentWeather& result) { std::string url = buildCurrentWeatherUrl(cityName); std::string responseBody = performHttpGetRequest(url); if (responseBody.empty()) { return false; } // 接下来进入JSON解析环节 }

关键点与避坑指南：

  1. URL拼接：使用std::ostringstream来构建URL比直接字符串相加更安全、高效，特别是参数需要URL编码时（本例未展示，实际必须编码！例如城市名“New York”需要编码为“New%20York”）。这是一个常见的疏忽点。
  2. 错误处理：performHttpGetRequest函数必须检查响应指针res是否有效（网络层可能失败）以及HTTP状态码。200表示成功，404表示城市未找到，401表示API密钥无效等。把这些信息反馈给上层调用者至关重要。
  3. 资源管理：httplib::Client对象在函数栈上创建，析构时会自动清理连接。这是RAII（资源获取即初始化）思想的体现，避免了手动管理资源可能带来的内存或连接泄漏。
  4. HTTPS与证书：线上API一定要用HTTPS。在开发环境，如果遇到证书验证问题，可能会临时禁用验证（如上面注释掉的代码），但切记这仅用于临时测试，正式版本绝对不能禁用证书验证，否则会面临中间人攻击风险。

3.3 JSON解析与数据映射：将API响应转换为业务对象

这是业务逻辑的核心。我们接着实现fetchCurrentWeather中的解析部分。

bool WeatherAPI::fetchCurrentWeather(const std::string& cityName, CurrentWeather& result) { std::string url = buildCurrentWeatherUrl(cityName); std::string responseBody = performHttpGetRequest(url); if (responseBody.empty()) { return false; } try { json j = json::parse(responseBody); // 1. 首先检查API返回的通用状态码 std::string code = j.at(“code”).get<std::string>(); // 假设和风API返回”code”字段 if (code != “200”) { std::cerr << “API返回错误: “ << j.at(“message”).get<std::string>() << std::endl; return false; } // 2. 导航到具体的天气数据节点 json now = j.at(“now”); // 3. 提取字段并填充到result对象 result.cityName = cityName; // 或者从API返回的”location”字段获取 result.updateTime = j.at(“updateTime”).get<std::string>(); result.temperature = std::stod(now.at(“temp”).get<std::string>()); // 注意：有些API温度是字符串类型 result.humidity = std::stoi(now.at(“humidity”).get<std::string>()); result.condition = now.at(“text”).get<std::string>(); result.windSpeed = std::stod(now.at(“windSpeed”).get<std::string>()); result.windDirection = now.at(“windDir”).get<std::string>(); return true; } catch (const json::exception& e) { // nlohmann/json 在解析或访问不存在的键时会抛出异常 std::cerr << “JSON解析错误: “ << e.what() << std::endl; std::cerr << “原始响应: “ << responseBody << std::endl; return false; } catch (const std::exception& e) { // 处理stod, stoi可能抛出的异常 std::cerr << “数据转换错误: “ << e.what() << std::endl; return false; } }

经验之谈：

  1. 防御性编程：使用j.at(“key”)而不是j[“key”]。at()方法在键不存在时会抛出json::out_of_range异常，这能让我们立刻发现问题所在。而operator[]对于不存在的键会静默地创建一个null值，这可能导致后续逻辑出现难以调试的错误。
  2. 类型安全：API返回的数字有时是字符串类型（如”25″）。nlohmann/json的.get<std::string>()可以安全获取字符串，然后再用std::stod/std::stoi转换。直接.get<double>()如果遇到字符串会抛出异常。务必查看你所用的API文档，明确每个字段的数据类型。
  3. 异常处理：整个解析过程用try-catch块包裹。网络数据是不可信的，任何解析失败都应该被捕获并转换为友好的错误信息，让程序优雅地降级，而不是崩溃。
  4. 日志输出：在catch块中打印原始响应responseBody非常有用。当API格式发生变化或者返回意外数据时，这是第一手的调试资料。

3.4 业务逻辑层与服务类整合

现在我们把数据获取和解析组合起来，形成一个简单的服务类WeatherService，它对外提供干净的接口。

// weather_service.h #ifndef WEATHER_SERVICE_H #define WEATHER_SERVICE_H #include <memory> #include “weather_data.h” class WeatherAPI; // 前向声明 class WeatherService { public: WeatherService(const std::string& apiKey); ~WeatherService(); // 查询并打印某个城市的天气 bool queryAndPrintCurrentWeather(const std::string& cityName); private: std::unique_ptr<WeatherAPI> api_; // 使用智能指针管理资源 }; #endif // WEATHER_SERVICE_H
// weather_service.cpp #include “weather_service.h” #include “weather_api.h” #include <iostream> WeatherService::WeatherService(const std::string& apiKey) { api_ = std::make_unique<WeatherAPI>(apiKey); } WeatherService::~WeatherService() = default; // unique_ptr会自动释放 bool WeatherService::queryAndPrintCurrentWeather(const std::string& cityName) { CurrentWeather weather; bool success = api_->fetchCurrentWeather(cityName, weather); if (success) { weather.print(); return true; } else { std::cout << “无法获取 [” << cityName << “] 的天气信息，请检查城市名或网络连接。” << std::endl; return false; } }

设计模式浅析：这里使用了依赖注入的雏形和Pimpl（Pointer to Implementation）惯用法。WeatherService不直接依赖WeatherAPI的具体实现，而是通过指针持有。这带来了两个好处：一是降低了编译依赖，修改WeatherAPI的实现不需要重新编译所有包含weather_service.h的文件；二是为未来更换网络库（比如换成cURL）提供了便利，只需修改WeatherService的构造和WeatherAPI的具体实现即可，业务逻辑层WeatherService的接口和核心逻辑不用变。

3.5 主函数与用户交互

最后，我们用main函数把所有模块串联起来，形成一个完整的程序。

// main.cpp #include “weather_service.h” #include <iostream> #include <string> int main() { // 你的和风天气API Key，务必从环境变量或配置文件中读取，不要硬编码！ const std::string apiKey = “YOUR_API_KEY_HERE”; // 警告：此处仅为示例，实际项目务必避免硬编码密钥！ WeatherService weatherService(apiKey); std::string city; std::cout << “请输入要查询的城市名称 (英文或拼音，输入’quit’退出): “ << std::endl; while (std::getline(std::cin, city)) { if (city == “quit” || city == “exit”) { std::cout << “再见！” << std::endl; break; } if (!city.empty()) { weatherService.queryAndPrintCurrentWeather(city); } std::cout << “\n请输入下一个城市名称 (输入’quit’退出): “ << std::endl; } return 0; }

安全警告：在代码中硬编码API Key是极其危险的做法，尤其是如果你打算将代码上传到GitHub等公开仓库。密钥会直接暴露，导致被他人盗用，产生费用甚至恶意请求。正确的做法是：

  1. 从环境变量中读取：std::getenv(“QWEATHER_API_KEY”)。
  2. 从外部配置文件（如config.json）中读取，并将该文件加入.gitignore。
  3. 对于客户端应用，更安全的做法是使用后端服务器做代理，由后端持有密钥，前端请求后端，后端再请求天气API。我们这个控制台程序作为学习项目，可以采用前两种方法。

4. 项目构建与跨平台考量

4.1 使用CMake组织项目

一个清晰的CMakeLists.txt能让你的项目结构更专业，也便于他人编译。

cmake_minimum_required(VERSION 3.15) project(WeatherQuerySystem VERSION 1.0 LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 设置可执行文件输出目录 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin) # 包含第三方库 # 方式1: FetchContent (推荐用于 nlohmann/json) include(FetchContent) FetchContent_Declare( json GIT_REPOSITORY https://github.com/nlohmann/json.git GIT_TAG v3.11.2 ) FetchContent_MakeAvailable(json) # cpp-httplib 是单头文件库，我们假设已经下载到项目根目录的 third_party 文件夹 include_directories(${CMAKE_CURRENT_SOURCE_DIR}/third_party) # 查找 OpenSSL (如果需要HTTPS) find_package(OpenSSL REQUIRED) # 添加可执行文件 add_executable(weather_query src/main.cpp src/weather_service.cpp src/weather_api.cpp src/weather_data.cpp ) # 链接库 target_link_libraries(weather_query PRIVATE nlohmann_json::nlohmann_json OpenSSL::SSL OpenSSL::Crypto ) # 在Windows下，可能需要链接 ws2_32 和 crypt32 库 if(WIN32) target_link_libraries(weather_query PRIVATE ws2_32 crypt32) endif()

构建与编译：

  1. 在项目根目录创建build文件夹：mkdir build && cd build
  2. 运行CMake生成构建文件：cmake ..(或指定生成器，如cmake -G “MinGW Makefiles” ..)
  3. 编译项目：cmake --build .或直接make(在Linux/macOS) / 在VS中打开生成的sln文件。

4.2 跨平台注意事项

  1. 网络库差异：cpp-httplib底层使用操作系统的Socket API。在Windows上需要链接Ws2_32.lib(ws2_32)，在Unix-like系统上则不需要。
  2. 路径分隔符：在代码中处理文件路径时，使用/（正斜杠）C++标准库和大多数库都能正确处理。避免使用\（反斜杠），因为它是Windows特有的，且是C/C++中的转义字符。
  3. 控制台编码：在Windows命令提示符(CMD)默认是GBK编码，而我们的程序内部使用UTF-8。直接输出中文可能导致乱码。可以在程序启动时使用SetConsoleOutputCP(65001)（UTF-8代码页）来设置，但这并非百分百可靠。更健壮的做法是使用宽字符std::wstring和std::wcout，但这会增加复杂性。对于学习项目，可以暂时先使用英文界面，或者确保你的终端（如Windows Terminal、VS Code集成终端）已设置为UTF-8编码。
  4. 动态链接库：如果链接了OpenSSL等动态库，在部署程序时，需要将对应的DLL（Windows）或.so（Linux）文件与可执行文件放在一起，或者放在系统库路径下。

5. 功能扩展与优化思路

一个基础版本完成后，可以考虑以下方向进行扩展，这能让你的项目更有深度。

5.1 增加天气预报功能

修改WeatherAPI和WeatherService类，添加fetchForecast方法。解析API返回的包含多天数据的JSON数组，用std::vector<Forecast>来存储，并实现一个漂亮的格式化输出函数，按日期展示温度和天气。

5.2 实现简单的缓存机制

频繁查询同一城市的天气是对API额度的浪费。可以引入一个缓存层。

  1. 设计缓存类：例如WeatherCache，内部使用std::unordered_map<std::string, std::pair<CurrentWeather, std::chrono::system_clock::time_point>>。键是城市名，值是一个包含天气数据和过期时间的pair。
  2. 查询逻辑：在WeatherService查询前，先检查缓存。如果存在且未过期（例如设置缓存有效期为10分钟），则直接返回缓存数据；否则，调用API获取新数据，并更新缓存。
  3. 线程安全：如果程序涉及多线程（比如未来做GUI），对缓存的读写需要加锁（如std::mutex）。

5.3 引入配置管理

将API Key、请求基地址、缓存过期时间等配置项移出代码。可以使用nlohmann/json库来读写一个config.json文件。

// config.json { “api_key”: “your_real_key_here”, “base_url”: “https://devapi.qweather.com”, “cache_ttl_minutes”: 10, “default_city”: “Beijing” }

在程序启动时加载这个配置文件，这样更换API Key或调整参数就无需重新编译。

5.4 图形用户界面（GUI）

给控制台程序套个壳，提升用户体验。可以选择：

  • Qt：功能强大，跨平台，C++原生支持。你可以创建一个输入框、一个按钮和一个文本框来显示天气。
  • ImGui：轻量级即时模式GUI，适合需要频繁更新数据的小工具，渲染效率高。
  • Web前端 + 本地后端：用C++写一个HTTP服务器（可以用cpp-httplib本身），提供RESTful API。然后用HTML/JavaScript写一个简单的网页作为界面。这种方式将前后端分离，更接近现代应用架构。

6. 常见问题排查与调试心得

在实际开发和运行中，你肯定会遇到各种问题。这里记录一些典型问题的排查思路。

6.1 编译链接问题

  • **“undefined reference to__imp_curl_easy_init‘…”**：这通常是因为使用了cURL库但链接不正确。确保CMake中正确找到了cURL (find_package(CURL REQUIRED)) 并链接了目标 (target_link_libraries(your_target PRIVATE CURL::libcurl)`）。
  • “cannot find -lssl” 或 “OpenSSL not found”：cpp-httplib启用了HTTPS但找不到OpenSSL。确保系统已安装OpenSSL开发包（如Ubuntu的libssl-dev，Windows的vcpkg或MSYS2中的OpenSSL），并且CMake的find_package(OpenSSL REQUIRED)能成功找到。
  • 大量关于C++11特性的编译错误：检查你的CMakeLists.txt中是否正确设置了set(CMAKE_CXX_STANDARD 11)（或更高），以及编译器是否支持。

6.2 运行时问题

  • 程序运行后立即退出，或查询无结果：
    1. 第一检查点：API Key是否正确？是否已经超过了每日免费调用限额？
    2. 第二检查点：城市名称格式是否正确？API可能要求城市的ID、经纬度或特定的拼音格式。查阅官方文档，用curl命令或Postman先手动测试一下API接口。
    3. 开启调试输出：在performHttpGetRequest函数中，将构建好的完整URL打印出来。复制到浏览器中直接访问，看能否得到正确的JSON响应。这是最直接的验证方法。
  • 返回乱码或解析失败：
    1. 检查编码：确保API返回的JSON是UTF-8编码，你的程序也按UTF-8处理。如果API返回了非UTF-8编码（如GBK），你需要进行转换。nlohmann/json默认期望输入是UTF-8。
    2. 捕获异常并打印原始响应：如前所述，在catch块中打印responseBody。仔细对比打印出的JSON和API文档，看字段名是否匹配，结构是否一致。API版本更新可能导致字段变化。
  • 网络请求超时：
    1. 在httplib::Client创建后，可以设置超时参数：cli.set_connection_timeout(10);和cli.set_read_timeout(30);（单位秒）。
    2. 检查你的网络连接，是否有防火墙或代理阻止了程序对外发起HTTPS连接。

6.3 性能与资源管理

  • 内存泄漏：本项目大量使用了STL容器和智能指针（std::unique_ptr），只要避免手动new/delete而不管理，一般不会出现经典的内存泄漏。使用Valgrind（Linux）或Visual Studio诊断工具（Windows）进行检测是个好习惯。
  • 频繁创建销毁连接：我们的简单实现中，每次查询都创建新的httplib::Client对象。对于频繁查询，可以考虑复用同一个客户端对象（将其作为WeatherAPI的成员变量），但要注意线程安全。cpp-httplib的客户端不是线程安全的，如果多线程使用需要加锁或每个线程单独实例化。

6.4 关于API的选择与限制

免费的天气API通常有调用频率限制（如QPS、每日总量）。在代码中，特别是准备加入缓存机制前，务必阅读并遵守其服务条款。不要在循环中无休眠地疯狂调用API，这可能导致你的IP或API Key被临时封禁。对于学习项目，在查询之间加入短暂的sleep（如std::this_thread::sleep_for(std::chrono::seconds(1))）是礼貌且安全的做法。

这个基于C++的在线天气查询系统项目，从设计到实现，涵盖了现代C++项目开发的多个基础但重要的环节。它像一块敲门砖，帮你把书本上的语法、STL、面向对象概念，敲进一个能实际运行、解决小问题的程序里。过程中遇到的每一个编译错误、运行时bug、设计上的纠结，都是宝贵的经验。当你成功运行起程序，看到命令行里打印出清晰的天气信息时，那种成就感就是学习编程最好的动力。试着去实现前面提到的扩展功能，比如加个缓存、做个配置文件，或者用Qt画个简单的窗口，你会发现这个小小的项目能延伸出非常多的学习路径。