viper 读 TOML 配置时最常报 Config File Not Found，根本不是路径写错，而是它默认不认 .toml 后缀——必须显式告诉它“这是 TOML”，或确保文件名恰好是 config.toml 且在工作目录。
为什么 viper.ReadInConfig() 总报 “Config File Not Found”
因为 viper 不靠后缀自动推断格式，只靠 SetConfigType 或文件名匹配。如果用 viper.SetConfigFile("./conf/app.toml")，就必须在 ReadInConfig() 前调用 viper.SetConfigType("toml")；如果只设了 viper.SetConfigName("config")，那它只找 config（无后缀）或 config.toml（恰好带后缀），其他如 app.toml 直接被忽略。
- 检查当前工作目录：
pwd输出是否和config.toml所在路径一致 - 不要只设
SetConfigName("app")就指望它找到app.toml—— 必须配SetConfigType("toml") - 用
viper.Debug()可打印当前已注册的搜索路径与类型，快速定位是否加载了正确配置源
viper.Get 嵌套字段取不到值？别用点号路径查数组
TOML 中的数组本身不支持 .name 这种点号路径访问，viper.GetStringSlice("servers.name") 永远返回空切片。嵌套结构必须先取整个数组，再手动遍历。
- 正确方式：
servers := viper.Get("servers").([]interface{})，再逐个断言server.(map[string]interface{})["name"] - 若结构固定，更推荐定义 Go struct +
viper.Unmarshal(&conf)，避免运行时类型 panic -
viper.Get("database.host")可以用（因为database是表，host是其字段），但viper.Get("servers.0.name")不行 —— TOML 解析器不支持索引路径
环境变量覆盖失效？点号转下划线是硬性要求
想用 DATABASE_HOST=localhost 覆盖 database.host，必须配 viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))。否则 viper 会去找 DATABASE.HOST，而 shell 根本不允许这种变量名，结果就是覆盖静默失败。
立即学习“go语言免费学习笔记（深入）”；
- 必须在
viper.AutomaticEnv()之前调用SetEnvKeyReplacer - 同时要设
viper.SetEnvPrefix("APP")，这样APP_DATABASE_HOST才能映射到database.host - 环境变量优先级高于文件，但只对已注册的 key 生效 —— 如果
viper没在配置里声明database.host，设了环境变量也无效
用 BurntSushi/toml 手动解析更可控，但不支持热重载
如果你只需要一次性读取、结构明确、不依赖环境变量或监听变更，原生 github.com/BurntSushi/toml 更轻量、错误信息更直接，且 struct tag 控制力更强。
- 安装：
go get github.com/BurntSushi/toml - 解析：
toml.DecodeFile("config.toml", &conf)，注意 struct 字段必须大写且 tag 匹配（如Host string `toml:"host"`） - 写回需手动打开文件并用
toml.NewEncoder(file).Encode(conf)，不能增量更新，整文件覆盖 - 没有内置环境变量合并逻辑，所有覆盖逻辑得自己写
真正容易被忽略的是：viper 的 SetConfigType 和 SetConfigFile 调用顺序，以及环境变量替换器必须在 AutomaticEnv 之前设置 —— 这两个时机错一点，调试时就会陷入“明明改了却没生效”的循环。
