go中v2模块要求module path必须显式包含/v2后缀，否则v2.0.0 tag无效；github.com/you/repo与/v2被视为完全独立模块，import路径须严格匹配，tag需符合semver规范。
go.mod 里 module path 必须带 /v2 才算 v2 模块
Go 不会把 v2.0.0 tag 当成 v2 模块，除非你在 go.mod 文件里把 module 声明改成带 /v2 后缀的形式。否则 go get github.com/you/repo@v2.0.0 会直接报错：unknown revision v2.0.0 或 invalid version: version "v2.0.0" does not match module path。
常见错误是只打 tag，不改 go.mod：
- 打了
v2.0.0，但go.mod还是module github.com/you/repo→ 失败 - 打了
v2.0.0，同时把go.mod改成module github.com/you/repo/v2→ 成功 - 没打 tag，只改了
go.mod→ 不影响现有 v1 客户端，但新客户端必须用/v2路径导入
v1 和 v2 是两个完全独立的模块
Go 把 github.com/you/repo 和 github.com/you/repo/v2 视为两个不同 module path，互不干扰。这意味着：
- 项目里可以同时 import
github.com/you/repo和github.com/you/repo/v2 -
v1的 bugfix 只发v1.x.y，不影响v2的演进 -
v2的 breaking change 不需要考虑v1用户，因为路径已隔离 - 不能靠
replace把v1替换成v2来“升级”——路径不匹配，go mod tidy会拒绝
Tag 名必须严格以 v 开头且符合 SemVer 格式
Go 解析版本时只认标准 SemVer tag，任何偏差都会触发伪版本（pseudo-version），比如 v1.2.3-0.20230405123456-abcdef123456。这种版本无法被明确引用，也不参与 MVS 版本选择。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
必须满足：
- 以
v开头：v1.2.3✅，1.2.3❌ - 主次修全为数字：
v1.2.3✅，v1.2.x❌ - 预发布段只能用点分隔的 ASCII 字母/数字：
v1.0.0-alpha.1✅，v1.0.0+2023❌（+是构建元数据，Go 完全忽略） - 大小写敏感：
v1.0.0-Alpha和v1.0.0-alpha被视为不同预发布标识符
客户端 import 路径必须和 module path 完全一致
你改了 go.mod 里的 module github.com/you/repo/v2，使用者就必须写 import "github.com/you/repo/v2"，少一个 /v2 就找不到包。
容易踩的坑：
- 忘记更新 import 路径，还用老的
github.com/you/repo→ 编译报错cannot find package - 在
v2模块里误留import "github.com/you/repo"（即自己导入自己旧版）→ 循环依赖或版本冲突 - CI/CD 流程中未清理缓存，导致本地
go mod download拿到旧版本 → 建议加go clean -modcache步骤
真正麻烦的不是打 tag 或改 go.mod，而是让所有下游同步切换 import 路径——这一步没法自动，必须人工对齐。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
