Go模块语义化版本规则是强制约束：v2+模块必须在导入路径中显式包含/v2后缀，否则工具链拒绝构建；v0/v1可省略路径后缀，因其被默认识别；@latest不跨主版本升级，预发布版默认被忽略。
Go模块的语义化版本规则不是“可选规范”，而是强制约束：不遵守就无法被正确解析、导入或升级。 你写的 v2 模块如果没在导入路径里加 /v2，其他项目 go get 时大概率会失败或静默降级到 v1；你打的 v1.0.0-beta 标签，go mod tidy 默认根本不会选它——这些都不是警告，是确定性行为。
为什么 go.mod 里写 v1.5.0，但 import 路径不能是 example.com/pkg/v2
Go 把「模块路径」和「主版本号」强绑定。路径中是否带 /vN，决定了 Go 工具链是否把它当作一个独立模块看待：
-
example.com/pkg和example.com/pkg/v2是两个完全不同的模块，即使它们代码仓库相同 -
v0和v1是隐式后缀，不用写（也不允许写/v1），所以import "example.com/pkg"就对应v1.x.y -
v2及以上必须显式出现在路径末尾，否则 Go 会认为你发布的是v1的一个非法变体，go list -m all可能报错invalid version: malformed version - 如果你已发布
v2.0.0却没改路径，下游用户执行go get example.com/pkg@v2.0.0会失败，并提示unknown revision v2.0.0或跳转到v1分支
go get @v2.3.4 和 @latest 的行为差异极大
go get 后面跟的版本标识，直接决定 Go 如何解析依赖约束、是否触发 MVS（最小版本选择）算法：
-
go get github.com/sirupsen/logrus@v2.3.4：锁定具体语义化版本，写入go.mod的require行为是确定的，go mod tidy不会自动升版 -
go get github.com/sirupsen/logrus@latest：Go 会找该模块所有带vX.Y.Z标签的最新稳定版（忽略-beta、-rc等预发布标签），但结果不可预测——今天是v2.3.4，明天发了v2.4.0，下次go mod tidy就可能升级 -
go get github.com/sirupsen/logrus@master：生成伪版本号如v0.0.0-20260722101523-abcdef123456，这种版本无法被其他模块可靠复现，CI 构建可能失败 - 生产环境应避免用
@latest或分支名，推荐显式写死@v2.3.4，再配合go mod verify确保go.sum完整性
预发布版本（v1.2.3-beta）为什么默认不被选用
Go 的版本排序规则把预发布版本视为“比正式版更旧”，这是 SemVer 规范的严格实现，不是 Go 的 bug 或疏漏：
- 版本比较逻辑是：
v1.2.3>v1.2.3-beta.2>v1.2.3-alpha.1>v1.2.2 - 因此
go get example.com/pkg（无版本指定）或go mod tidy在满足require example.com/pkg v1.2.0时，只会选v1.2.3，跳过所有-beta标签 - 若你确实需要测试预发布版，必须显式指定：
go get example.com/pkg@v1.2.3-beta.2，且该版本需真实存在于远程仓库 tag 中 - CI/CD 流程中若依赖预发布版，记得在
go.mod里写明完整版本，否则go mod download会拉不到
伪版本号（v0.0.0-yyyymmdd-hhmmss-commithash）的适用边界
伪版本号是 Go 为未打 tag 的提交自动生成的临时版本标识，它只应在开发调试阶段使用：
- 格式固定为
v0.0.0-yyyymmdd-hhmmss-commithash，其中时间戳基于 UTC，哈希是完整 12 位 commit ID - 当你运行
go get github.com/user/repo@abc1234（某次未打 tag 的提交），Go 会查该 repo 最近的v1.x.ytag，然后生成类似v1.2.3-0.20260801123456-abc1234def56的伪版本 - 伪版本号无法被语义化升级（比如
go get -u不会从v0.0.0-20260801-abc1234升到v0.0.0-20260802-def5678），因为它们之间没有 MAJOR.MINOR.PATCH 关系 - 上线前务必替换为真实语义化版本，否则
go.sum中的校验和会随每次go mod vendor变动，破坏构建可重现性
最容易被忽略的一点：主版本路径规则不是“发布时检查”，而是“导入时硬性拦截”。哪怕你本地 go.mod 写着 require example.com/pkg v2.0.0，只要代码里 import "example.com/pkg"（缺 /v2），编译就会报错 cannot find module providing package example.com/pkg——这不是配置问题，是 Go 工具链拒绝识别。路径、版本、导入语句三者必须严格对齐。
