C++ FTP客户端用Asio实现主动模式，含控制连接（USER/PASS/LIST/RETR等命令交互）和数据连接（PORT命令+本地监听），支持登录、目录列表、文件下载，强调协议理解与基础通信健壮性。
用 C++ 实现一个简单的 FTP 客户端，核心是处理 FTP 协议的文本交互流程（控制连接 + 数据连接），配合 Asio 做异步网络通信。它不追求全功能（如被动模式自动切换、SSL/TLS、断点续传），但能完成登录、列出目录、下载文件等基础操作，适合理解协议本质和 Asio 实战集成。
理解 FTP 协议基本交互逻辑
FTP 是基于 TCP 的双通道协议：控制连接（默认 21 端口）用于发送命令（USER、PASS、PWD、LIST、RETR、QUIT 等）和接收响应；数据连接（主动模式用 PORT 命令协商，被动模式用 PASV 获取地址）用于传输文件或目录列表。简单客户端推荐先实现 主动模式（Active Mode），逻辑更直观。
关键点：
- 每条控制命令以
\r\n结尾，服务器响应为 3 位数字状态码 + 空格 + 描述（如220 Welcome,331 Password required） - 必须按顺序等待响应后再发下一条命令，不能并发乱序
- 数据连接需单独建立（主动模式下，客户端监听一个端口，用 PORT 告诉服务器“连我这个 IP:Port”）
用 Asio 构建控制连接（同步或异步均可）
初学建议先用 同步 Asio（`boost::asio::ip::tcp::socket::read_some` / `write_some`），避免回调嵌套过深。封装一个 `FtpControlSession` 类管理 socket、缓冲区和基本读写：
立即学习“C++免费学习笔记（深入）”；
- 构造时连接服务器控制端口（如
tcp::resolver解析 host + port） - 提供
send_command(const std::string& cmd)：追加"\r\n"后 write - 提供
read_response()：循环 read 直到收到完整行（含\r\n），解析状态码 - 登录示例：
send_command("USER anonymous"); read_response(); → "331"，再send_command("PASS guest@example.com"); read_response(); → "230"
主动模式下建立并使用数据连接
执行 LIST 或 RETR 前，先让客户端监听本地随机端口，并通过 PORT 命令告知服务器：
- 用
tcp::acceptor绑定0.0.0.0:0获取系统分配端口 - 获取本机 IPv4 地址（注意：NAT/多网卡时需选对，可从 socket local_endpoint 取）
- 构造 PORT 命令：格式为
PORT a,b,c,d,p1,p2，其中p1*256+p2 = 端口号（如端口 50000 → p1=195, p2=64） - 发
"PORT ..." → read_response() → "200 PORT command successful" - 发
"LIST"或"RETR filename"，服务器会主动连你刚才监听的地址+端口 - 调用 acceptor.accept() 接收数据连接，然后用新 socket 读取响应内容（LIST 输出或文件二进制流）
整合与健壮性小提示
实际运行中容易卡在 read 阻塞或响应不全，建议：
- 所有 socket 操作加超时（Asio 支持 deadline_timer 组合，或用 C++20 协程 + steady_timer）
- 响应解析用
std::getline（带\r\n判断）而非固定长度 read - 命令失败时检查状态码前两位（如 4xx/5xx 表错误），不要只判 2xx
- 下载文件时，数据连接用 binary mode（避免 Asio 默认 text 处理 \r\n 转换）
- 退出前确保关闭控制 socket 和数据 socket，避免 TIME_WAIT 泛滥
基本上就这些。跑通 LIST 和单文件 RETR 后，你就掌握了 FTP 客户端最核心的脉络——协议驱动 + 双连接协同。后续可平滑升级为异步版本，或支持 PASV 模式适配防火墙环境。
