Go Modules 是 Go 1.11 起的官方依赖管理机制，go get 在 1.16+ 默认启用；需检查 go.mod 文件、GO111MODULE 环境变量，并避免混用 GOPATH，否则导致依赖混乱、版本不可控。
Go Modules 是 Go 1.11 起引入的官方依赖管理机制，go get 在 Go 1.16+ 默认以 Module 模式运行；直接用 go get 拉包却没初始化 Module，或混用 GOPATH 和 Module，是绝大多数依赖混乱的根源。
如何判断当前项目是否启用 Go Modules
检查项目根目录下是否存在 go.mod 文件。没有该文件，且环境变量 GOPATH 未显式设置为非默认路径，go get 会退化为旧式 GOPATH 模式（包被下载到 $GOPATH/src/），导致本地无法复现构建、版本不可控。
- 运行
go env GO111MODULE：输出on表示强制启用 Module；auto（默认）表示有go.mod就启用，否则回退；off则完全禁用 Module - 在项目根目录执行
go mod init example.com/myapp可主动初始化 Module（模块路径建议与未来发布地址一致） - 若已有
go.mod但go list -m all报错或不显示依赖，说明 Module 未正确加载，需确认是否在正确目录下操作
go get 在 Module 模式下的行为变化
go get 不再只是“下载源码”，而是“解析依赖图 + 下载指定版本 + 更新 go.mod 和 go.sum”。它默认拉取最新 tagged 版本（如 v1.2.3），而非 master 分支最新 commit。
- 添加新依赖：
go get github.com/gin-gonic/gin→ 自动写入go.mod并记录精确版本 - 升级到特定版本：
go get github.com/sirupsen/[email protected]→ 强制锁定该版本 - 降级或撤回：
go get github.com/sirupsen/[email protected]→ 直接覆盖原记录 - 注意：
go get -u会升级直接依赖及其所有间接依赖到最新 minor/patch 版本，极易引发兼容性问题，生产环境应避免无条件使用
go.sum 文件的作用与常见误操作
go.sum 记录每个依赖模块的校验和（checksum），用于验证下载内容是否被篡改或损坏。它不是可选配置，而是 Go 构建时强制校验的依据。
