必须启用被动模式（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++免费学习笔记（深入）”；
