CURLE_COULDNT_CONNECT（错误码7）表示libcurl无法连接到目标服务器，常见原因包括本地服务未启动、URL错误、网络不通、代理配置干扰、TIME_WAIT端口耗尽或Android平台SDK版本不匹配等。
curl_easy_perform 返回 CURLE_COULDNT_CONNECT 怎么办
本地没起服务或 URL 写错是最常见原因，但更隐蔽的是 cURL 默认不校验证书，而 HTTPS 站点若用自签名证书或证书链不全，CURLOPT_SSL_VERIFYPEER 和 CURLOPT_SSL_VERIFYHOST 会直接拒绝连接。别急着关验证，先确认目标站点证书是否有效：
- 用浏览器打开 URL，看地址栏有没有锁图标和“安全”提示
- 用命令行测试：
curl -I https://example.com，如果报SSL certificate problem，说明证书有问题 - 开发阶段临时绕过（仅限测试）：
curl_easy_setopt(handle, CURLOPT_SSL_VERIFYPEER, 0L)和curl_easy_setopt(handle, CURLOPT_SSL_VERIFYHOST, 0L) - 生产环境必须设为
1L，并用CURLOPT_CAINFO指向可信 CA 文件（如"ca-bundle.crt"）
下载大文件时内存暴涨甚至崩溃
cURL 默认把响应体全缓存到内存，遇到几百 MB 的文件就容易 OOM。必须用 CURLOPT_WRITEFUNCTION 自定义写入逻辑，把数据流式写入磁盘：
size_t write_callback(void* ptr, size_t size, size_t nmemb, FILE* stream) {
size_t written = fwrite(ptr, size, nmemb, stream);
return written;
}
<p>// 设置
FILE* fp = fopen("out.bin", "wb");
curl_easy_setopt(handle, CURLOPT_WRITEFUNCTION, write_callback);
curl_easy_setopt(handle, CURLOPT_WRITEDATA, fp);
-
ptr是 cURL 给你的数据块，size * nmemb是实际字节数，别假设是完整文件 - 回调里不要调
fclose(fp)，cURL 不负责关闭你传的FILE*，得自己收尾 - 如果需要断点续传，改用
CURLOPT_RESUME_FROM并配合fseek(fp, offset, SEEK_SET)
下载进度怎么实时显示
用 CURLOPT_XFERINFOFUNCTION + CURLOPT_NOPROGRESS 控制进度回调，注意它默认被禁用：
- 必须设
curl_easy_setopt(handle, CURLOPT_NOPROGRESS, 0L)才触发回调 - 回调函数原型是
int xfer_info(void* clientp, double dltotal, double dlnow, double ultotal, double ulnow)，其中dlnow是已下载字节数，dltotal是预估总大小（可能为 0） - 避免在回调里做耗时操作（比如 printf 频繁刷屏），可加简单节流：
if ((long long)dlnow % (1024 * 1024) == 0) printf("%.1f MB\n", dlnow / 1024 / 1024); - Windows 下注意
double参数精度问题，dltotal为 -1 表示未知总长，别除零
Windows 上链接失败：LNK2019 unresolved external symbol curl_*
不是头文件包含问题，而是没链接 libcurl 库。Visual Studio 里必须同时做三件事：
立即学习“C++免费学习笔记（深入）”；
- 项目属性 → C/C++ → 常规 → 附加包含目录：填入
libcurl/include路径 - 项目属性 → 链接器 → 常规 → 附加库目录：填入
libcurl/lib（注意区分libcurl.lib和libcurl_a.lib，后者是静态链接版） - 项目属性 → 链接器 → 输入 → 附加依赖项：写
libcurl.lib（动态）或libcurl_a.lib（静态），且要匹配你编译 libcurl 时的运行时库（/MT 或 /MD） - 如果用 vcpkg 安装，推荐
vcpkg install curl:x64-windows，然后用vcpkg integrate install自动注入配置
跨平台项目里，Linux/macOS 用 -lcurl，但 Windows 的 .lib 必须显式指定，漏一个就报 curl_easy_init 未定义。
