泛型引入需保持兼容性：不改函数签名、不删导出字段、不改方法行为；泛型函数和结构体必须新增而非覆盖旧版；模块需升v2并更新module path；反射中泛型类型名含参数，旧字符串匹配会失效。
只要不改公开函数签名、不删导出字段、不改已有方法行为，泛型就能安全引入——它本质是新增能力，不是破坏性变更。
泛型函数必须放在新函数名下，不能覆盖旧接口
已有 func SumInts(a, b int) int 就别改成 func Sum[T int | float64](a, b T) T。Go 没有函数重载，同名函数加泛型参数会直接编译失败，且调用方代码会瞬间崩掉。
- 正确做法：新增
func Sum[T int | float64](a, b T) T，保留旧函数不动 - 错误做法：把
SumInts改成泛型版本并保持同名——这会让所有依赖它的项目go build失败 - 如果真想统一入口，可加一层兼容包装：比如导出
Sum（泛型）和SumLegacy（旧版），但不要删旧版
泛型结构体要避免修改原有 struct 字段或方法集
假设你原来有个 type Cache struct { data map[string]interface{} }，现在想支持类型安全的 Cache[K comparable, V any]，别直接改原 struct —— 这会让所有 json.Unmarshal、encoding/gob、第三方序列化逻辑全挂。
- 正确做法：定义新类型
type TypedCache[K comparable, V any] struct { ... }，旧Cache保持原样 - 错误做法：给原
Cache加泛型参数并保留字段名——Go 不允许对已导出类型做这种语法变更 - 注意：泛型 struct 的 JSON tag 不会自动继承，
json:"key"得显式写在每个字段上，否则序列化结果为空
模块版本号必须升级到 v2+，且 go.mod 中明确标注
泛型本身不强制要求大版本升级，但如果你新增了泛型 API，又希望旧用户继续用 v1.x，就必须用 Go 模块的语义化版本规则隔离。
立即学习“go语言免费学习笔记（深入）”；
- 执行
git tag v2.0.0后，更新go.mod第一行：module github.com/you/repo/v2 - 用户导入时需显式写
import "github.com/you/repo/v2"，v1 用户完全不受影响 - 切勿只改 tag 不改 module path——这样
go get仍会拉到 v1，泛型代码无法被识别 - 若只是内部重构加泛型、没暴露新 API，可不升 v2；但凡导出泛型函数/类型，就该升
最容易被忽略的是：泛型类型在反射中会显示为 main.SomeType[int] 这类带参数的完整名，而旧代码若用 reflect.TypeOf(cache).Name() 做字符串匹配，就会失效。这类隐式依赖比语法变更更难发现。
