Go热更新配置需确保配置结构体字段全导出、避免引用类型共享、用atomic.Value原子替换指针，并在viper.WatchConfig回调中手动重载解析，否则易导致脏读或解析失败。
Go 语言里没有“热更新配置”的魔法函数，所谓热更，本质是让业务代码始终读取一个可变但线程安全的指针，而这个指针在后台被新配置实例原子替换。语言学习本身不参与热更逻辑，但结构体设计、字段导出规则、序列化行为这些语言特性，直接决定热更是否稳定。
配置结构体必须全字段导出且不可变
Go 的 json 和 yaml 包只序列化首字母大写的导出字段。如果定义 type Config struct { port int }（小写），viper.Unmarshal() 或 json.Unmarshal() 会静默跳过它，热更后该字段永远是零值。
- 所有字段必须导出：
Port int、DBAddr string，不能是port或dbAddr - 避免嵌入
map[string]interface{}或[]string这类引用类型——浅拷贝后仍共享底层数组，旧 goroutine 可能读到被新配置意外改写的数据 - 推荐用只读封装：字段声明为指针（如
*string），或提供GetDBAddr() string方法，强制业务层每次调用都从最新实例取值
viper.WatchConfig() 回调里必须手动重载 + 解析
viper.WatchConfig() 只发通知，不干活。常见错误是监听了文件却没在回调里调 viper.ReadInConfig()，结果日志显示“配置已变更”，但 viper.GetInt("port") 仍是旧值。
- 回调第一行必须是
if err := viper.ReadInConfig(); err != nil { log.Printf("reload failed: %v", err); return } - 紧接着调
viper.Unmarshal(&newConf)，传入地址（&newConf），不是值（newConf） -
viper.SetConfigType("yaml")必须在ReadInConfig()之前设置，否则解析失败且无提示 - 别依赖
viper.Get("xxx")实时返回新值——它读的是 viper 内部 map 缓存，仅在ReadInConfig()后刷新
用 atomic.Value 替换配置指针，而不是赋值全局变量
写 conf = newConf 不是原子操作，多 goroutine 并发读时可能看到部分更新的脏状态（比如 Port 已更新但 Timeout 还是旧值），尤其结构体含指针字段时易 panic。
立即学习“go语言免费学习笔记（深入）”；
- 声明全局指针：
var globalConf atomic.Value，初始化时globalConf.Store(&defaultConf) - 热更成功后：
globalConf.Store(unsafe.Pointer(&newConf))（注意：传指针地址，不是结构体值） - 业务层读取固定写法：
conf := globalConf.Load().(*Config)，类型断言不可省，且需判空 - 不要用
sync.RWMutex包裹整个结构体赋值——读多写少场景下锁竞争明显，atomic 更轻量
fsnotify 监听要过滤临时文件和终态事件
编辑器保存配置文件时，常先写临时文件（如 config.yaml~ 或 .config.yaml.swp），再 rename 覆盖原文件。若不加过滤，会触发两次事件，第二次解析可能失败（临时文件内容不全）。
- 监听前做路径白名单：
filepath.Base(event.Name)不以.或~开头，且后缀匹配.yaml/.json - Linux/macOS 下，
IN_MOVED_TO和IN_CREATE都可能触发，统一用event.Op&fsnotify.Write != 0判断是否为终态写入 - 监听路径必须是具体文件，如
watcher.Add("./conf/app.yaml")；只加目录"./conf"在 macOS 上易漏事件 - 回调里解析失败必须记录日志并跳过，否则整个监听 goroutine 会因 panic 退出，后续变更再无响应
真正难的不是监听或替换，而是确保每次解析逻辑一致、每次替换后所有依赖组件（如数据库连接池、HTTP client timeout）都感知到变化并重建。语言层面的细节——字段导出、指针语义、原子操作边界——一旦写错，问题往往延迟暴露，排查成本远高于初期多写两行校验代码。
