如何在Golang中实现一个简单的FTP客户端 Go语言网络文件传输

go标准库无net/ftp包，需用github.com/jlaffaye/ftp；pasv模式易因防火墙超时，应禁用并改用port模式；retr返回io.readcloser须手动close；中文名需协商utf-8编码或改用英文路径；并发需独立连接，不可复用conn。

用 net/ftp 连接并列出目录时总卡住或报 EOF

Go 标准库没有内置 FTP 客户端，得靠第三方包；net/ftp 是常见误认——它根本不存在。真正可用的是 github.com/jlaffaye/ftp，但默认启用了被动模式（PASV），遇到防火墙/NAT 或服务器配置不当时，Conn.List() 会超时或返回 EOF。

• 先确认服务器是否支持 PASV：用命令行 ftp -v your-server.com 手动连，看是否能 ls 成功
• 如果不行，初始化客户端时显式禁用 PASV：ftp.Dial("host:21", ftp.DialWithDisabledEPSV(), ftp.DialWithDisabledPASV())
• 注意：禁用 PASV 后走 PORT 模式，客户端需能被服务器主动连回来（内网开发机大概率失败）
• 连接后立刻调用 Conn.NoOp() 测试通道是否活，别等 List() 才发现已断

ftp.Connect() 成功但 Conn.Retr() 下载空文件或 panic

常见错在没处理响应流——Conn.Retr() 返回的是 io.ReadCloser，不是字节切片。直接丢给 io.ReadAll 可能因超时或连接中断读到空内容；更糟的是忘了 Close()，导致后续操作复用坏连接。

• 下载前检查路径是否存在：Conn.Entry(fmt.Sprintf("%s", path))，避免对不存在路径调 Retr
• 用带超时的 io.CopyN 或分块读取，别一股脑 io.ReadAll：

dst, _ := os.Create("local.txt") rc, _ := conn.Retr("remote.txt") io.Copy(dst, rc) // 注意：rc 必须 Close，但 io.Copy 不自动关 rc.Close() // 必须手动

• 若目标是小文件且想全内存处理，用 bytes.Buffer 接收，但记得判 err —— Retr 成功不代表数据完整传完

上传文件时中文名乱码或 550 错误

FTP 协议本身不定义字符集，服务端按自己理解解码文件名。linux vs windows 服务器、vs vs Pure-FTPd 表现完全不同。Go 客户端发的原始字节流，服务端收到后可能当 ISO-8859-1 解，结果中文变 ????。

• 优先用英文路径上传，绕过编码问题；必须用中文时，和服务端约定编码（如 UTF-8），并在连接后发 OPTS UTF8 ON 命令（非所有服务器支持）
• 用 Conn.NameList() 替代 Conn.List() 获取原始文件名列表，少一层解析干扰
• 550 错误不一定是权限问题，也可能是路径含非法字符（如 Windows 的 :|?*），服务端静默拒绝
• 上传前用 filepath.Base() 提取纯文件名，别把本地绝对路径（如 /home/user/测试.txt）直接当远程路径传

并发上传多个文件时连接复用失败或报 use of closed network connection

github.com/jlaffaye/ftp 的 *ftp.ServerConn 不是线程安全的，也不能跨 goroutine 复用。常见写法是起 10 个 goroutine 共享一个 conn，结果互相干扰、状态错乱。

立即学习“go语言免费学习笔记（深入）”；

• 每个 goroutine 必须独立 ftp.Dial + login，用完 Quit() 关闭；别图省事全局存一个连接
• 如果真要复用，得加锁 + 检查连接状态：if err := conn.NoOp(); err != nil { conn, _ = ftp.Dial(...) }，但不如重连简单可靠
• 注意：Quit() 后再调 conn.Login() 会 panic，必须重新 Dial
• 连接池？这个包没提供；自己做的话，用 sync.Pool 存 *ftp.ServerConn，但要注意归还前必须 Quit()，且 Pool 里对象可能过期

FTP 的状态机比 http 复杂得多，连接生命周期、模式切换、编码隐含规则，都容易在“看起来跑通了”的时候埋雷。别信一次成功，多换几台服务器测，尤其注意防火墙策略和字符集协商。