只要不改导出函数签名、不删公开接口、不破坏返回值契约，就能安全重构。Go 的接口和包可见性机制天然支持这种“内部换血、外部不变”的演进。保持导出函数签名完全一致是最硬的红线；允许改内部实现但禁止改函数签名；新增函数可选但不得覆盖旧逻辑；用接口隔离实现变更；依赖需构造时注入而非硬编码；模块路径与go.mod replace须同步更新；测试是重构边界的唯一标尺，尤其需覆盖错误路径与语义一致性。
只要不改导出函数签名、不删公开接口、不破坏返回值契约，就能安全重构。Go 的接口和包可见性机制天然支持这种“内部换血、外部不变”的演进。
保持导出函数签名完全一致
这是最硬的红线。任何对func GetUser(id int) (*User, error)的改动——比如加参数、改返回类型、改error位置——都会导致调用方编译失败。
- 允许改内部实现：用 Redis 替换 MySQL 查询、加缓存、拆子函数，只要返回结果和错误行为一致即可
- 禁止改函数签名：哪怕只是把
id int换成id uint64，或把第二个返回值从error改成自定义错误类型（除非该类型实现了error接口且语义兼容） - 新增函数可以，但不要覆盖旧逻辑：比如加
GetUserWithContext(ctx context.Context, id int)，原函数保留不动
用接口隔离实现变更
如果你要替换底层存储、消息队列或第三方 SDK，必须通过接口过渡，而不是直接改service包里的具体类型。
- 原有代码依赖
type UserRepository interface { FindByID(int) (*User, error) }，就继续实现这个接口，哪怕新实现叫PostgresUserRepo或MockUserRepo - 不要在
service层直接import "github.com/xxx/redis"——这会把实现细节暴露出去，后续想切回 MySQL 就得改 service 代码 - 构造时注入依赖：
svc := NewUserService(&PostgresUserRepo{})，而不是svc := NewUserService()里硬编码初始化
模块路径与go.mod replace要同步更新
当把internal/domain/user抽成独立模块时，若没同步调整replace规则，其他包import "example.com/project/user"会找不到包或拉错版本。
Golang Samber Hot
下载
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
立即学习“go语言免费学习笔记（深入）”；
- 先在主项目
go.mod里加：replace example.com/project/user => ./internal/domain/user - 再确保所有引用该模块的包都走这个路径，而不是直接
import "./internal/domain/user"（相对路径无法被其他模块识别） - 发布新版本前，删掉
replace行，并打v1.2.0tag；下游项目执行go get example.com/project/user@v1.2.0即可平滑升级
测试是重构边界的唯一标尺
没有覆盖关键路径的测试，所谓“不破坏 API”只是自我安慰。尤其要注意错误路径和边界条件。
- 原有测试跑不过 = 行为已变，必须回退或修正实现，而不是删测试
- 新增测试不是必须，但至少补全原函数的 panic 场景、空输入、超时等 case
- 避免只测 happy path：比如
GetUser(0)应返回ErrNotFound而非nil，这个契约必须被测试锁定
真正容易被忽略的不是语法层面的兼容，而是错误类型的语义一致性——比如把原来返回errors.New("not found")改成fmt.Errorf("user %d not found", id)，虽然都是error，但下游用errors.Is(err, ErrNotFound)就会失效。
