必须启用被动模式（PASV）才能在现代网络中成功上传，关键选项包括CURLOPT_URL（含凭据）、CURLOPT_UPLOAD、CURLOPT_READDATA、CURLOPT_FTP_USE_PASV=1L；禁用EPSV可提升兼容性；错误处理需关注CURLE_LOGIN_DENIED、CURLE_REMOTE_FILE_NOT_FOUND等码；大文件须流式读取并设CURLOPT_INFILESIZE_LARGE和超时参数；FTP上传不可用HTTP相关选项。
如何用 libcurl 在 C++ 中上传文件到 FTP 服务器
libcurl 支持 FTP 上传，但默认是主动模式（PORT），很多现代网络环境（如 NAT、防火墙）会阻断数据连接。必须显式启用被动模式（PASV），否则 CURLE_COULDNT_CONNECT 或超时是大概率事件。
关键不是“能不能传”，而是“怎么让连接通”。上传本身只需设置几个选项，难点在连接建立阶段。
-
curl_easy_setopt(curl, CURLOPT_URL, "ftp://user:pass@host/path/file.txt")—— URL 必须含完整凭据和目标路径，不能只写域名 -
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L)—— 启用上传模式（不是 POST） -
curl_easy_setopt(curl, CURLOPT_READDATA, &file_handle)—— 绑定已打开的FILE*，libcurl 会从中读取内容 -
curl_easy_setopt(curl, CURLOPT_FTP_USE_EPSV, 0L)—— 强制禁用 EPSV（IPv6 扩展 PASV），避免某些老 FTP 服务器不兼容 -
curl_easy_setopt(curl, CURLOPT_FTP_USE_PASV, 1L)—— 必开，否则大概率连不上数据通道
处理 FTP 上传中的常见错误码
上传失败时，curl_easy_perform() 返回非零值，需结合 curl_easy_strerror() 和 HTTP/FTP 状态码判断原因。最常遇到的不是认证失败，而是路径或权限问题。
-
CURLE_LOGIN_DENIED：用户名/密码错，或服务器拒绝该用户 FTP 登录（注意：有些服务器关闭 FTP 账号，只留 SFTP） -
CURLE_REMOTE_FILE_NOT_FOUND：目标目录不存在，libcurl 不自动创建父目录，需提前用ftp://.../path/+CURLOPT_CUSTOMREQUEST "MKD path"手动建 -
CURLE_FTP_COULDNT_STOR_FILE：权限不足（如目标目录不可写）、磁盘满、或文件名含非法字符（空格、中文未编码） -
CURLE_OPERATION_TIMEDOUT：90% 是 PASV 模式被防火墙拦截，检查是否设置了CURLOPT_FTP_USE_PASV
上传大文件时如何避免内存暴涨和超时
libcurl 默认会把整个文件读入缓冲区再发，对大文件极不友好。必须配合流式读取 + 合理超时控制，否则程序卡死或被服务器断连。
立即学习“C++免费学习笔记（深入）”；
一套面向小企业用户的企业网站程序！功能简单，操作简单。实现了小企业网站的很多实用的功能，如文章新闻模块、图片展示、产品列表以及小型的下载功能，还同时增加了邮件订阅等相应模块。公告，友情链接等这些通用功能本程序也同样都集成了！同时本程序引入了模块功能，只要在系统默认模板上创建模块，可以在任何一个语言环境（或任意风格）的适当位置进行使用！
- 用
fopen(..., "rb")打开文件，传给CURLOPT_READDATA，libcurl 内部按需调用fread() -
curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, (curl_off_t)file_size)—— 显式告知大小，避免 libcurl 自己fseek(SEEK_END)（某些文件系统不支持） -
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 300L)—— 总超时设长些；CURLOPT_LOW_SPEED_LIMIT和CURLOPT_LOW_SPEED_TIME可防慢速挂起 - 不要用
std::string或std::vector全局加载文件——这是新手最常踩的内存坑
为什么 CURLOPT_POST 和 CURLOPT_HTTPPOST 不能用于 FTP 上传
因为 FTP 不是 HTTP 协议。CURLOPT_POST 仅对 HTTP/HTTPS 有效，强行设了也无作用；CURLOPT_HTTPPOST 是 multipart/form-data 专用，和 FTP 完全无关。混淆这两者会导致静默失败——curl 返回 CURLE_OK，但服务器根本没收到文件。
FTP 上传唯一正路是 CURLOPT_UPLOAD + CURLOPT_READDATA。如果看到示例混用 HTTP 选项，基本可以判定它跑不通 FTP。
另外注意：libcurl 的 FTP 支持默认编译进库，但如果你用的是精简版（比如 Android NDK 自带的 curl），可能不含 FTP 协议，此时 curl_version_info(CURLVERSION_NOW)->features & CURL_VERSION_FTP 会返回 0，得换全量库。
