应封装环境变量读取为结构体并集中初始化，避免裸用os.Getenv；推荐用caarlos0/env库自动处理默认值、类型转换与校验；配置字段须导出且带env tag；敏感字段禁用default，改用required:"true"；.env文件加载需注意覆盖逻辑与时机；纯环境变量场景勿引入viper。
用 os.Getenv 读环境变量是最直接但最易出错的方式
很多新手直接在代码里写 os.Getenv("DB_HOST")，看似简单，但会立刻遇到三个问题：值为空时没默认、类型要手动转换、测试时难 mock。更麻烦的是，一旦多个地方重复调用，改一个变量名就得全局搜。
推荐做法是集中初始化配置结构体，并在启动时做校验：
type Config struct {
DBHost string `env:"DB_HOST" default:"localhost"`
DBPort int `env:"DB_PORT" default:"5432"`
}
func LoadConfig() (*Config, error) {
cfg := &Config{}
if err := env.Parse(cfg); // 用 github.com/caarlos0/env 库
return nil, err
}
return cfg, nil
}
- 避免裸用
os.Getenv，哪怕只读一次也建议封装进结构体 -
env.Parse自动处理空值 fallback、类型转换、必填字段校验（加required:"true"tag） - 测试时可直接传入 map 构造环境，不用改系统环境变量
不同环境用不同 .env 文件 + godotenv 加载时注意加载顺序
开发用 .env，测试用 .env.test，线上靠容器注入——这没问题，但很多人忽略加载时机和覆盖逻辑。比如 godotenv.Load(".env.test") 不会自动覆盖已存在的环境变量，而 godotenv.Overload 才会。
- 开发阶段：先
godotenv.Load(".env.local")（本地覆盖），再godotenv.Load(".env")（基础） - CI/CD 流水线中禁用
.env*加载，强制走真实环境变量，避免误提交敏感值 - 不要在
init()里调用Load，否则单元测试无法控制加载时机
viper 看似强大，但在纯 Go 项目里常因热重载和多格式混用翻车
viper 支持 YAML/JSON/TOML + 环境变量 + flag，听起来完美，但实际项目中容易踩两个坑：一是它默认开启远程配置监听（etcd/consul），不关会静默失败；二是当同时启用 viper.AutomaticEnv() 和 viper.SetEnvPrefix() 时，环境变量名会多一层前缀，导致读不到。
立即学习“go语言免费学习笔记（深入）”；
- 如果只用环境变量，别引入
viper，它带来的抽象成本远高于收益 - 真要用，必须显式关闭不需要的功能：
viper.DisableRemoteConfig()、viper.SetConfigType("yaml") - 环境变量 key 映射规则要写清楚，例如
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))才能匹配server.port→SERVICE_PORT
配置结构体必须导出字段且带 env tag，否则 env.Parse 读不到
Go 的反射只能访问导出字段（首字母大写），而 env 库依赖 struct tag 解析映射关系。常见错误是写成小写字段或漏掉 tag，结果运行时全为零值，又没报错，极难排查。
type Config struct {
dbHost string `env:"DB_HOST"` // ❌ 小写字段，反射不可见
DBHost string `env:"DB_HOST"` // ✅ 正确
DBPort int `env:"DB_PORT" default:"5432"`
}
- 所有配置字段必须首字母大写，且明确指定
envtag - 不要依赖字段名自动转大写下划线（如
dbHost→DB_HOST），env库不支持这种约定式推导 - 敏感字段（如密码）不要设
default，而是用required:"true"强制外部提供
