Go 1.11+ 默认启用 Go Modules，版本控制依赖 go.mod 和 go get，import 不支持直接写版本号；必须通过 go get @tag/commit 或 replace 处理私有模块，go.sum 才是版本事实的最终来源。
Go 1.11+ 默认启用 go modules，不再依赖 $GOPATH，指定包版本必须通过 go.mod 文件和 go get 命令控制，直接在 import 语句里写版本号是无效的。
用 go get 拉取并锁定特定版本
Go 不支持 import 时带版本（如 import "github.com/sirupsen/logrus/v2" 这种写法仅在模块路径本身含版本段时才合法，且需模块已发布对应 tag）。真正指定版本的方式是让 go mod 记录依赖项的精确 commit、tag 或伪版本。
-
go get github.com/sirupsen/logrus@v1.9.3：拉取带 git tag 的稳定版本 -
go get github.com/sirupsen/logrus@3a467a0：拉取特定 commit（会自动转为伪版本，如v1.9.3-0.20230518152217-3a467a0d1234） -
go get github.com/sirupsen/logrus@master：拉取默认分支最新，但不推荐用于生产——go.mod中会记录为latest伪版本，后续go mod tidy可能意外升级
执行后，go.mod 会更新 require 行，go.sum 会新增校验行。务必提交这两个文件到版本库。
手动编辑 go.mod 强制指定版本（慎用）
仅当 go get 因网络/权限问题失败，或需覆盖间接依赖版本时才手动改 go.mod。直接修改后必须运行 go mod tidy 验证一致性，否则可能引发构建失败或运行时 panic。
立即学习“go语言免费学习笔记（深入）”；
- 不要只改
require行却不运行go mod tidy—— 模块解析器可能忽略该行，仍用缓存旧版本 - 若要降级某依赖，先
go get example.com/pkg@v1.2.0，再go mod tidy；单纯删掉go.sum或清空pkg缓存不能保证版本回退 - 替换私有模块路径（如公司内网 Git）需用
replace，例如：replace github.com/xxx/yyy => ./internal/yyy
或replace github.com/xxx/yyy => ssh://git@git.internal/xxx/yyy v1.5.0
处理 v2+ 路径兼容性问题
当一个模块发布 v2.0.0 及以上 major 版本，Go 要求导入路径必须包含 /v2 后缀（即模块路径本身带版本），否则会报错 invalid version: module contains a go.mod file, so major version must be compatible。
- 正确方式：模块发布时，
go.mod第一行写module github.com/sirupsen/logrus/v2，使用者 import 时写"github.com/sirupsen/logrus/v2" - 错误方式：模块
go.mod写的是module github.com/sirupsen/logrus，却打 tagv2.0.0—— 此时 Go 会拒绝识别，必须用go get github.com/sirupsen/logrus@v1.9.3降级，或等作者修复模块路径 - 若你自己的项目要发 v2，必须改
go.mod路径、所有 import 语句、并确保 CI 构建环境 clean（避免残留 v1 缓存）
最易被忽略的一点：go.mod 中的版本号只是“建议”，真正生效的是 go.sum 记录的哈希值 + 本地 $GOMODCACHE 中解压的源码。如果有人手动删了 $GOMODCACHE/github.com/xxx/yyy@v1.2.3 目录，下次构建时 go 会重新下载，但只要 go.sum 没变，内容就确定。所以别只盯着 go.mod，go.sum 才是版本事实的最终来源。
