Go模块语义化版本必须加v前缀，因Go工具链硬编码识别v为版本标识符，不加则报invalid version；v2+需改导入路径以实现主版本共存，@latest仅限当前主版本内升级，MVS算法选满足所有约束的最小兼容版本。
Go模块的语义化版本不是可选风格，而是工具链硬性执行的规则系统——写错v前缀、漏掉/v2后缀、误用@latest，轻则go build报错cannot find module providing package，重则线上行为突变。
为什么必须加v前缀？
Go解析器把v当作版本标识符而非约定前缀。不加v（如1.2.3）会被直接拒绝：
-
go get example.com/pkg@1.2.3→ 报错：invalid version: version "1.2.3" does not start with "v" - Git tag 必须是
v1.2.3，不能是1.2.3或release/v1.2.3 -
go list -m -versions只识别符合v\d+\.\d+\.\d+或带预发布后缀（如v1.2.3-beta.1）的tag
v2+为什么必须改导入路径？
Go把example.com/pkg和example.com/pkg/v2视为两个完全独立的模块——这是实现主版本共存的唯一机制。
-
v1路径不变：import "example.com/pkg"，go.mod中module example.com/pkg -
v2必须同步改两处：go.mod第一行写module example.com/pkg/v2，所有import语句改成import "example.com/pkg/v2" - 漏掉任一环节，编译报错：
cannot load example.com/pkg: module example.com/pkg@latest found (v2.1.0+incompatible), but does not contain package example.com/pkg -
v0.x.y和v1.x.y之间无需改路径，v0阶段本身就不承诺兼容性
@latest和@vX.Y.Z到底怎么选？
@latest不是“拉最新版”，而是“拉当前主版本下最新稳定tag”；@vX.Y.Z是精确锁定。
立即学习“go语言免费学习笔记（深入）”；
-
go get example.com/pkg@v1.9.0→go.mod写入require example.com/pkg v1.9.0，go mod tidy不会动它 -
go get example.com/pkg@latest→ 如果远程有v1.12.3但没发v2.0.0，就拉v1.12.3；哪怕已发v2.0.0，只要没改import路径，它也绝不会跨主版本升级 - CI中禁用
@latest：远程新增v1.12.4会导致构建结果不一致 - 预发布版本（如
v1.2.3-alpha.1）默认被@latest忽略，需显式指定才能拉取
为什么go mod tidy有时反而降级了版本？
它执行的是最小版本选择（MVS）算法，目标是满足所有依赖约束的语义序最小版本，不是最新版本。
- A模块要求
github.com/pkg/log v1.10.0，B模块要求v1.8.0→ MVS选v1.10.0（因为v1.8.0不满足A） - 但如果C模块同时要求
v1.2.0，而A降级为v1.5.0，MVS可能选v1.5.0（它是满足A≥1.5.0、B≥1.8.0、C≥1.2.0的最小共同版本） - 查最终选定版本：
go list -m all | grep pkg/log - 查谁在拉哪个版本：
go mod graph | grep pkg/log
真正容易被忽略的点是：版本号和导入路径必须严格同步——v2模块的go.mod、Git tag、import语句、依赖声明，四者缺一不可；任何一处脱节，工具链就直接拒绝加载，不会给你模糊错误提示。
