必须同时设置CURLOPT_XFERINFOFUNCTION回调、CURLOPT_XFERINFODATA传参、CURLOPT_NOPROGRESS=0L，并确保libcurl≥7.32.0；回调中需防除零、溢出，dl_total为0时显示未知大小；写文件须用CURLOPT_WRITEFUNCTION流式写入，返回实际字节数，文件以"wb"打开，下载后校验HTTP状态码与文件大小。
curl_easy_setopt设置进度回调函数必须传void*指针
libcurl本身不主动显示下载进度，得靠CURLOPT_XFERINFOFUNCTION回调+CURLOPT_XFERINFODATA传参配合实现。关键点是：回调函数签名必须严格为int (*xferinfo_callback)(void *, curl_off_t, curl_off_t, curl_off_t, curl_off_t)，且curl_easy_setopt传入的CURLOPT_XFERINFODATA值会作为第一个参数原样传给回调——很多人直接传this或&progress却忘了在回调里做类型转换，导致访问非法内存。
常见错误现象：Segmentation fault、进度值全为0、回调压根不触发。
- 确保编译时链接
-lcurl，且libcurl版本≥7.32.0（旧版本用CURLOPT_PROGRESSFUNCTION，已废弃） - 必须同时设置
CURLOPT_NOPROGRESS为0L，否则libcurl会跳过进度通知 - 回调返回值必须是
0，返回非0会中止传输 - 注意
curl_off_t是64位整数，打印时用"%" PRId64（需#include <inttypes.h></inttypes.h>）
回调里计算百分比要防除零和溢出
进度回调的第2个参数dl_total是总大小，第3个参数dl_now是已下载字节数。但HTTP响应可能没带Content-Length头，此时dl_total为0——直接除会崩溃，也意味着无法预估百分比。
实用做法是：只在dl_total > 0时算百分比，否则显示"Downloading... (unknown size)"；同时用std::min限制dl_now不超过dl_total，避免因服务端发包异常导致dl_now > dl_total。
立即学习“C++免费学习笔记（深入）”；
int progress_callback(void *clientp, curl_off_t dltotal, curl_off_t dlnow,
curl_off_t ultotal, curl_off_t ulnow) {
if (dltotal == 0) return 0;
double progress = static_cast<double>(dlnow) / dltotal * 100.0;
int percent = static_cast<int>(progress);
// 防止超100%
if (percent > 100) percent = 100;
printf("\rProgress: %d%% (%" PRId64 "/%" PRId64 ")",
percent, dlnow, dltotal);
fflush(stdout);
return 0;
}
写文件要用CURLOPT_WRITEFUNCTION避免内存爆炸
默认libcurl把响应体存进内存，大文件直接OOM。必须用CURLOPT_WRITEFUNCTION接管数据写入逻辑，把每块数据流式写入本地文件。
容易踩的坑：
- 回调函数返回值必须等于实际写入字节数，否则libcurl认为写失败而中止下载
-
CURLOPT_WRITEDATA传入的是FILE*指针，不是文件名字符串 - 打开文件必须用
"wb"模式（Windows下尤其重要，否则换行符错乱） - 别在回调里
fclose，应在curl_easy_perform之后统一关
size_t write_callback(void *ptr, size_t size, size_t nmemb, void *stream) {
FILE *fp = static_cast<FILE*>(stream);
size_t written = fwrite(ptr, size, nmemb, fp);
return written;
}
// 使用时：
FILE *fp = fopen("output.bin", "wb");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
下载完成要检查CURLE_OK且文件大小匹配
curl_easy_perform返回CURLE_OK只代表网络传输完成，不代表HTTP状态码是2xx——比如服务器返回404时libcurl仍可能返回CURLE_OK（除非你额外设了CURLOPT_FAILONERROR）。更隐蔽的问题是：部分CDN或代理会在响应末尾悄悄加footer，导致文件多出几字节。
稳妥做法：
- 调用
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code)确认http_code == 200 - 下载后用
fseek(fp, 0, SEEK_END); ftell(fp)获取实际写入字节数 - 若之前已知
Content-Length，对比二者是否一致（允许误差±1，某些服务器多发\r\n） - 记得
fclose(fp)和curl_easy_cleanup(curl)，否则句柄泄漏
进度回调和写入回调共存时，两个void*参数（CURLOPT_XFERINFODATA和CURLOPT_WRITEDATA）不能混用——它们是独立的，别指望在一个结构体里塞两份数据还不出错。
