在CI/CD中使用go Modules需提交go.mod和go.sum以锁定依赖版本，设置GOproxy提升下载速度，配置GOprivate处理私有模块，结合gitHub Actions示例实现构建、测试自动化，确保依赖一致与构建可重复。

在CI/CD流程中使用golang管理模块，关键在于确保依赖一致性、构建可重复性和最小化网络请求。Go Modules 已成为官方依赖管理方案，结合 CI/CD 可实现高效、可靠的自动化流程。

锁定依赖版本（go.mod 与 go.sum）

Go Modules 使用 go.mod 和 go.sum 文件记录依赖的精确版本和校验和。在 CI/CD 中必须提交这两个文件到版本控制。

• 确保每次构建都基于相同的依赖版本，避免“在我机器上能运行”的问题
• CI 环境通过 go build 或 go mod download 自动拉取锁定版本的模块
• 建议在开发阶段运行 go mod tidy 清理未使用的依赖，再提交变更

启用 Go Module 下载代理（GOPROXY）

在 CI 环境中设置 GOPROXY 可显著提升模块下载速度并增强稳定性。

常用配置：

• export GOPROXY=https://proxy.golang.org,direct
• 国内环境可使用：https://goproxy.cn,direct

这能让 CI 快速从公共代理获取模块，避免访问原始 github 造成的超时或限流问题。

立即学习“go语言免费学习笔记（深入）”；

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

离线或私有模块处理

若项目依赖私有仓库（如公司内部 Git 模块），需在 CI 中配置认证方式。

• 使用 ssh 配置：将部署密钥添加到 CI 环境，并确保 go get 能克隆私有库
• 通过 replace 指令临时替换模块路径（不推荐长期使用）
• 设置 GOPRIVATE 环境变量，防止私有模块被发送到公共代理
  export GOPRIVATE=git.company.com,github.com/org/private-repo

CI 构建流程示例（GitHub Actions）

以下是一个典型的 Golang CI 构建步骤：

 jobs:   build:     runs-on: ubuntu-latest     steps:       - uses: actions/checkout@v4       - name: Set up Go         uses: actions/setup-go@v4         with:           go-version: '1.21'       - name: Download modules         run: go mod download       - name: Build         run: go build -v ./...       - name: Test         run: go test -race ./... 

该流程确保模块预先下载，构建和测试均在一致环境中进行。

基本上就这些。只要保证 go.mod/go.sum 正确提交，合理配置代理和私有模块访问，Golang 模块在 CI/CD 中就能稳定运行。