GitHub Actions 可用于 Go 项目 CI/CD,但自动化部署需谨慎:runner 无状态,须显式配置凭据与安全策略;Go 1.11+ 模块下无需手动设 GOPATH;构建应指定 GOOS/GOARCH 并用 -ldflags 减小体积;跨平台需禁用 CGO;二进制传输须用 secrets 存私钥,配合 scp-action 安全部署。
Go 项目用 GitHub Actions 做 CI/CD 是可行的,但直接“自动化部署”需要谨慎判断:GitHub Actions 默认运行在临时、无状态的 runner 上,无法直接 SSH 到生产服务器执行 git pull 或 systemctl restart;真要部署,必须显式配置凭据、目标环境和安全策略。
Go 测试与构建必须指定 GOPATH 和 GOBIN 吗?
不需要。Go 1.11+ 启用模块(go mod)后,GOPATH 对构建已非必需;GitHub Actions 的 Ubuntu runner 预装 Go,且默认工作目录就是仓库根(含 go.mod),直接运行 go test ./... 和 go build -o bin/app . 即可。
常见错误是误设 GOPATH 导致模块解析失败——尤其当 workflow 中用了 actions/setup-go 但又手动覆盖环境变量时。
- 用
actions/setup-go时,不额外设GOPATH,让其使用默认值(如/home/runner/go) - 构建二进制建议加
-ldflags="-s -w"减小体积 - 若项目含 cgo,需提前安装
build-essential或对应 C 工具链
go build 成功但二进制无法运行?检查 CGO 和目标平台
本地 macOS 编译的二进制不能直接丢到 Linux server 上跑。GitHub Actions 默认 runner 是 Linux x64,但如果你在 go build 里没约束 GOOS/GOARCH,而本地开发机是 macOS,就容易忽略跨平台问题。
CI 中应显式声明目标环境: