Go 不自动加载 .env 文件，必须显式调用 godotenv.Load()（推荐 github.com/joho/godotenv），且需在 main() 开头尽早执行，早于任何依赖环境变量的初始化逻辑。
Go 程序启动时读不到 .env 文件里的变量？
Go 本身不自动加载 .env 文件，所有环境变量必须显式调用第三方库（如 godotenv.Load()）或系统级注入。常见错误是以为把 .env 放在项目根目录就能“自动生效”——实际连 os.Getenv("DB_URL") 都会返回空字符串。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须手动调用
godotenv.Load()（推荐github.com/joho/godotenv），且要在main()开头尽早执行，早于任何依赖环境变量的初始化逻辑 - 如果
.env不在当前工作目录，需传入绝对路径：godotenv.Load("/path/to/.env") - 开发中常误用
go run main.go启动——此时工作目录是main.go所在目录，但 IDE 或构建脚本可能切换了工作目录，导致.env加载失败 -
godotenv.Load()默认只加载一次；多次调用不会覆盖已存在的环境变量（已有值优先），这点和os.Setenv行为不同
多个环境共存时怎么隔离 .env.development 和 .env.production？
Go 没有内置环境模式，godotenv 也不自动识别后缀。所谓“多环境文件”，全靠你手动指定加载哪个文件，否则默认只认 .env。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Getenv("ENV")或命令行 flag 判断当前环境，再决定加载哪个文件：godotenv.Load(".env." + env) - 不要依赖
.env.local这类“隐式覆盖”机制——godotenv不支持自动合并，得自己写逻辑：godotenv.Load(".env"); godotenv.Load(".env.local") - 生产环境禁止加载
.env文件：打包进 Docker 镜像前应删掉或忽略它，改用容器运行时注入（docker run -e DB_URL=...） - 注意文件权限：Linux/macOS 下若
.env是 600，godotenv.Load()仍能读，但某些 CI 环境会因 umask 限制报错permission denied
godotenv 和 os.Setenv 混用导致变量值不一致？
这是最隐蔽的坑：godotenv.Load() 内部调用的是 os.Setenv，但它不会覆盖进程已有的环境变量（除非你传 overload: true）。而很多 Go 库（比如 database/sql 的连接池）在 init() 阶段就缓存了 os.Getenv 结果，后续再 Setenv 也无效。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 务必在
import语句之后、任何其他包初始化之前调用godotenv.Load()——最好放在main()第一行 - 避免在
init()函数里读取环境变量；如果必须，确保godotenv.Load()在该包被 import 前完成（可通过主包控制导入顺序） - 调试时用
fmt.Printf("DB_URL=%q\n", os.Getenv("DB_URL"))直接验证，别只信配置结构体字段值 - 若要强制覆盖已有变量，用
godotenv.Overload()替代Load()，但它会污染全局环境，测试中容易串扰
Docker 构建阶段加载 .env 文件为什么总失败？
Docker 的 ENV 指令和 .env 文件是两回事：ENV 是镜像元数据，.env 是运行时文件。很多开发者误以为 COPY .env 进镜像，Go 程序就能自动读到——其实只是文件存在，没触发加载逻辑。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Dockerfile 中不要 COPY
.env到生产镜像里，尤其含敏感信息；应通过docker run --env-file或 KubernetesenvFrom注入 - 如果非要用
.env文件（比如本地 docker-compose 测试），确保 ENTRYPOINT 脚本先执行godotenv load再启动 Go 二进制，而不是指望 Go 程序自己加载 - Go 编译产物是静态二进制，
godotenv读取的是容器内运行时的文件系统路径，不是构建机上的路径；COPY 后路径要和代码里写的加载路径严格一致 - Alpine 镜像默认无
/bin/sh，若用 shell 形式 ENTRYPOINT，godotenv的 shebang 可能失效，建议用 exec 形式并显式调用 Go 程序
真正麻烦的从来不是“怎么加载”，而是“谁在什么时候、以什么顺序、从哪一层上下文里读到了哪个值”。变量来源一多，os.Getenv 返回的到底是谁设的，往往要翻三遍日志才敢确定。
