libcurl是C++项目发起HTTP GET请求最稳选择，跨平台、支持HTTPS、自动处理重定向和cookie；需正确初始化、设URL协议头、超时选项及响应捕获。
用 libcurl 发起 GET 请求最稳
不用自己手写 socket、不碰 HTTP 协议细节，libcurl 是 C++ 实际项目里最可靠的选择。它跨平台、支持 HTTPS、自动处理重定向和 cookie，而且错误码清晰。
常见错误现象：CURLOPT_URL 没设或 URL 缺协议头（如写成 "example.com" 而不是 "https://example.com"），导致 CURLE_URL_MALFORMAT；或者没调 curl_global_init(CURL_GLOBAL_DEFAULT) 就直接用，Windows 下大概率崩溃。
- 必须在程序启动时调一次
curl_global_init(CURL_GLOBAL_DEFAULT)，退出前配对调curl_global_cleanup() - 每个请求创建独立的
CURL*句柄，别复用后不清空选项（比如上次设了CURLOPT_POST，这次忘关，GET 请求会静默变成 POST） - 响应体默认输出到 stdout，要用
CURLOPT_WRITEFUNCTION+CURLOPT_WRITEDATA捕获到std::string或std::vector<uint8_t></uint8_t>
std::string response;
curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/get");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, [](void* ptr, size_t size, size_t nmemb, void* userp) {
auto& s = *static_cast<std::string*>(userp);
s.append(static_cast<char*>(ptr), size * nmemb);
return size * nmemb;
});
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
std::chrono 控制超时比 setsockopt 更安全
HTTP 请求卡住，99% 是因为没设超时。别碰底层 socket 的 SO_RCVTIMEO，libcurl 提供了更语义化、跨平台一致的选项。
使用场景：内网服务调用要快（CURLOPT_TIMEOUT_MS 设 3000），公网 API 要容忍弱网（CURLOPT_CONNECTTIMEOUT_MS 单独设 5000，CURLOPT_TIMEOUT_MS 设 15000）。
立即学习“C++免费学习笔记（深入）”；
-
CURLOPT_CONNECTTIMEOUT_MS：只管 TCP 握手完成，不包含 TLS 握手和 HTTP 传输 -
CURLOPT_TIMEOUT_MS：从发起请求到拿到完整响应的总耗时上限，包含 DNS 查询、连接、TLS、发送请求、接收响应全部阶段 - 如果只设
CURLOPT_TIMEOUT（秒级），在快速失败场景下不够精确，务必用带_MS后缀的版本
HTTPS 验证失败？先确认是证书问题还是配置漏项
报错 CURLE_SSL_CACERT 或 CURLE_PEER_FAILED_VERIFICATION，不是一定要关验证，而是得搞清原因。
性能影响：关闭证书验证（CURLOPT_SSL_VERIFYPEER 设为 0L）会让 HTTPS 退化成“有加密无身份”，开发测试可以临时开，但上线必须关掉。
- Linux/macOS 一般自带系统 CA 证书路径，
libcurl默认能找到；Windows 没有统一位置，得手动用CURLOPT_CAINFO指向一个 PEM 文件（比如 Mozilla 的cacert.pem） - 内网自签证书：用
CURLOPT_SSL_CTX_FUNCTION注入自定义校验逻辑，或把根证书加进CURLOPT_CAINFO指向的 PEM - 别用
CURLOPT_SSL_VERIFYHOST0L——它已废弃，且不等于跳过域名匹配，新版本会直接报错
POST 发 JSON 数据，别手动拼字符串
用 curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json_str.c_str()) 看似简单，但容易漏关键头、乱编码、没处理二进制字节。
常见错误现象：服务端收不到 body、解析出空对象、中文变乱码。
- 必须显式设置
CURLOPT_HTTPHEADER，至少包含"Content-Type: application/json"和"Accept: application/json" - 如果
json_str含非 ASCII 字符（如中文），确保它是 UTF-8 编码，且没额外 BOM；libcurl不做字符集转换 - 不要用
CURLOPT_COPYPOSTFIELDS——它会复制一份内存，但如果你传的是栈上临时std::string::c_str()，可能指向已销毁内存
复杂点在于：HTTP 头字段大小写不敏感，但某些代理或网关会严格检查 Content-Type 拼写；还有，如果 POST 体很大，得考虑用 CURLOPT_READFUNCTION 流式上传，而不是全量加载进内存。
