libcurl是C++调用RESTful接口最可靠的选择：全平台支持、HTTPS默认可用、功能开箱即用；GET需用curl_easy_escape编码参数再拼接，POST JSON须手动设Content-Type和精确的POSTFIELDSIZE，并注意全局初始化与句柄生命周期管理。
C++ 没有标准 HTTP 客户端，直接调用 RESTful 接口必须依赖第三方库——别硬写 socket，也别指望 std::filesystem 或 std::net（后者还没进标准）。
选哪个库：libcurl 是当前最稳的选择
不是因为最好，而是因为最可靠：Windows/macOS/Linux 全平台支持、HTTPS 默认可用、代理/重试/超时都开箱即用。Boost.Beast 功能强但学习成本高，cpp-httplib 适合嵌入式或简单 GET，但不处理 DNS 超时和连接池。libcurl 的 curl_easy_perform 就是事实标准入口。
- Windows 下用 vcpkg：
vcpkg install curl:x64-windows，链接时加libcurl.lib - Linux/macOS 用系统包管理：
apt install libcurl4-openssl-dev或brew install curl - 别用静态链接的 curl（尤其 Windows），容易因 OpenSSL 版本不匹配报
CURLM_CALL_MULTI_PERFORM这类已废弃错误
GET 请求怎么传参数：别拼字符串，用 curl_easy_setopt 控制编码
手动拼接 URL 容易漏掉 URL 编码，比如空格变 %20、中文直接乱码。libcurl 提供 CURLOPT_URL + CURLOPT_POSTFIELDS 组合，但 GET 应该用 CURLOPT_HTTPGET 和 CURLOPT_URL 配合 curl_easy_escape。
- 先用
curl_easy_escape对每个参数值单独编码，再拼成 query string - 不要对整个 URL 调用 escape——路径部分（如
/api/v1/users）不能被编码 - 示例片段：
char *escaped = curl_easy_escape(curl, "name=张三&city=北京", 0); // 返回 name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC<br>curl_easy_setopt(curl, CURLOPT_URL, "https://api.example.com/search?" escaped);<br>curl_easy_escape(curl, nullptr, 0); // 清理内存
POST JSON 怎么发：Content-Type 和数据长度缺一不可
只设 CURLOPT_POSTFIELDS 不够，服务端收不到 JSON 会直接返回 415 Unsupported Media Type。libcurl 不自动设 header，必须手动加 Content-Type: application/json，且不能依赖 CURLOPT_POST 自动推导长度——JSON 字符串得自己算 strlen。
- 用
curl_slist_append构造 header list：struct curl_slist *headers = nullptr;<br>headers = curl_slist_append(headers, "Content-Type: application/json");<br>curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
-
CURLOPT_POSTFIELDS设为 JSON 字符串指针，同时必须设CURLOPT_POSTFIELDSIZE为真实字节数（不是字符数，UTF-8 下中文占多字节） - 别用
CURLOPT_COPYPOSTFIELDS——它会复制内存，但你传的是栈上临时字符串，容易悬垂
常见崩溃点：全局初始化、句柄复用、回调函数生命周期
libcurl 不是“创建→发请求→销毁”就完事。没调 curl_global_init(CURL_GLOBAL_DEFAULT) 在 Windows 上可能 crash；重复用同一个 CURL* 句柄发多个请求却没清 CURLOPT_URL，结果发到旧地址；写 WRITEFUNCTION 回调时返回值不是实际写入字节数，curl 就认为传输失败然后 abort。
- 全局 init 只需一次，在 main 开头调用；对应 cleanup 在 exit 前做
- 每个请求建议新建
CURL*句柄，或至少调curl_easy_reset清除旧状态 - 回调函数里接收的数据 buffer 是 libcurl 管理的，别存指针、别 memcpy 到局部变量——要么立刻处理，要么
malloc复制一份
真正麻烦的从来不是发个请求，而是错误码含义模糊（比如 CURLE_COULDNT_CONNECT 可能是 DNS、防火墙、TLS 握手全失败）、超时逻辑和重试策略要自己兜底、HTTP/2 支持得编译时打开选项。这些没法靠查文档绕过去，只能实测。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
