os.expand仅解析${key}或$key语法，不自动读取环境变量；必须传入func(string) string替换函数（如包装os.getenv处理空值），否则占位符原样保留。
os.Expand 只做模板解析，不自动读环境变量
很多人以为 os.Expand("${HOME}", nil) 会返回 /home/user，结果却是原样字符串。这是因为 os.Expand 本身不调用 os.Getenv，它只负责识别 ${key} 或 $key 语法，并把提取出的 key（如 "HOME"）传给第二个参数——一个 func(string) string 类型的回调函数。
常见错误写法：os.Expand(content, nil)，回调为 nil 就等于没提供替换逻辑，所有占位符原封不动保留。
- 必须显式传入回调函数，例如
os.Expand(content, os.Getenv) - 但
os.Getenv对未设置的 key 返回空字符串，容易导致路径拼接出错（比如"${MISSING}/bin"→"/bin"），建议包装一层处理空值 -
os.Expand不支持嵌套（${${ENV}_PORT}不会解析）、不处理转义、也不识别{{.Key}}等模板语法
viper.AutomaticEnv() 默认不覆盖配置文件值
调了 viper.AutomaticEnv() 却发现 DB_HOST=127.0.0.1 还是被 config.yaml 里的 db.host: localhost 覆盖了？不是函数没起作用，而是它默认被加在 Viper 内部源列表的末尾，优先级最低。
Viper 的读取顺序是「从高到低」：命令行 > 环境变量 > 配置文件 > 默认值。但 AutomaticEnv() 注册的环境变量源，若没干预位置，就排在配置文件之后，自然赢不了。
- 必须先调
viper.SetEnvPrefix("APP")，否则DB_HOST会被映射成db.host还是host完全不确定 - 必须配
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，否则server.port找不到SERVER_PORT（缺转换规则） - 调用顺序不能错：先
ReadInConfig()加载文件，再设前缀和替换器，最后AutomaticEnv()—— 这样它才会插到源列表最前面
嵌套字段 + 环境变量映射必须手动对齐
viper 不会自动推导结构体字段名和配置键之间的关系，也不会把 APP_SERVER_PORT 自动绑定到 Server.Port 字段上。一切映射都依赖显式声明或命名规则。
两个典型断点：
- 环境变量名和配置项名不匹配：没设
SetEnvKeyReplacer，server.port就不会转成SERVER_PORT；设了但没配SetEnvPrefix("APP")，APP_SERVER_PORT就映射到server_port而非server.port - 结构体字段没加
yamltag：type Config struct { Port int }无法接收server.port: 8080，必须写成Port int `yaml:"port"`或Port int `yaml:"server_port"`（取决于 key 分隔符） -
viper.Unmarshal()只认导出字段（首字母大写），且完全忽略字段名大小写或下划线习惯，只看 tag
别混用 viper.GetString 和 os.Getenv 做 fallback
viper.GetString("db.host") 和 os.Getenv("DB_HOST") 的语义完全不同：前者走完整优先级链（env → file → default），后者只查系统变量，且无法区分「未设置」和「设为空」。
常见误操作是在 viper.GetString 后再用 os.Getenv 判断兜底，比如：
if viper.GetString("db.host") == "" {
host = os.Getenv("DB_HOST")
}
这直接绕过了 viper 的设计逻辑，让环境变量既不能覆盖文件值，又不能触发默认值 fallback。
- 要 fallback，统一用
viper.GetString+viper.SetDefault，不要手动查os.Getenv - 若需判断环境变量是否真实存在，用
os.LookupEnv，而不是os.Getenv的返回值是否为空 - 生产代码里避免在初始化后还穿插
os.Getenv，会导致配置行为不可预测、难以调试
export、systemd 里没写 Environment=、shell 启动时忘了 source，都会让 viper.AutomaticEnv() 或 os.Getenv() 拿到空值——这不是代码问题，是部署链路上的盲点。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
