.env仅限本地开发，生产环境必须禁用，因其通过os.Setenv注入变量且无校验加密，易致密钥泄露或覆盖K8s/Docker注入的正式配置，且加载时机不当会导致os.Getenv返回空值。
Go 项目里 .env 文件只该出现在本地开发阶段，生产环境必须禁用；它不是配置中心，只是 godotenv.Load() 启动时的一次性环境变量注入工具，用错位置或时机就会导致 os.Getenv("DB_URL") 始终为空。
为什么 .env 在生产环境必须禁用
godotenv 库会把 .env 中的键值对调用 os.Setenv() 注入进程，但它不校验、不加密、不隔离——一旦镜像打包进 Docker，.env 文件若未被 .gitignore 排除，密钥就直接泄露；即使排除了，运行时加载仍可能覆盖 K8s Secret 或 docker run -e 注入的正式值。
- CI/CD 流水线中禁止执行
godotenv.Load()，应通过环境变量或挂载方式注入配置 - Dockerfile 中不要
COPY .env .，也不要在ENTRYPOINT前调用该函数 - 本地开发可保留
.env，但需确保GO_ENV != "production"时才加载 -
.env文件权限建议设为600，防止误读；同时必须加入.gitignore
godotenv.Load() 必须放在 main() 最开头
很多项目把 godotenv.Load() 放在 config 初始化函数里，甚至包级 init() 中，结果是 database/sql 或日志库已在 import 阶段缓存了空的 os.Getenv() 结果，后续再加载也无效。
- 必须在
func main()第一行调用，早于任何其他包初始化逻辑 - 要检查错误：
if err := godotenv.Load(); err != nil { log.Fatal(err) } - 若
.env不在当前工作目录（比如用go run cmd/server/main.go），需传绝对路径：godotenv.Load("/abs/path/to/.env") - 支持多文件按顺序加载：
godotenv.Load(".env.shared", ".env.local")，后加载的同名变量会覆盖前者
如何让 .env 和 Viper 协同工作又不冲突
Viper 默认启用 viper.AutomaticEnv()，会把所有环境变量（包括 HOME、PWD）都当配置项映射，极易造成命名污染。而 godotenv.Load() 加载的变量又没加前缀，和 Viper 的 BindEnv 易重复绑定。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
立即学习“go语言免费学习笔记（深入）”；
- 关闭自动映射：
viper.AutomaticEnv()→ 删除，改用显式绑定 - 统一加前缀避免冲突：
viper.SetEnvPrefix("APP")，这样APP_DB_URL才对应db.url - 手动绑定关键字段：
viper.BindEnv("db.url", "DB_URL")，而不是依赖变量名自动推导 - 加载顺序要明确：先
godotenv.Load()注入基础变量，再初始化 Viper 并绑定，最后viper.ReadInConfig()读 YAML 等后备配置
别指望 .env 自动处理嵌套或类型转换
.env 是纯文本键值对，PORT=3000 还是字符串，ENABLE_LOG=true 也不会转成布尔值。Viper 的 Unmarshal 或结构体 tag 能做类型转换，但前提是字段已通过 BindEnv 或配置文件正确注入。
- 结构体字段必须首字母大写（导出），且带
mapstructure:"db_url"tag 才能被 Viper 绑定 - 不要用
viper.GetString("port")再手动strconv.Atoi，应定义Port int `mapstructure:"port"`后统一viper.Unmarshal(&cfg) - 敏感字段（如密码、密钥）建议跳过
.env，直接由运维通过环境变量注入，Viper 只从os.Getenv()读，不走文件 fallback -
.env中不支持变量引用（如DB_URL=postgres://$DB_USER@localhost），要用godotenv.Expand()手动展开，或换用更重的库
真正容易被忽略的是：.env 文件的加载时机和作用域是进程级的，一旦被其他 goroutine 或 init 函数提前读取，就无法回滚；所以它只能是“启动时一次性垫脚石”，不能当作运行时配置源。
