推荐用 toml 或 yaml，toml 简洁无缩进问题，yaml 表达力强但易出错；禁用 ini；统一用 spf13/viper 并开启严格模式；环境变量覆盖需规范命名与自动映射；避免 init() 初始化，改在 main() 显式加载；零值字段应显式校验或 fallback。
配置文件该用 json、TOML 还是 YAML？
go 原生只支持 JSON（encoding/json），但实际项目中 TOML 和 YAML 更常用：TOML 语法简洁、无缩进敏感问题，适合中小型服务；YAML 表达力强，但容易因空格/缩进出错。别用 INI——Go 社区缺乏统一、维护良好的解析库，go-ini/ini 已多年未更新，且不支持嵌套结构。
推荐直接上 spf13/viper，它默认支持 JSON/TOML/YAML/ENV/HCL，还能自动监听文件变更（viper.WatchConfig()）。注意：Viper 的 Unmarshal 默认会忽略字段名大小写差异，若结构体字段是 DBPort，而配置里写成 dbport，也能绑定成功——这容易掩盖拼写错误，建议显式开启严格模式：viper.SetStrictMode(true)。
如何安全加载环境变量并覆盖配置？
生产环境必须允许用环境变量覆盖配置项（比如数据库密码不写死在文件里）。Viper 默认会按顺序读取：默认值 → 文件 → 环境变量 → 命令行参数。关键点在于环境变量名转换规则：默认把 . 替换为 _，且全大写。例如配置项 database.url 对应环境变量 DATABASE_URL。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 调用
viper.AutomaticEnv()启用自动映射 - 用
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))显式声明分隔符替换逻辑（避免依赖默认行为） - 禁止使用
viper.BindEnv("database.password", "DB_PASSWORD")手动绑定——一旦漏绑就无法覆盖，且难以审计 - 敏感字段（如
password、secret_key）应在结构体 tag 中加mapstructure:"-"，防止意外被序列化输出
为什么不能在 init() 里初始化 Viper？
常见错误是在 init() 函数中调用 viper.SetConfigFile() + viper.ReadInConfig()。问题在于：此时工作目录（os.Getwd()）不确定——可能是构建路径、测试路径或容器根目录，导致 ReadInConfig() 找不到文件，报错 Config File "config" Not Found in "[...]"。
正确做法是把配置加载推迟到 main() 开头，或封装为显式初始化函数：
func LoadConfig(path string) error { viper.SetConfigFile(path) viper.SetConfigType("toml") return viper.ReadInConfig() }然后在 main() 中传入绝对路径（比如 ./configs/config.toml），或用 viper.AddConfigPath() 添加多个候选路径，并配合 viper.SetConfigName("config") 让它自动探测后缀。
结构体绑定时，零值字段怎么处理才安全？
Viper 绑定到结构体时，未在配置中出现的字段会被设为 Go 零值（0、""、false），而非保持结构体定义的默认值。比如：
type Config struct { Port int `mapstructure:"port"` } // 若 config.toml 里没写 port，Config.Port 就是 0，不是你想设的默认 8080解决方法有两个：
- 在结构体定义时设字段初始值（Go 1.20+ 支持，但仅限编译期常量）：
Port int `mapstructure:"port"` // 无法直接赋默认值→ 改用指针：Port *int `mapstructure:"port"`，再在代码里判断是否为 nil 并赋默认值 - 更推荐：用
viper.GetXXX()手动取值 + 提供 fallback，例如viper.GetInt("server.port")返回 0 时主动 fallback 到 8080 - 或者用
viper.Get("server.port")+ 类型断言，配合viper.IsSet("server.port")判断字段是否存在，比依赖零值更可靠
配置管理真正的难点不在加载，而在“哪些值必须存在”“哪些可以缺省”“哪些必须加密”——这些约束得靠代码里的显式检查（比如 if viper.GetString("database.dsn") == "" { log.Fatal("missing DSN") }），而不是指望某个库自动兜底。