应将配置加载逻辑移至main()开头、flag.parse()之后显式调用，避免在init()中读取配置，因其执行时命令行参数和环境变量尚未解析，易导致panic或配置字段为零值。
main()开头显式调用配置加载，别碰init()
Go项目启动时，init()函数会在包导入阶段执行，此时flag还没解析、os.Args还是原始值、环境变量也未被读取上下文处理。如果你在config包的init()里直接调viper.ReadInConfig()或ioutil.ReadFile("config.yaml")，大概率会panic或读到全零值配置。
正确做法是把加载逻辑完全移出init()，封装成一个函数（比如config.Load()），然后在main()最开始、flag.Parse()之后立即调用：
-
flag.Parse()必须先于配置加载，否则无法根据-env=prod等参数决定文件路径 - 不要在
var声明时调用yaml.Unmarshal()——它依赖外部IO，不是纯初始化 - 如果用viper，确保
viper.ReadInConfig()只调一次，且其前已设置好viper.SetConfigFile()或viper.AddConfigPath()
路径必须显式传入，不能依赖当前工作目录
Go程序运行时的os.Getwd()不可靠：本地go run main.go可能在项目根，测试时go test ./internal/config却在子目录，Windows服务默认在C:\Windows\System32。硬编码"./configs/config.yaml"必然失败。
推荐方案是让Load()接收一个configDir string参数，并用filepath.Join(configDir, "config.yaml")拼路径：
- 在
main()中用os.Executable()+filepath.Dir()获取二进制所在目录，再向上跳一级或拼"configs" - 或者统一约定配置目录为项目根，用
os.Chdir()切过去（仅限开发/CLI场景，不推荐服务） - 避免
viper.AddConfigPath(".")——点号含义随os.Getwd()漂移，CI/CD和Windows服务都会翻车
用结构体绑定配置，别用viper.GetString("xxx")
直接用viper.GetString("database.host")或os.Getenv("DB_HOST")会导致字段名拼错只能runtime发现、IDE无法跳转、重构无法批量重命名、单元测试必须mock全局状态。
应定义强类型Config结构体，带明确tag，再用mapstructure.Decode()或viper.Unmarshal()填充：
- 所有字段首字母大写（导出），例如
Host string `mapstructure:"host"` - 嵌套结构体也要导出：
Database DBConfig `mapstructure:"database"` - 敏感字段（如密码）可单独从环境变量注入，但绑定逻辑仍在结构体内完成，不散落各处
- 校验逻辑（如
Port > 0）写在Load()末尾，失败直接log.Fatal，不留给后续代码踩坑
viper动态切换配置文件的常见误操作
想支持-env=prod就换配置文件？很多人反复调viper.SetConfigFile("prod.yaml"); viper.ReadInConfig()，结果viper.Get("db.host")突然返回nil——因为多次ReadInConfig()会覆盖viper内部键值映射表，旧key失效。
正确姿势是：
- 只在首次加载前调一次
viper.SetConfigFile()或viper.AddConfigPath()+viper.SetConfigName() - 后续环境差异用
viper.MergeConfigMap()合并运行时参数，或用viper.SetEnvPrefix("APP")补环境变量 - 若真要多环境文件分离，用
viper.AddConfigPath("./configs"); viper.SetConfigName("config"); viper.SetConfigType("yaml")，再靠APP_ENV=prod触发自动加载config-prod.yaml（需viper v1.12+） - 永远检查
viper.ReadInConfig()的error，常见错误Config File "config" Not Found in "[./configs]"说明路径根本没对上
配置加载不是“写完就跑”，关键在于路径可控、时机明确、结构可测。一旦把路径决策和加载时机混进init()或viper隐式行为里，调试成本会指数上升。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
