viper.ReadInConfig()必须在fiber.New()之前执行，否则Fiber读取配置时Viper内部仍为空；需先调用SetConfigName、AddConfigPath等，再ReadInConfig，最后Unmarshal到结构体并显式传入fiber.Config。
viper.ReadInConfig() 必须在 fiber.New() 之前完成，否则配置字段全是零值——Viper 不会自动等待 Fiber 启动再加载，它只认你调用的顺序。
为什么 Fiber 应用启动后读不到 config.yaml 里的 port？
常见错误是把 viper.ReadInConfig() 放在 app := fiber.New() 之后，甚至塞进某个 handler 里。Fiber 启动时立即读 viper.GetInt("server.port")，而此时 Viper 内部 map 还是空的。
- 所有
viper.SetConfigName()、AddConfigPath()、ReadInConfig()必须在main()开头执行，且早于任何 Fiber 实例创建 - 别依赖
init()函数——它执行时机不可控，可能被其他包提前触发读取 - 加一层校验：
if viper.ConfigFileUsed() == "" { panic("no config file loaded") }
如何把 YAML 配置安全绑定到 Fiber 的结构体配置？
viper.Unmarshal(&cfg) 不是“读一次就生效”，它只作用于当前内存结构体；Fiber 的 fiber.Config 是值类型，必须显式传入，不能靠全局变量隐式覆盖。
- 定义导出字段结构体，例如：
type ServerConfig struct { Port int `yaml:"port"` Host string `yaml:"host"` } - 先
viper.ReadInConfig()，再viper.Unmarshal(&serverCfg)，最后传给 Fiber：fiber.New(fiber.Config{Port: serverCfg.Port, ...}) - 嵌套字段如
Logger要带完整 tag：Logger LoggerConfig `yaml:"logger"`，且LoggerConfig内部字段也得有yaml:"level"等 - 字段名首字母必须大写（导出），
port int绑定失败，Port int才行
环境变量怎么覆盖 config.yaml 并让 Fiber 端口热生效？
viper.AutomaticEnv() 必须在 ReadInConfig() 前调用，否则 APP_SERVER_PORT=3001 完全不会参与合并流程——Viper 的优先级链（env > file）只在“获取值时”起效，前提是 env 源已被注册。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 顺序不能错：
viper.SetEnvPrefix("APP")→viper.AutomaticEnv()→viper.ReadInConfig() - 环境变量名要匹配 key 路径：想覆盖
server.port，就得设APP_SERVER_PORT=3001（下划线分隔），或提前调viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_")) - Fiber 本身不支持运行时改端口，所谓“热生效”只能靠重启或监听变更后重建
app实例——别指望app.Listener.Addr().Port能动态变
测试 Fiber 集成 Viper 时为什么配置总不对？
因为 viper 默认是全局单例，上一个测试用例没清理，下一个就会读到残留的 server.port=9999，导致断言失败且无提示。
- 每个测试函数开头必须
viper.Reset()，清空所有状态（包括已注册的 env、已加载的文件、默认值） - 别在测试里复用主程序的
viper实例——用v := viper.New()创建干净子实例，再手动v.SetConfigType("yaml")和v.ReadConfig(bytes) - 如果用
viper.Unmarshal()测试结构体绑定，记得检查返回 error，YAML 数字被解析为float64时往int字段赋值会静默失败
Viper 和 Fiber 之间没有魔法桥接，关键就是初始化时机和结构体绑定的显式性——Fiber 不关心你用什么配，它只吃你传进去的 fiber.Config 值；而 Viper 也不认识 Fiber，它只管把 YAML 映射成 Go 结构体。漏掉 ReadInConfig() 或写错 struct tag，结果都是零值，且不报错。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
