Go标准库不提供FTP客户端，net/ftp包不存在；必须使用github.com/jlaffaye/ftp等第三方库，注意PASV模式兼容性、路径匹配、显式关闭连接及明文传输安全风险。
Go 标准库不提供 FTP 客户端支持，net/ftp 不存在 —— 这是初学者最容易卡住的第一步。
为什么 net/ftp 包根本不存在
Go 官方明确拒绝在标准库中加入 FTP 客户端，理由是协议陈旧、安全性差（明文传输用户密码）、且有更现代的替代方案（SFTP/HTTP/WebDAV）。所以任何试图 import "net/ftp" 的代码都会报错 import "net/ftp": cannot find package。
- 别浪费时间翻标准库文档找它，它真的没有
- 社区主流选择是
github.com/jlaffaye/ftp，维护活跃、API 清晰、支持被动模式（PASV）和基本认证 - 注意：该包不支持 FTPS（显式 TLS），如需加密传输，得换用
github.com/pkg/sftp（基于 SSH）或自行封装 TLS 层
用 github.com/jlaffaye/ftp 上传文件的最小可靠写法
直接调用 Upload 容易因连接中断或服务器限制造成静默失败；推荐手动控制连接、切换工作目录、打开文件流再写入。
- 务必设置超时：
conn, err := ftp.Dial("ftp.example.com:21", ftp.DialWithTimeout(30*time.Second)) - 登录后立即调用
conn.Login("user", "pass")，失败要检查是否被防火墙拦截了 PASV 端口 - 上传前用
conn.ChangeDir("/upload")切到目标路径，避免依赖服务器默认目录（常为空或不可写） - 不要用
conn.Stor("file.txt", file)直传 *os.File —— 它内部不处理读取错误，建议先io.Copy(conn.Retr("dummy"), ...)测试连通性
file, _ := os.Open("local.txt")
defer file.Close()
w, _ := conn.Stor("remote.txt")
io.Copy(w, file) // 手动 copy 可捕获 write timeout 或 broken pipe
w.Close() // 必须显式 close，否则服务器可能卡在 incomplete transfer 状态
下载文件时遇到 550 Failed to open file 怎么办
这个错误几乎都和路径有关，不是权限问题 —— FTP 协议里路径分隔符、大小写、相对/绝对路径行为和本地文件系统不一致。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先用
conn.List("")查看根目录内容，确认目标文件名完全匹配（包括大小写） - 避免使用
"./path/file.txt"，改用"path/file.txt"或完整路径"/home/user/path/file.txt" - 某些服务器（如 vsftpd 默认配置）禁用
RETR对上级目录（../）的访问，哪怕你当前已在子目录下 - 如果文件名含空格或中文，尝试先
conn.NameList("*.txt")获取原始编码列表，再原样传给Retr
被动模式（PASV）连不上？检查这三处
PASV 是绝大多数公网 FTP 服务器的唯一可用模式，但 Go 客户端默认启用后，仍可能因 NAT 或客户端网络策略失败。
- 确认服务器返回的 PASV 响应格式为
227 Entering Passive Mode (a,b,c,d,p1,p2)，且解析出的 IP 是公网可路由地址（不是127.0.0.1或内网 IP） - 客户端若在 Docker 或公司内网，可能无法访问服务器 PASV 返回的端口 —— 此时需联系管理员开启对应端口段，或改用主动模式（PORT），但多数云服务器已禁用 PORT
-
github.com/jlaffaye/ftpv0.4+ 支持ftp.DialWithDisabledEPSV()强制不使用扩展被动模式（EPSV），某些老设备需要这个开关
FTP 的麻烦不在代码长度，而在每一步都可能被服务器配置、中间网络设备或协议细节咬一口。调试时优先抓包看 227 响应和后续 TCP 连接是否发出，比查 Go 代码更快定位问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
