必须新增泛型函数并让旧函数委托调用，不可重载；旧函数仅做类型转换与转发，需谨慎处理nil、类型断言及约束选择，避免隐性panic。

旧函数签名不能动，但想加泛型支持

直接改 func Process(items []interface{}) 为泛型函数会破坏所有调用方——这是最常踩的坑。Go 不允许同名函数重载，所以你不能保留旧函数又加一个泛型版。真正可行的做法是：**新增泛型函数，旧函数保留但内部委托给新函数**。

• 旧函数保持签名不变，只做类型转换和转发，比如把 []interface{} 转成 []any 后调用泛型版
• 泛型函数命名建议加 Generic 或 Typed 后缀（如 ProcessGeneric），避免歧义
• 如果旧函数逻辑复杂，别在转发层做重复判断；把核心逻辑全抽到泛型函数里，旧函数只负责兼容性适配

interface{} 到泛型的类型桥接要小心 nil 和 panic

从 []interface{} 转成泛型切片时，nil 值和空切片容易引发隐性 panic。Go 泛型不接受 interface{} 直接作为类型参数，必须显式转换。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

• 不要写 ProcessGeneric([]T)(items) 这种强制转换——编译失败
• 正确做法是遍历 []interface{}，用类型断言逐个转成目标类型，再构造新切片；过程中遇到不匹配类型就报错或跳过
• 特别注意：如果原切片含 nil 指针（如 []*string 中有 nil 元素），泛型函数内部做 == 比较前得先确认约束是否支持（comparable 不允许含不可比较字段的 struct）

泛型约束选错会导致调用方编译失败

很多重构卡在“为什么我传了 []int 却报错说不满足约束”——问题往往出在约束定义太窄，或者误用了 constraints.Ordered。

• 如果只是做遍历、打印、序列化，用 any 就够了：func PrintSlice[T any](s []T)
• 如果要做 == 或 map 键，必须用 comparable 约束，但注意：含 func、slice、map 字段的 struct 不满足 comparable
• constraints.Ordered 仅适用于 int、float64、string 等可比较且支持 > 的类型；自定义类型需显式实现 type MyInt int 并确保底层类型支持

第三方库依赖没泛型，怎么绕过？

当你的模块依赖某个老库（比如 github.com/xxx/oldpkg）返回 []interface{}，而你想把它喂给自己的泛型函数时，不能指望对方升级。

• 写一个薄层封装函数，接收旧库返回值，做一次安全转换，再交给泛型主逻辑
• 避免在转换层做业务判断；转换失败就返回 error，让上层决定是忽略、降级还是 panic
• 如果旧库接口返回的是 interface{} 单值（不是切片），别用 .(T) 强转——泛型函数里应统一用 any 接收，再由调用方决定是否进一步断言

泛型重构最难的不是语法，而是边界控制：旧代码不动、新逻辑可测、转换路径无隐藏 panic。每处 interface{} 拆包都要问一句——这里可能是什么类型？有没有 nil？要不要支持自定义类型？漏掉任意一环，上线后就会在某个冷路径上突然崩掉。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！