Go模块版本控制仅在构建期生效，由go.mod中require声明的最低版本和MVS算法共同决定编译所用代码；它不参与运行时逻辑切换，与热替换、服务发现、配置更新等运行时机制完全分离，二者分属不同抽象层。
Go 模块版本协调 ≠ 自动热替换，二者目标不同、机制分离：模块版本控制解决依赖一致性，热替换解决运行时行为变更；强行混用会破坏语义化版本契约，且 Go 原生不支持二进制级热替换。
go.mod 中的版本声明只影响构建期依赖解析
微服务中每个服务通过 go.mod 显式声明所依赖的其他服务 SDK 或公共库版本，例如：
require github.com/yourorg/user-api v1.3.2
这仅在 go build 阶段生效，决定编译时链接哪个 commit / tag 的代码。它不参与运行时逻辑切换，也不感知服务实例当前部署的是 v1.3.2 还是 v1.4.0 —— 后者由服务发现或 API 网关控制。
- 若多个服务共用一个 proto 仓库，必须用
go get github.com/yourorg/api@v2.1.0显式升级，并提交go.mod变更，否则v2.1.0的字段不会出现在生成的 Go 结构体中 - 主版本升级（如
v1→v2）需配合模块路径变更（github.com/yourorg/api/v2），否则go mod tidy会报错 - CI/CD 流程中应校验
go.sum是否被篡改，避免因私有代理缓存导致实际拉取的 commit 与预期不符
viper.WatchConfig 不等于热更新，只是通知“配置文件变了”
viper.WatchConfig() 本身不做任何重载动作，它只启动一个 goroutine 监听 fsnotify 事件。真正起作用的是你写的 OnConfigChange 回调里是否调用了 viper.ReadInConfig() 或 viper.Unmarshal()。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 漏掉
viper.SetConfigType("yaml")会导致回调中viper.ReadInConfig()解析失败，但错误被静默吞掉 - 回调函数在独立 goroutine 执行，若把配置映射到全局 struct（如
var cfg Config），必须加sync.RWMutex或用原子指针替换，否则读写竞态 - 数据库连接池参数（如
max_open_conns）变更后，必须手动调db.SetMaxOpenConns()，viper 不会自动触发该方法
真正的热替换只能靠“重建资源 + 优雅切换”，不是 reload 代码
Go 语言没有类似 Java HotSwap 或 Erlang 的运行时模块替换能力。所谓“热更新”，本质是：监听配置/信号 → 触发资源重建 → 切换引用 → 关闭旧资源。
- HTTP Server：不能直接改
http.Server.ReadTimeout字段，要新建http.Server实例，调srv.Shutdown()关闭旧 listener，再srv.ListenAndServe()启动新实例 - Kafka consumer：需调
consumer.Close()，重建consumer并重新SubscribeTopics()，否则不会响应新 topic 分区分配 - 日志级别：可直接改 zap.Logger.Core() 返回的
LevelEnabler，这是少数能真·热更的场景，因设计时就预留了 runtime 可变接口
最易被忽略的一点：模块版本和配置热更新属于不同抽象层。你在 go.mod 里锁死 user-api v1.5.0，不代表线上所有实例都运行这个版本——它们可能被服务注册中心按标签路由到 v1.4.0 实例；你也可能在 v1.5.0 服务里热更新了限流阈值，但这跟模块版本无关。混淆这两者，会在排查兼容性问题时浪费大量时间。
