github actions 中运行 go 测试需显式指定 go 版本、执行 go mod download、添加 -v -race 参数并限定测试路径；缓存 modules 应用 actions/cache 作用于 ${{ env.gopath }}/pkg/mod，key 基于 go.sum；交叉编译需设 goos/goarch 并 chmod +x；部署时须预置 ssh key 和 host key，显式设置 path，用 rsync 替代 scp。
GitHub Actions 中怎么跑 Go 测试？
Go 的测试命令本身很稳定，但 CI 环境里常因 GOPATH、module 模式或依赖缓存出问题。关键不是“能不能跑”，而是“跑得准不准、快不快”。
- 确保
go version与本地一致，用setup-go动作显式指定版本，比如v1.21，别依赖系统默认值 - 必须在
go test前执行go mod download（或让go test自动触发），否则首次运行可能超时失败 - 推荐加
-v -race参数：前者看具体哪个测试卡住，后者捕获竞态——CI 是发现竞态的黄金场景 - 避免用
go test ./...扫全目录，它会包含vendor/或examples/下的无效测试；改用go test ./... -timeout 30s并配合./cmd/...或./pkg/...显式限定范围
- name: Run tests run: go test -v -race -timeout 30s ./pkg/... ./cmd/...
怎么缓存 Go modules 加速 CI？
每次拉 module 耗时长、还容易因网络抖动失败。GitHub Actions 提供 actions/cache，但 Go 的缓存路径和 key 构造有坑。
- 缓存路径必须是
${{ env.GOPATH }}/pkg/mod（Go 1.14+ 默认启用 module 模式后，go mod download写入这里） - key 应基于
go.sum内容生成，而不是只看go.mod：hashFiles('**/go.sum')更可靠，因为间接依赖变更也会体现在go.sum - fallback-keys 可设为
go-mod-${{ hashFiles('**/go.mod') }}，避免go.sum不存在时完全跳过缓存
- name: Cache Go modules
uses: actions/cache@v4
with:
path: ${{ env.GOPATH }}/pkg/mod
key: go-mod-${{ hashFiles('**/go.sum') }}
restore-keys: |
go-mod-${{ hashFiles('**/go.sum') }}
go-mod-${{ hashFiles('**/go.mod') }}
交叉编译二进制并上传到 GitHub Release 怎么做？
Go 支持跨平台编译，但 CI 里要控制产物名、压缩方式、权限、以及 release 是否草稿，稍不注意就传错或覆盖旧版。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 用
GOOS和GOARCH分别设置目标平台，常见组合：linux/amd64、darwin/arm64、windows/amd64 - 编译后记得
chmod +x（尤其 macOS/Linux），否则下载后无法直接执行 - 上传 release 前检查
GITHUB_TOKEN权限：workflow 必须开启permissions.contents: write，否则softprops/action-gh-release会静默失败 - 不要用
draft: true试错——它不会报错，但 release 不可见，容易误以为上传成功
- name: Build binary
run: |
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o dist/myapp-linux-amd64 .
chmod +x dist/myapp-linux-amd64
为什么部署到服务器总连不上？SSH 和环境变量是最大雷区
很多教程直接贴 ssh user@host，但 Actions 运行在容器里，没有 ssh-agent、没加载 ~/.bashrc，且私钥格式不对就会被拒绝。
- 私钥必须用
github secrets存储，并用ssh-keyscan预取 host key，否则 SSH 交互式确认会卡死 workflow - 不要依赖
~/.bashrc或/etc/profile设置的 PATH，部署脚本开头显式写export PATH="/usr/local/go/bin:$PATH" - 用
rsync替代scp更可靠：支持增量、带进度、失败重试方便；但要注意--rsh="ssh -o StrictHostKeyChecking=no"必须加，否则首次连接阻塞
- name: Deploy to server
run: |
mkdir -p ~/.ssh
echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_rsa
chmod 600 ~/.ssh/id_rsa
ssh-keyscan -H ${{ secrets.HOST }} >> ~/.ssh/known_hosts
rsync -avz --rsh="ssh -o StrictHostKeyChecking=no" dist/myapp-linux-amd64 user@${{ secrets.HOST }}:/opt/myapp/
Go 的 CI/CD 看似简单，真正卡住人的从来不是语法，而是缓存 key 的哈希逻辑、SSH agent 的缺失、或是 release 权限这种藏在 YAML 层下的配置细节。动手前先跑通一个最小可测单元：只编译 + 单测，再加缓存，最后动部署——每步验证输出，比堆参数更省时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
