Go SSH远程连接核心三点：HostKeyCallback必须显式设置（生产用ssh.KnownHosts）、Session每次新建、传文件必须用SFTP；私钥格式和known_hosts路径拼接易出错。
Go 做 SSH 远程连接，核心就三点：HostKeyCallback 不能漏、Session 必须每次新建、传文件必须用 SFTP —— 其他都是细节。
HostKeyCallback 是强制项，不是可选项
编译直接报错 missing required field HostKeyCallback，不是忘了填，是 Go 的 ssh.ClientConfig 明确要求你必须显式指定。填 ssh.InsecureIgnoreHostKey() 能过编译，但只该用于本地调试；CI/CD 或容器环境里这么写等于裸奔。
- 生产推荐用
ssh.KnownHosts(knownHostsFile)，路径得自己拼：比如os.UserHomeDir() + "/.ssh/known_hosts"，不能依赖 shell 自动展开 ~ - 想预置某台机器的公钥？先用
ssh-keyscan -t rsa host拿到公钥，再用ssh.ParsePublicKey()解析，最后传给ssh.FixedHostKey(pubKey) - 错误现象
ssh: handshake failed: ssh: unable to authenticate很可能不是密码或密钥错了，而是 HostKeyCallback 拒绝了服务端发来的公钥 —— 建议先打日志看它到底收到了什么 key
别复用 *ssh.Session，每次命令都 NewSession()
*ssh.Session 不是连接池资源，也不是线程安全对象。复用它执行多个命令，大概率触发 write tcp: broken pipe 或静默丢指令。
-
session.Run("ls")和session.Output("whoami")都是同步阻塞调用，内部已调Wait()，再手动session.Wait()会 panic - 需要交互（比如输密码、响应 yes/no 提示）才用
session.Start()+session.Wait()，且必须配session.StdinPipe()和session.StdoutPipe() - 超时控制不能靠
ClientConfig.Timeout（那只管握手阶段），得用context.WithTimeout()包裹session.Run()，否则卡死无解
传文件别碰 session.Run("scp")，改用 sftp.Client
用 session.Run("scp ...") 看似省事，但远端没 scp 命令、shell 被设为 /bin/false、路径含空格或中文，全都会崩，而且错误信息模糊难定位。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- SFTP 是 SSH 协议内置子系统，不依赖远端 shell，权限更细、错误更明确（比如
permission denied直接告诉你缺的是目录写权限还是文件创建权限） - 上传四步固定：
sftp.NewClient(conn)→client.Create("/path/file")→io.Copy()→file.Chmod(0644)（默认是0600，常被忽略导致后续脚本读不了） - 目标目录不存在？
client.MkdirAll()在老旧 SFTP server（如 OpenSSH 早期版本）上可能不支持递归，得自己拆路径逐级Mkdir()
私钥格式和认证方式最容易踩坑
OpenSSH 8.8+ 默认生成新格式私钥（-----BEGIN OPENSSH PRIVATE KEY-----），老代码用 ssh.ParsePrivateKey() 会直接报错 ssh: cannot decode encrypted private keys 或解析失败。
- 临时救急：用
ssh-keygen -p -f key -m pem把新格式转成 PEM 格式（-----BEGIN RSA PRIVATE KEY-----） - 密码认证别硬编码，优先走
ssh.PasswordCallback动态获取；密钥认证记得检查私钥文件权限是否为0600，否则 Go 会拒绝加载 -
client.Do()这个方法根本不存在 —— 所有教程里写的client.Do("ls")都是错的，编译直接报client.Do undefined
最常被跳过的其实是私钥文件权限和 known_hosts 路径拼接逻辑，这两处一错，连接连建立都失败，还容易误判成网络或认证问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
