pycurl安装报错“curl/curl.h: No such file or directory”的根本原因是缺少系统级C开发依赖，非Python包问题；Linux需装libcurl4-openssl-dev，macOS用Homebrew配curl-config，Windows推荐预编译wheel或conda安装。
确认 libcurl 已正确链接且头文件可访问
编译时找不到 curl/curl.h 或链接失败，八成是开发包没装全或路径没配对。Linux 上用包管理器安装时，必须同时装运行时库和开发头文件（如 Ubuntu 的 libcurl4-openssl-dev，不是只装 libcurl4）。macOS 用 Homebrew 装完后，curl-config --cflags 和 curl-config --libs 要能正常输出；Windows 下若用 vcpkg，得确保项目引用了 curl 的 target（比如 vcpkg install curl:x64-windows 后，在 CMakeLists.txt 里 find_package(curl CONFIG REQUIRED)）。
- 检查头文件：在源码开头写
#include <curl></curl>，编译不报错才算通过 - 检查链接：
g++ main.cpp -lcurl能成功生成可执行文件，否则说明链接器找不到库 - 跨平台注意：Windows MinGW 需额外链接
-lws2_32 -lwldap32 -lcrypt32，否则运行时报curl_easy_perform() returned 7（无法解析主机名）
基础 GET 请求必须调用的三步初始化流程
libcurl 不是“构造对象→调用方法”那种风格，它靠 C 风格的 handle + callback + option 设置驱动。漏掉任意一步，curl_easy_perform() 就会返回非零值（比如 -1 或 7、28），但不会抛异常，容易误以为请求发出去了。
- 调用
curl_global_init(CURL_GLOBAL_DEFAULT)—— 全局仅需一次，通常放在 main() 开头 - 调用
curl_easy_init()获取CURL*handle，返回nullptr表示初始化失败（比如内存不足） - 调用
curl_easy_setopt(handle, CURLOPT_URL, "https://httpbin.org/get")设置 URL；必须用CURLOPT_URL，不能只传字符串 - 最后必须调用
curl_easy_perform(handle)才真正发起请求；不调它，什么都不会发生
接收响应体内容要自己提供内存缓冲区
libcurl 默认把响应体直接打印到 stdout，这显然不是你想要的。想拿到数据，得用 CURLOPT_WRITEFUNCTION 指定写入回调，并用 CURLOPT_WRITEDATA 把你的缓冲区地址传进去。别指望它自动分配 string 或 vector——C 库不干这事。
- 回调函数签名必须是
size_t write_callback(char *ptr, size_t size, size_t nmemb, void *userdata) -
size * nmemb是本次回调收到的字节数，ptr是数据起始地址，不能直接存ptr（它会被覆盖） - 推荐用
std::string或std::vector<char></char>在userdata里传入，每次回调用append()或insert()累加 - 记得设
curl_easy_setopt(handle, CURLOPT_FOLLOWLOCATION, 1L)，否则 302 重定向会直接返回空响应
// 示例回调
size_t write_to_string(void* ptr, size_t size, size_t nmemb, void* userdata) {
std::string* response = static_cast<std::string*>(userdata);
size_t bytes = size * nmemb;
response->append(static_cast<char*>(ptr), bytes);
return bytes;
}
错误处理不能只看 curl_easy_perform() 返回值
返回 0 表示传输完成，但不等于 HTTP 成功。比如服务器返回 404 或 500，libcurl 仍认为“传输成功”，curl_easy_perform() 返回 0。真要判断业务是否 OK，得配合 CURLOPT_NOBODY、CURLOPT_HEADERFUNCTION 或更简单的 CURLOPT_HEADERDATA + CURLOPT_HEADER 来捕获状态行，或者用 curl_easy_getinfo(handle, CURLINFO_RESPONSE_CODE, &http_code)。
立即学习“C++免费学习笔记（深入）”；
- 调用
curl_easy_perform()前先long http_code = 0;，结束后立即查：curl_easy_getinfo(handle, CURLINFO_RESPONSE_CODE, &http_code) - 如果
http_code == 0，说明根本没收到响应（网络断开、DNS 失败、超时等），此时curl_easy_strerror()才有意义 - 设置超时很重要：
curl_easy_setopt(handle, CURLOPT_TIMEOUT, 10L)（单位秒），否则卡死在 DNS 查询或慢响应上 - 别忘了清理：
curl_easy_cleanup(handle)；全局初始化对应curl_global_cleanup()（main 结尾调一次）
实际跑通的关键点就这些：头文件和链接到位、三步初始化不跳步、响应体手动收、HTTP 状态码单独查。最常被忽略的是 curl_global_init() 和 curl_easy_getinfo() 这两个调用——它们不写，程序看似能跑，但换环境或换 URL 就崩。
