os.getenv读不到环境变量是因为加载时机错误：必须在main()开头、gin实例创建前完成godotenv.load()或系统环境设置，否则os.getenv("port")等返回空字符串，导致硬编码端口或panic。
os.Getenv 读不到环境变量？加载时机错了
不是 Gin 有问题，是 os.Getenv 调用太晚了。Gin 的 r.Run() 启动前，所有配置必须已就绪；如果环境变量在容器启动后注入、或 .env 文件没提前 godotenv.Load()，os.Getenv("PORT") 就返回空字符串。
常见现象：router.Run(":8080") 硬编码端口、database_url 为空导致 panic。
-
godotenv.Load(".env")必须放在main()最开头，且路径要对（默认从当前工作目录找） - Linux/macOS 下变量名严格区分大小写：
ENV=prod和env=prod是两个不同变量 - 别在 handler 或中间件里反复调用
os.Getenv——性能差，且并发下可能读到未初始化值
viper.ReadInConfig 失败？路径和格式要核对清楚
viper.ReadInConfig() 报错 “config file not found” 或 “unsupported config type”，基本是路径或格式配置不对。Viper 不会自动猜路径，也不会自动识别文件后缀。
典型错误：
-
viper.SetConfigName("app")+viper.SetConfigType("yaml")，但没调用viper.AddConfigPath("configs/")，导致找不到configs/app.yaml - 写了
viper.SetConfigFile("./config.yaml")，却漏掉viper.SetConfigType("yaml")，Viper 就不知道怎么解析 - YAML 文件缩进用的是 tab 而非空格，解析直接失败（YAML 规范要求空格缩进）
建议固定写法：
viper.SetConfigName("app")
viper.SetConfigType("yaml")
viper.AddConfigPath("configs/")
viper.AddConfigPath(".") // fallback to current dir
err := viper.ReadInConfig()
if err != nil {
log.Fatal("failed to read config:", err)
}
多环境配置怎么合并？用 MergeInConfig 而非 ReadInConfig
想实现 application.yaml（公共） + application-pro.yaml（生产）分层覆盖，不能对每个文件都调 ReadInConfig()——后者会清空已有配置。必须用 MergeInConfig()。
关键点：
- 先
ReadInConfig()加载基础配置（如application.yaml） - 再
MergeInConfig()加载环境专属配置（如application-pro.yaml），同名 key 会被覆盖 - 环境名建议通过命令行参数传入：
go run main.go -profile.active=pro，再用flag.StringVar捕获 - 不要手动拼接文件名后硬编码路径，用
fmt.Sprintf("./configs/application-%s.yaml", env)更安全
配置结构体怎么绑定？用 Unmarshal 而非 GetXxx
直接用 viper.GetString("server.port") 写死在代码里，类型不安全、难维护、IDE 无提示。应该定义 Go 结构体，再用 viper.Unmarshal() 一次性注入。
示例结构体：
type Config struct {
App AppConfig `mapstructure:"app"`
Server ServerConfig `mapstructure:"server"`
DB DBConfig `mapstructure:"database"`
}
type ServerConfig struct {
Port int `mapstructure:"port"`
ReadTimeout int `mapstructure:"read_timeout"`
WriteTimeout int `mapstructure:"write_timeout"`
}
绑定时注意：
- 字段必须首字母大写（可导出），否则
Unmarshal无法赋值 - 使用
mapstructuretag 显式指定 YAML 中的 key 名，避免大小写/下划线不一致问题 - 别在全局变量里存
*viper.Viper实例——它不是线程安全的，高并发下Get可能返回脏数据
真正容易被忽略的是：配置热更新（比如监听文件变化重载）对 Gin 路由和中间件完全无效。Gin 的路由树在 r.Run() 前就已固化，运行时改配置只影响后续新请求的 handler 逻辑，旧连接、中间件注册、监听端口都不会变。
