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 解，结果中文变 ????。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 优先用英文路径上传，绕过编码问题；必须用中文时，和服务端约定编码（如 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 复杂得多，连接生命周期、模式切换、编码隐含规则，都容易在“看起来跑通了”的时候埋雷。别信一次成功，多换几台服务器测，尤其注意防火墙策略和字符集协商。
