Go Modules 不支持语义化版本范围，仅支持精确版本号或伪版本；主版本升级需显式修改导入路径（如 /v2）；依赖升级靠 go get -u 系列命令触发，而非版本范围语法。
Go Modules 中 go.mod 的版本范围语法怎么写
Go Modules 本身不支持像 npm 或 Cargo 那样的语义化版本范围（如 ^1.2.0 或 ~1.2）。它只认具体版本号或伪版本（pseudo-version），没有内置的版本范围运算符。你看到的 require github.com/some/pkg v1.2.3 就是精确锁定——不是“>=1.2.3”，也不是“1.2.x”，就是 v1.2.3 这一个提交。
这意味着：
-
go get github.com/some/[email protected]→ 锁定该版本，写入go.mod -
go get github.com/some/pkg@latest→ 解析到最新 tagged 版本（如 v1.5.0），并写死该版本 -
go get github.com/some/pkg@master→ 写入伪版本（如v1.2.3-0.20230401123456-abcdef123456），非稳定、不可复现
想实现“兼容性升级”只能靠 go get -u 和 go mod tidy
Go 官方推荐的“松动依赖”方式是：不手动写范围，而是用工具命令触发升级策略。关键区别在于：
-
go get -u→ 升级到**主版本相同**的最新次版本/修订版本（如从v1.2.3升到v1.5.0，但不会升到v2.0.0） -
go get -u=patch→ 只升级修订版本（如v1.2.3→v1.2.7） -
go get -u=minor→ 升级次版本和修订版本（默认行为） -
go get -u=full→ 忽略主版本约束，尝试升级所有依赖（含 v2+）——需配合模块路径带/v2后缀
执行后，go.mod 里仍是精确版本号，只是被替换了；go.sum 也会同步更新校验和。
