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 替换等场景：
立即学习“go语言免费学习笔记（深入）”；
-
版本差异：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
