Go Modules是Go 1.11起官方推荐且唯一内建的依赖管理方案，取代dep等旧工具；需确保Go≥1.11（建议≥1.16），通过go mod init初始化、go mod tidy同步依赖，并提交go.mod与go.sum至版本库。

Go 1.11 起官方正式引入 Go Modules，并逐步取代旧的包管理工具（如 dep、glide、godep 等）。目前 dep 已归档不再维护，Go Modules 是 Go 官方推荐且唯一内建支持的依赖管理方案。迁移的核心不是“在 dep 和 Go Modules 之间选一个”，而是从 dep 迁移到 Go Modules。

确认 Go 版本并启用 Modules

Go Modules 默认在 Go 1.11+ 启用，但需满足条件：项目不在 $GOPATH/src 下，或显式设置 GO111MODULE=on。

• 运行 go version，确保 ≥ 1.11（建议 ≥ 1.16，因 1.16+ 默认开启 Modules）
• 检查当前是否启用：go env GO111MODULE，若输出 off，临时启用：GO111MODULE=on go mod init
• 推荐全局启用（尤其多项目时）：go env -w GO111MODULE=on

从 dep 迁移到 Go Modules 的步骤

假设你已有基于 Gopkg.lock 和 Gopkg.toml 的 dep 项目：

• 删除旧配置：rm Gopkg.lock Gopkg.toml
• 初始化模块：go mod init （如 go mod init github.com/yourname/project；若省略名称，Go 会尝试从路径推导）
• 同步依赖：go mod tidy —— 自动读取源码中的 import，下载兼容版本，生成 go.mod 和 go.sum
• 验证构建：go build ./... 和 go test ./...，确保无缺失或版本冲突

处理常见迁移问题

迁移中常遇到版本不一致、私有仓库、replace 替换等场景：

• 版本差异：dep 默认使用 ^ 语义，而 go mod tidy 选取的是最小可行版本（latest compatible）。如需锁定某版，可运行：go get example.com/pkg@v1.2.3
• 私有仓库（如 GitLab、自建 Git）：需配置 GO_PRIVATE 或 git config，例如：go env -w GOPRIVATE="gitlab.example.com/*"
• 本地调试或 fork 替换：在 go.mod 中添加：replace github.com/orig/pkg => ../pkg 或 replace github.com/orig/pkg => github.com/fork/pkg v1.3.0

后续开发与协作建议

迁移完成后，团队应统一使用 Modules 流程：

• 提交 go.mod 和 go.sum 到版本库（不可忽略）
• 新增依赖直接 go get，删除未用依赖执行 go mod tidy
• 升级所有依赖：go get -u ./...；升级主版本（含 breaking change）：go get example.com/pkg@v2.0.0
• CI/CD 中无需额外安装 dep，只要 Go ≥ 1.11 即可直接 go build