net/ftp 不该用于新项目，因其自 Go 1.19 起被官方弃用，缺乏 PASV 模式、TLS 支持、UTF-8 文件名解析及并发安全，易卡死且无法处理非标准响应。
Go 标准库不提供 FTP 服务器实现，net/ftp 包仅支持客户端（且自 Go 1.19 起已标记为 deprecated），生产环境需谨慎选用第三方库或换用更可靠的协议。
为什么 net/ftp 不该用于新项目
Go 官方明确将 net/ftp 标记为 deprecated：它缺乏主动模式（PORT）以外的连接方式支持，不处理 PASV 模式下的防火墙/NAT 穿透问题，无 TLS/FTPS 支持，且不维护被动端口范围、超时控制和并发安全。实际使用中常见卡死在 conn.Read() 或 ftp.Login() 无响应。
- Go 1.19+ 编译会触发 warning：
"net/ftp: this package is deprecated" - 无法正确解析部分服务器返回的非标准 2xx/3xx 状态码（如 vsftpd 的
220 Ready后多空行） - 不支持 UTF-8 文件名（默认按 ISO-8859-1 解析 LIST 响应）
推荐替代方案：使用 github.com/jlaffaye/ftp
这是目前最活跃、兼容性最好的第三方 FTP 客户端库，支持 PASV/PORT、TLS（FTPS）、代理、自定义超时与重试。它把底层 socket 控制权暴露给调用方，便于调试连接问题。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 安装：
go get github.com/jlaffaye/ftp - 基础上传示例：
conn, err := ftp.Dial("ftp.example.com:21", ftp.DialWithTimeout(5*time.Second)) if err != nil { log.Fatal(err) } defer conn.Quit() err = conn.Login("user", "pass") if err != nil { log.Fatal(err) } file, err := os.Open("local.txt") if err != nil { log.Fatal(err) } defer file.Close() err = conn.Stor("remote.txt", file) // 注意：Stor 是阻塞式上传 if err != nil { log.Fatal(err) } - 关键配置项：
ftp.DialWithTLS(true)启用 FTPS；ftp.DialWithTimeout()避免无限 hang；conn.Rename()和conn.List()可传nil表示使用默认编码（但中文路径建议显式设ftp.WithEncoding("UTF-8")）
没有合规的 Go 原生 FTP 服务器库
不存在被广泛审计、支持完整 FTP 协议栈（包括 PORT/PASV 切换、MLSD、AUTH TLS、速率限制）的 Go 实现。社区中 github.com/freddierice/ftpd 或 github.com/spf13/cobra 衍生的简易 demo 仅能响应 USER/PASS/RETR，无法应对真实客户端（如 FileZilla）的复杂交互序列，且无权限隔离与日志审计能力。
立即学习“go语言免费学习笔记（深入）”；
- 若必须自建 FTP 服务，建议用
vsftpd或proftpd+ Go 写业务逻辑（通过本地 socket 或 HTTP API 控制） - 对内网小文件分发场景，可改用
http.FileServer+ 签名 URL，更轻量、更易监控 - 所有“纯 Go FTP server”项目均未通过 RFC 959 全项测试，尤其在数据连接建立阶段易出现 425 错误（Can't open data connection）
FTP 协议本身的复杂性和现代网络环境（NAT、ALG 干扰、IPv6 混合部署）使得稳定实现成本远高于协议表面看起来的程度。真正需要跨语言/跨平台文件传输时，优先考虑 SFTP（golang.org/x/crypto/ssh）或 WebDAV（github.com/studio-b12/gowebdav）——它们有成熟库、加密默认开启、调试线索清晰。
