首页/云/Docker 容器速查/项目级 .env 文件与变量来源优先级
Compose 编排55 条

项目级 .env 文件与变量来源优先级

项目目录下的 .env 供 Compose 文件做变量插值:宿主环境变量优先于 .env,可用 --env-file 指定其他文件。

Docker 容器速查云更新于 2026-10-12
用途Compose 插值变量来源
默认位置项目目录下 .env
优先级shell 环境 > .env;--env-file 可换文件

示例

示例
# .env 内容示例
TAG=1.4.2
# compose 文件里引用
docker compose --env-file .env.prod config | head -20
TAG=1.4.3 docker compose config --services
.env 变量不会自动进入容器:要传给容器需在 environment 或 env_file 中引用。

易错点

  • 在别的目录执行 compose 命令读不到项目 .env,注意项目目录定位或显式 --env-file
  • 把 .env 与 env_file 混用后排查变量来源困难,先 config 输出看最终值

数据来源与参考

  • Docker 官方文档:Compose 环境变量与 .env(docs.docker.com/compose/environment-variables)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌