Go 不自动加载 .env 文件，需用 godotenv.Load() 显式加载且须在 os.Getenv 前调用；注意文件编码、格式、路径及环境变量优先级，推荐开发用 .env、生产用系统级变量，并封装结构体做类型安全配置解析。
Go 项目里读不到 .env 文件里的变量？
Go 标准库不自动加载 .env 文件，os.Getenv("XXX") 只能读系统级环境变量。如果你把配置写在 .env 里却没调用第三方库加载，它就只是个普通文本文件——不会生效。
常见错误现象：os.Getenv("DB_HOST") 返回空字符串，但你确认 .env 里写了 DB_HOST=localhost；或者本地运行正常，部署到 Docker 或 Kubernetes 后突然读不到值。
- 必须显式加载：用
godotenv.Load()或类似方式把.env内容注入进程环境 - 加载时机关键：要在任何调用
os.Getenv之前执行，通常放在main()开头 - 路径默认是当前工作目录下的
.env，不是源码目录；go run main.go时 pwd 决定加载位置
godotenv 加载失败的几种典型原因
最常用的是 github.com/joho/godotenv，但它对文件格式和加载上下文很敏感。
-
.env文件编码必须是 UTF-8 无 BOM，Windows 记事本另存时容易带 BOM，导致解析失败（静默跳过） - 变量名不能含空格或特殊字符：
API_KEY = abc123（等号前后有空格）会被忽略；正确写法是API_KEY=abc123 - 注释必须独占一行，
PORT=8080 # dev这种行尾注释不被支持 - 如果
godotenv.Load(".env.production")指定了文件但路径不对，会 panic；建议用godotenv.Overload()或捕获 error
err := godotenv.Load()
if err != nil {
log.Fatal("加载 .env 失败:", err)
}
区分开发/生产环境的变量来源优先级
别指望只靠一个 .env 覆盖所有场景。真实项目中，环境变量来源有明确优先级：
立即学习“go语言免费学习笔记（深入）”；
-
操作系统已设置的变量（如
export DEBUG=true）优先级最高 - 然后是
godotenv.Load()加载的.env（仅限开发） - Docker 的
-e、K8s 的envFrom属于系统级变量，会覆盖.env里的同名项
所以推荐做法：开发用 .env，上线禁用 godotenv，靠运维注入环境变量。避免把敏感配置硬编码进 Git。
结构化读取 + 类型转换比裸用 os.Getenv 更可靠
直接拼接字符串或手动转类型容易出错，比如 os.Getenv("PORT") 是 string，但你需要 int；os.Getenv("ENABLE_LOG") == "true" 容易漏大小写。
- 用
strconv.Atoi(os.Getenv("PORT"))做转换，但记得检查 error - 更稳妥的做法是封装一个配置结构体，配合
mapstructure或env库做绑定 - 示例中用
env库（github.com/caarlos0/env）自动映射字段并校验非空
type Config struct {
Port int `env:"PORT" envDefault:"8080"`
Database string `env:"DATABASE_URL" envRequired:"true"`
}
cfg := Config{}
err := env.Parse(&cfg)
复杂点在于：不同环境变量来源的生命周期不可控，.env 文件权限、加载顺序、大小写敏感性都可能成为线上故障点。别省那几行代码，加 error 检查和默认值兜底。