libssh2实现sftp上传的核心步骤是：先调用libssh2_session_handshake()建立ssh连接，再用libssh2_sftp_init()初始化sftp子系统；确保远程目录存在（需递归mkdir），用libssh2_sftp_open()以write/creat/trunc标志打开文件；读本地文件、分块写入（推荐32kb缓冲），每次libssh2_sftp_write()必须校验返回值是否等于传入字节数；注意服务端sftp子系统启用状态、认证安全传参、socket超时与非阻塞i/o控制。
用 libssh2 实现 SFTP 上传的核心步骤
纯 C++ 标准库不支持 SFTP，必须依赖第三方 SSH 库。libssh2 是最常用、跨平台、轻量且可嵌入的选择。它提供底层 SSH/SFTP 协议能力，但需要手动处理连接、会话、SFTP 会话、文件打开与写入等流程。
- 先调用
libssh2_session_handshake()建立 SSH 连接，再用libssh2_sftp_init()初始化 SFTP 子系统 - 上传前必须确保远程路径所在目录存在——libssh2 不自动创建父目录，
libssh2_sftp_mkdir()需逐级调用或自己实现递归创建 - 打开远程文件要用
libssh2_sftp_open()指定LIBSSH2_FXF_WRITE | LIBSSH2_FXF_CREAT | LIBSSH2_FXF_TRUNC标志，缺一不可；漏掉TRUNC可能导致追加写入而非覆盖 - 读本地文件、写远程句柄需自行管理缓冲区（推荐 32KB 左右），每次
libssh2_sftp_write()返回值必须检查：仅当等于本次传入字节数才算成功，否则要重试或报错
常见错误：连接成功但 libssh2_sftp_init() 返回 NULL
这不是库 bug，而是服务端未启用 SFTP 子系统或协议协商失败。OpenSSH 默认开启，但某些嵌入式设备或定制 SSH 服务可能禁用 sftp-server 或改用 internal-sftp 且权限受限。
- 确认服务端
/etc/ssh/sshd_config包含Subsystem sftp /usr/lib/openssh/sftp-server（或internal-sftp）且未被注释 - 用命令行验证：
sftp -P <port><user>@<host></host></user></port>能否登录并执行ls—— 如果连这个都失败，C++ 程序必然失败 - libssh2 日志级别设为 1（
libssh2_session_set_log_function()）可输出协商细节，重点看是否出现SSH_MSG_CHANNEL_OPEN_CONFIRMATION和SSH_FXP_INIT交互
如何安全传参：用户名、密码、私钥不能硬编码
明文密码或私钥路径写死在代码里，既违反安全规范，也难以适配不同环境。libssh2 支持多种认证方式，应按优先级选择：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 首选私钥认证：用
libssh2_userauth_publickey_fromfile()，私钥路径通过配置文件或环境变量（如SSH_KEY_PATH）注入，密钥文件权限必须是 600 - 次选密码认证：从 stdin 或安全内存（如
mlock()+ 清零）读取，绝不要存为普通std::string变量 - 避免使用
libssh2_userauth_password()的第三个参数（密码长度）传strlen()结果——若密码含 \0 会截断；应预先计算有效长度或改用宽字符处理逻辑
上传大文件时的阻塞与超时控制
默认情况下，libssh2 所有 I/O 是阻塞的，一个 2GB 文件上传卡住就全进程挂起。必须主动设置 socket 层超时，并配合非阻塞模式做轮询。
- 创建 socket 后立即调用
setsockopt(fd, SOL_SOCKET, SO_SNDTIMEO, &tv, sizeof(tv))设置发送超时（建议 30 秒） - 初始化 session 前调用
libssh2_session_set_blocking(session, 0)，之后所有libssh2_sftp_write()可能返回LIBSSH2_ERROR_EAGAIN，需等待 socket 可写再重试 - 不要用
usleep(1000)空转等待——改用select()或poll()监听 socket 状态，否则 CPU 占用飙升 - 每写入 1MB 记录一次进度，避免用户以为卡死；但日志写入本身不能成为瓶颈，建议用无锁环形缓冲区暂存再批量刷盘
libssh2 的 SFTP 接口没有内置断点续传，上传中途失败就得从头来。真要支持续传，得先用 libssh2_sftp_stat() 查远程文件大小，再用 LIBSSH2_FXF_APPEND 打开并 seek 到对应偏移——但这要求服务端支持随机写且文件未被其他进程锁定，实际兼容性很差。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
