go模块版本号必须以v开头，git tag、go.mod require和命令行版本字符串均需带v前缀；主版本升级需修改模块路径并更新import；@latest不跨主版本且受mvs影响；预发布版本默认被忽略。
Go模块版本号必须以v开头，否则go get直接报错
不是风格建议，是硬性规则。Git tag、go.mod中require语句、命令行里写的版本字符串，全部必须带v前缀。
常见错误现象：go get example.com/pkg@1.2.3会失败，报错：invalid version: version "1.2.3" does not start with "v"；git tag 1.2.3打出来的 tag 也不会被 go list -m -versions 列出。
-
v1.2.3✅ 合法 -
1.2.3❌ 被拒绝 -
v1.2.x❌ 非数字段不合法 -
v1.02.3❌ 次版本含前导零，解析失败
v2+主版本必须改模块路径，否则import和go get全失败
Go 不允许同一模块路径下共存 v1 和 v2。这不是兼容性问题，是加载机制层面的阻断——没有 /v2 后缀，工具链压根不会去找 v2.0.0 的代码。
必须同步修改两处：
-
go.mod第一行：从module github.com/you/lib改成module github.com/you/lib/v2 - 所有
import语句：从import "github.com/you/lib"改成import "github.com/you/lib/v2"
漏掉任一环节，编译时会报类似：cannot load github.com/you/lib: module github.com/you/lib@latest found (v2.1.0+incompatible), but does not contain package github.com/you/lib。
@latest不会跨主版本升级，但可能隐式降级
@latest 的行为常被误解。它只取当前主版本下的最新稳定版（即同 v1 下最高 v1.x.y），绝不会跳到 v2——哪怕远程已发布 v2.0.0。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
但要注意：@latest 依赖 MVS（最小版本选择）算法，实际选中的版本可能比你本地锁的还低：
- 你
require了v1.5.0，而另一个依赖要求v1.2.0→go mod tidy仍用v1.5.0 - 你
require了v1.8.0，而另一个依赖要求v1.10.0→go mod tidy会升到v1.10.0 - 你
require了v1.12.0，而另一个依赖要求v1.9.0→go mod tidy仍用v1.12.0
真正危险的是 CI 中混用 @latest：远程新增 v1.12.4，构建结果就变了，且无提示。
预发布版本如v1.0.0-beta.1默认被忽略，go list也不显示
Go 工具链完全支持 SemVer 预发布语法（v1.2.3-alpha.1、v1.2.3-rc.2），但默认行为是跳过它们——@latest、go get、go list -m -versions 都只列稳定版。
想显式拉预发布版，必须写全：
-
go get example.com/pkg@v1.2.3-beta.1✅ -
go get example.com/pkg@v1.2.3❌ 拉的是v1.2.3，不是-beta.1
生产环境应避免依赖预发布版本，因为它们不参与 MVS 计算，也不受 go.sum 完整性保障——go mod download 可能拉到不同 commit。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
