libcurl 是 c++ 调用 restful api 最稳选择，需正确初始化/清理、设关键选项（超时、重定向、user-agent）、https 证书校验、url 编码、raii 封装、独立句柄并发、错误码排查及调试技巧。
用 libcurl 发起 GET 请求是最稳的选择
绝大多数 C++ 项目调用 RESTful API，libcurl 是事实标准——它成熟、跨平台、支持 HTTPS、重试、超时、代理等真实场景需要的功能。别被“C 库”吓住，C++ 调用它非常直接，且比自己手写 socket 或依赖重型框架（如 cpp-httplib）更可控。
常见错误是忽略初始化和清理：curl_global_init(CURL_GLOBAL_DEFAULT) 必须在程序启动时调一次，curl_global_cleanup() 在退出前调一次；否则多线程下可能崩溃，Windows 上还可能 DNS 解析失败。
- GET 示例只需四步：调
curl_easy_init()→curl_easy_setopt()设 URL 和回调 →curl_easy_perform()执行 →curl_easy_cleanup() - 必须设
CURLOPT_WRITEFUNCTION和CURLOPT_WRITEDATA，否则响应体直接丢进 stdout（调试时容易误以为“没返回”） - HTTPS 请求默认校验证书，内网或测试环境若用自签证书，得加
CURLOPT_SSL_VERIFYPEER设为 0L —— 但仅限开发，上线必须关掉这个开关
curl_easy_setopt() 关键参数不能漏
很多请求失败不是因为网络问题，而是几个关键选项没设对。比如没设超时，程序可能卡死在 DNS 查询上；没设 CURLOPT_FOLLOWLOCATION，302 重定向就停在半路；没设 CURLOPT_USERAGENT，有些 API 直接返回 403。
-
CURLOPT_TIMEOUT（单位秒）和CURLOPT_CONNECTTIMEOUT必须显式设，建议分别设为 10L 和 5L，避免无限等待 - POST 提交 JSON 时，除了
CURLOPT_POSTFIELDS，还得配CURLOPT_HTTPHEADER加"Content-Type: application/json"，否则服务端可能解析失败 - 传参带中文或特殊字符？先用
curl_easy_escape()编码 URL，别手动拼接"?q=" + query，否则空格变+、斜杠被吃掉都是坑
用 RAII 封装 CURL* 避免资源泄漏
裸用 libcurl 容易忘掉 curl_easy_cleanup()，尤其函数中途 return 或抛异常时。C++ 不该靠“人工记着 cleanup”，而该用 RAII。
立即学习“C++免费学习笔记（深入）”；
最简封装就是写个 struct CurlHandle，构造函数调 curl_easy_init()，析构函数调 curl_easy_cleanup()，再把 operator CURL*() 声明为 explicit。这样所有 curl_easy_setopt() 都能照常用，但对象生命周期一结束，句柄自动释放。
- 别在类里存
std::string响应体并用std::string::c_str()传给CURLOPT_WRITEDATA——c_str()返回指针可能失效，应该用std::vector<char></char>或自定义 buffer 结构体 - 如果要并发发多个请求，每个线程用独立
CURL*，别共用一个句柄；libcurl内部不是完全线程安全的
错误码 CURLE_COULDNT_RESOLVE_HOST 比 CURLE_COULDNT_CONNECT 更值得先查
遇到连不上，先看错误码。如果 curl_easy_perform() 返回 CURLE_COULDNT_RESOLVE_HOST，说明 DNS 解析失败——不是网络不通，而是域名根本没转成 IP。这时候检查 /etc/resolv.conf（Linux）、DNS 设置（Windows），或者是否用了不可达的内网域名。
-
CURLE_OPERATION_TIMEDOUT通常意味着目标服务器响应慢，而非本地网络断了；可尝试调大CURLOPT_TIMEOUT再试一次 -
CURLE_SSL_CACERT_BADFILE表示 CA 证书路径不对，不是证书过期；libcurl默认不读系统证书库，得手动设CURLOPT_CAINFO指向 PEM 文件（如"ca-bundle.crt"） - 调试时加
CURLOPT_VERBOSE设为 1L，能看到完整 HTTP 头交互，比抓包快得多——但上线前务必关掉，否则日志爆炸
真正麻烦的是需要 OAuth 2.0 或 JWT 签名的 API：这些逻辑没法靠 libcurl 自动完成，得自己算签名头、刷新 token、处理 401 后重试。这部分没通用解法，得贴着具体协议来。
