最稳妥方式是用 os/exec 调用外部命令（如 git、rsync），避免手动文件操作；ssh 部署必须用 golang.org/x/crypto/ssh；配置热加载应以文件哈希比对为准，禁用 fsnotify 直接监听；交叉编译需 cgo_enabled=0 并加 -ldflags '-s -w'。
用 os/exec 调用 shell 命令最稳妥
Go 本身不内置“部署”能力，所有实际操作都得靠调用外部命令完成。直接用 os/exec 启动 git、rsync、systemctl 或容器工具是最常见也最可控的方式。
别试图用 io/fs 或 os 包手动复制文件来模拟部署——路径权限、符号链接、稀疏文件、SELinux 上下文全会出问题。
-
Cmd.Run()适合无输出的简单命令（如systemctl restart myapp） -
Cmd.Output()适合需要捕获 stdout 的场景（如git rev-parse HEAD） - 务必检查
err：即使stderr为空，Run()返回非 nil 错误就代表命令失败（比如rsync退出码 23 表示部分文件失败，但 Go 默认当整体失败） - 避免拼接命令字符串：用
Cmd.Args = []string{"rsync", "-avz", src, dst}，防止 shell 注入或空格截断
SSH 部署必须用 golang.org/x/crypto/ssh
想跳过本地中转、直连目标机执行？别用 exec.Command("ssh", ...)——它依赖系统 ssh 客户端，无法细粒度控制密钥、超时、代理命令，且 Windows 下行为不一致。
官方维护的 golang.org/x/crypto/ssh 是唯一靠谱选择，它能复用已有的私钥、支持 agent 转发、可设 SetDeadline，还能复用连接。
- 私钥加载用
ssh.ParsePrivateKey，别硬编码密码；PEM 解析失败常见原因是密钥含多余空行或 Windows 换行符（\r\n） - 执行远程命令要显式调用
Session.StdoutPipe()和Session.StderrPipe()，否则读不到输出 - 别忽略
session.Wait()返回的err：它反映的是远程命令的退出状态，不是连接错误 - 批量部署时，用
sync.Pool复用*ssh.Client和*ssh.Session，避免反复握手开销
配置热加载别碰 fsnotify 直接监听文件
部署工具常需响应配置变更自动重载服务。但直接用 fsnotify 监听 config.yaml 很容易翻车：编辑器保存时先写临时文件再原子替换，fsnotify 可能触发两次事件；NFS 或容器挂载卷下事件可能丢失。
更稳的做法是让部署流程自己控制“何时生效”：每次部署生成带时间戳的配置副本（如 config.yaml.202405201430），启动时只读取最新命名的文件，由主程序判断是否 reload。
- 若真要用监听，至少加 1 秒去抖：
time.AfterFunc(1*time.Second, func(){ reload() })，避免保存瞬间多次触发 -
fsnotify的Event.Op不可靠，Linux 下Chmod事件可能误报为Write，应以文件内容哈希比对为准 - 容器环境里，
/proc/sys/fs/inotify/max_user_watches常被设得很小，监听大量文件会静默失败
交叉编译二进制时注意 cgo 和目标系统差异
部署工具最终要跑在目标机器上，而目标机可能是 ARM64 的树莓派、或没装 glibc 的 Alpine 容器。直接 GOOS=linux GOARCH=arm64 go build 会失败——只要用了 net、os/user 等包，默认开启 cgo，链接时找不到目标平台的 libc。
关掉 cgo 是最干净的解法，但代价是 DNS 解析退化为纯 Go 实现（不走 /etc/resolv.conf 的 search 域），且无法读取 /etc/passwd。
- 强制静态编译：
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -a -ldflags '-s -w' -o deploy-arm64 - 若必须用
cgo（比如调用 OpenSSL），得在目标系统环境里编译，或用docker buildx拉对应平台的golang:alpine镜像 -
-ldflags '-s -w'必加：去掉调试信息和符号表，二进制体积能压掉 60% 以上，部署更快
跨平台构建这事，看着是编译参数问题，实际卡点永远在运行时依赖链上——比如你本地测试用 systemctl，但目标机是 OpenRC 或 runit，命令根本不存在。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
