Go配置管理需用结构化格式+显式解码，viper加载YAML须显式设路径并调用ReadInConfig；JSON反序列化要求字段导出且带正确tag；多环境通过APP_ENV变量控制路径；敏感字段应绑定环境变量；热更新极少必要，多数场景启动时加载一次即可。
Go 本身不内置配置文件解析器，os.Getenv 和 flag 只能解决部分问题；真正可靠的配置加载必须依赖结构化格式（如 YAML/TOML/JSON）+ 显式解码，且需提前约定字段类型和默认值逻辑。
用 viper 加载 YAML 配置时字段未生效？检查初始化顺序和路径设置
viper 不会自动读取当前目录下的 config.yaml，必须显式调用 viper.SetConfigFile 或 viper.AddConfigPath 并触发 viper.ReadInConfig()。常见错误是漏掉 ReadInConfig()，或路径写成相对路径但工作目录不是预期位置。
- 确保配置文件路径正确：
viper.SetConfigFile("./config.yaml")或先viper.AddConfigPath(".")再viper.SetConfigName("config") - 必须在调用
viper.Get*前执行err := viper.ReadInConfig()，否则所有字段返回零值 - 如果使用
viper.AutomaticEnv()，环境变量前缀需用viper.SetEnvPrefix("APP")统一控制
结构体字段无法从 JSON 配置反序列化？注意导出规则和标签写法
Go 的 json.Unmarshal（以及 viper.Unmarshal 底层依赖它）只处理导出字段（首字母大写），且需正确设置 json tag。小写字母开头的字段永远被忽略，即使配置里有对应 key。
- 结构体字段必须首字母大写，例如
Port int `json:"port"`，不能写port int - 嵌套结构体也要导出，
Database DBConfig `json:"database"`中DBConfig字段名也得大写 - 避免用指针字段接收非空配置（如
*string），除非你明确需要区分“未设置”和“空字符串”
type Config struct {
Port int `json:"port"`
Host string `json:"host"`
Database Database `json:"database"`
}
type Database struct {
URL string `json:"url"`
Timeout int `json:"timeout"`
}
多个环境（dev/staging/prod）配置如何安全切换？别硬编码环境名
把环境名写死在代码里（如 viper.SetConfigName("config-" + env)）容易引发部署错配。更可靠的方式是通过环境变量或启动参数传入，并在配置加载前就确定好路径，同时禁用 viper 的自动搜索行为（viper.SetConfigType("")）防止误读其他文件。
立即学习“go语言免费学习笔记（深入）”；
- 统一用
APP_ENV=prod控制，读取后拼接配置路径：viper.SetConfigFile(fmt.Sprintf("config.%s.yaml", os.Getenv("APP_ENV"))) - 调用
viper.ReadInConfig()前加if _, err := os.Stat(viper.ConfigFileUsed()); os.IsNotExist(err) { log.Fatal("config file not found") } - 敏感字段（如密码）应从环境变量注入，而非写入配置文件：
viper.BindEnv("database.password", "DB_PASSWORD")
配置热更新是否必要？多数服务其实不需要
viper.WatchConfig() 听起来很酷，但实际中极少适用：配置变更通常伴随服务重启（比如 Kubernetes ConfigMap 更新会触发 Pod 重建），强行热更新可能造成状态不一致（如连接池参数变更未清理旧连接）。只有极少数场景（如限流阈值、日志级别）值得单独处理。
- 若真要热更新，必须同步保护共享状态，例如用
sync.RWMutex包裹配置结构体读写 - 监听回调里不要直接修改全局变量，而是用原子操作或 channel 通知主逻辑 reload
- 绝大多数 CLI 工具和短生命周期服务，配置只应在启动时加载一次
配置管理最易被忽略的点不是语法或库选型，而是字段生命周期——哪些该由配置决定、哪些该由环境变量覆盖、哪些根本不该出现在配置里（比如密钥轮换时间这类策略，应该写进代码逻辑而非配置项）。
