必须设置CURLOPT_HTTPPOST并配合curl_formadd构建表单链表，禁用CURLOPT_POST和CURLOPT_UPLOAD，使用CURLOPT_XFERINFOFUNCTION而非已废弃的CURLOPT_PROGRESSFUNCTION，并在上传后调用curl_formfree释放内存。
curl_easy_setopt 上传文件必须设置 CURLOPT_HTTPPOST
直接调用 curl_easy_perform 不会自动触发 multipart/form-data 提交，必须显式启用表单上传模式。常见错误是只设了 URL 和 POST 字段，却漏掉这个关键开关，导致服务端收不到文件字段。
实操要点：
-
CURLOPT_HTTPPOST的值必须是struct curl_httppost *类型指针，不能传NULL或整数 - 必须配合
curl_formadd构建表单链表，每调用一次添加一个字段（文本或文件） - 上传文件时，
CURLFORM_COPYNAME指定表单项名（如"file"），CURLFORM_FILE指定本地路径（如"./report.pdf"） - 如果要同时提交文本字段（如
"username"），用CURLFORM_COPYCONTENTS，不要混用CURLFORM_FILE
进度回调要用 CURLOPT_XFERINFOFUNCTION 而非 CURLOPT_PROGRESSFUNCTION
CURLOPT_PROGRESSFUNCTION 在 libcurl 7.32.0 后已标记为 deprecated，新代码必须用 CURLOPT_XFERINFOFUNCTION，否则编译可能警告，运行时回调不触发。
关键区别：
立即学习“C++免费学习笔记（深入）”；
-
XFERINFOFUNCTION回调原型是int (*func)(void *, curl_off_t, curl_off_t, curl_off_t, curl_off_t)，后四个参数分别是：已上传字节数、总上传大小、已下载字节数、总下载大小 - 上传场景下只看前两个参数：
dl_total通常为 0，ul_total是文件大小，ul_now是当前已发字节数 - 必须返回
0表示继续传输；返回非零值（如1）会中止上传 - 需额外设置
CURLOPT_XFERINFODATA传入用户数据指针（比如指向自定义结构体的void*）
上传大文件前务必设 CURLOPT_UPLOAD 为 0L 并禁用 CURLOPT_POST
很多初学者误以为 CURLOPT_POST = 1L 就能上传，结果服务端收到空 body 或 400 错误。multipart 上传本质是 PUT/POST 请求体构造问题，不是简单开关 POST。
正确做法：
- 确保
CURLOPT_POST是0L（默认值），否则 libcurl 会强制使用 POST 方法并忽略CURLOPT_HTTPPOST配置 -
CURLOPT_UPLOAD也必须是0L—— 它用于纯上传（如 FTP PUT），和 HTTP 表单无关，设成1L会导致请求体格式错乱 - 真正控制方法的是
CURLOPT_CUSTOMREQUEST（可选，默认 POST）和CURLOPT_HTTPPOST（必设） - 若服务端要求 PUT 方法，设
CURLOPT_CUSTOMREQUEST为"PUT"，但仍需保留CURLOPT_HTTPPOST
内存泄漏风险：必须调用 curl_formfree 清理 curl_httppost 链表
每次用 curl_formadd 构造表单都会在堆上分配内存，libcurl 不自动释放。忘记调用 curl_formfree 会导致稳定内存泄漏，尤其在循环上传场景下几秒就崩。
安全写法示例：
struct curl_httppost *formpost = nullptr;
struct curl_httppost *lastptr = nullptr;
curl_formadd(&formpost, &lastptr,
CURLFORM_COPYNAME, "file",
CURLFORM_FILE, "./data.bin",
CURLFORM_END);
curl_formadd(&formpost, &lastptr,
CURLFORM_COPYNAME, "desc",
CURLFORM_COPYCONTENTS, "backup",
CURLFORM_END);
// ... 设置其他选项，执行上传 ...
curl_formfree(formpost); // 必须！
注意：formpost 是链表头指针，传给 curl_formfree 即可，不用遍历释放每个节点。
容易被忽略的一点：如果 curl_formadd 中某次调用失败（返回非 CURLE_OK），formpost 可能部分初始化，此时仍应调用 curl_formfree —— 它能安全处理空指针或半截链表。
