libcurl上传ftp失败主因是连接模式与认证配置错误：需强制被动模式（curlopt_ftp_use_pasv=1l）、单独设curlopt_userpwd、指定完整url路径；下载大文件须用流式写入回调并正确返回字节数；windows链接需匹配架构与ssl版本，上传前必设curlopt_upload再设大小。
libcurl上传文件到FTP服务器失败，常见报错CURLE_COULDNT_CONNECT或CURLE_LOGIN_DENIED
连不上或认证失败，大概率不是代码逻辑问题，而是FTP连接模式和认证细节没对上。libcurl默认走主动模式（PORT），但大多数现代FTP服务器（尤其带NAT/防火墙的）只接受被动模式（PASV）。另外，ftp:// URL里写密码会被部分版本忽略，必须用curl_easy_setopt单独设CURLOPT_USERPWD。
- 强制启用被动模式：
curl_easy_setopt(curl, CURLOPT_FTP_USE_EPSV, 0L)（禁用EPSV）+curl_easy_setopt(curl, CURLOPT_FTP_USE_PASV, 1L) - 用户名密码别塞URL里，改用：
curl_easy_setopt(curl, CURLOPT_USERPWD, "user:pass") - 如果服务器用FTP over TLS（FTPS），得加：
curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_ALL)，并确保libcurl编译时启用了OpenSSL - 路径注意：FTP服务器根目录不一定是你登录用户的home，
CURLOPT_UPLOAD前用CURLOPT_URL指定完整路径如ftp://host/path/to/file.txt，否则可能传到意外位置
下载大文件时卡住或内存暴涨，CURLOPT_WRITEFUNCTION回调怎么写才安全
直接用std::string拼接所有数据，几MB就OOM；不设CURLOPT_NOPROGRESS又可能被某些FTP服务器的进度响应干扰。关键在控制缓冲区粒度和避免拷贝。
- 回调函数里别做字符串拼接，用
std::vector<uint8_t></uint8_t>或std::ofstream流式写入磁盘 - 示例安全写法：
size_t write_cb(void* ptr, size_t size, size_t nmemb, void* userdata) { std::ofstream* fp = static_cast<std::ofstream*>(userdata); size_t realsize = size * nmemb; fp->write(static_cast<char*>(ptr), realsize); return realsize; } - 务必检查返回值：libcurl要求回调返回**实际接收字节数**，少于
size * nmemb会被视为传输中断 - 下载前加
curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 1L)，避免FTP服务器发PROGRESS命令导致超时
Windows下编译链接libcurl失败，LNK2019: unresolved external symbol
不是头文件没包含，是libcurl的导入库（.lib）没连对，或者运行时DLL找不到。Windows的libcurl分静态/动态、带SSL/不带SSL多个版本，混用必炸。
- 确认你用的是
libcurl.lib（不是curldll.lib），且与你的编译器架构一致（x64项目不能链x86版lib） - 如果用了
CURL_STATICLIB宏，必须定义：#define CURL_STATICLIB，且链接ws2_32.lib、wldap32.lib、crypt32.lib（SSL版还需libssl.lib和libcrypto.lib） - 运行时报
libcurl.dll missing？把对应DLL扔进exe同目录，或加到PATH——别指望系统路径有它 - 用
dumpbin /dependents your_app.exe查实际依赖了哪些DLL，比猜靠谱
上传后文件内容损坏或长度不对，CURLOPT_INFILESIZE和CURLOPT_UPLOAD顺序不能错
libcurl需要提前知道上传文件大小，否则FTP服务器可能截断或拒绝。但CURLOPT_INFILESIZE必须在CURLOPT_UPLOAD设为1L之后调用，否则无效。
立即学习“C++免费学习笔记（深入）”；
- 正确顺序：
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L)→curl_easy_setopt(curl, CURLOPT_INFILESIZE, filesize)→curl_easy_setopt(curl, CURLOPT_READFUNCTION, ...) - 如果文件大小不确定（比如管道输入），用
CURLOPT_INFILESIZE_LARGE传CURL_OFF_T类型，并确保libcurl支持large file - 读回调里返回0表示结束，但别提前close文件句柄——libcurl会在传输完才释放资源
- 上传后建议用
CURLOPT_NOBODY+CURLOPT_HEADERFUNCTION发HEAD请求校验服务器端文件大小是否匹配
FTP协议本身没有事务和原子性，上传中途断开就是半截文件。真要可靠，得自己加MD5校验、断点续传逻辑，或者换SFTP（libssh2）。libcurl的FTP支持够用，但别把它当黑盒——每个curl_easy_setopt调用背后都有协议层含义。
