Docker Compose使用env_file透传Shell变量失效，求正确配置语法

核心原因 #

你遇到的是Docker Compose版本迭代后的特性变更：

1. 旧版V1 docker-compose中，env_file里只写变量名不加值的写法，会默认从宿主机Shell拉取对应变量值传入容器，这个特性在后续版本出于安全考虑默认关闭
2. 服务级别的env_file默认不会解析文件内的$、${}占位符，只会将内容作为字面量传入容器，而直接写在docker-compose.yaml的environment字段的占位符是Compose自身完成变量替换的，所以可以生效

可行解决方案 #

方案1：开启env_file插值适配现有写法

适配你想保留公共env_file配置的需求，操作步骤如下：

1. 先在执行docker compose up的Shell环境中开启插值特性开关：

# WSL/Linux Shell执行
export COMPOSE_INTERPOLATE_ENV_FILE=true
# Windows PowerShell执行
$env:COMPOSE_INTERPOLATE_ENV_FILE = "true"

2. 调整你的./env/docker.development.env文件写法：

ASPNETCORE_ENVIRONMENT=Development
AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}

3. 确保要透传的变量已经在当前Shell环境中export后，再启动服务即可：

# WSL/Linux环境先执行变量导出
export AWS_ACCESS_KEY_ID=你的AK值
export AWS_SECRET_ACCESS_KEY=你的SK值
# 启动服务
docker compose up -d

方案2：公共扩展字段复用配置（兼容性更好）

如果不想依赖版本特性，可以用Compose的扩展字段定义公共环境变量组，所有服务直接引用，不需要重复编写：

version: "3.9"
# 定义公共环境变量扩展字段
x-common-env: &common-env
  ASPNETCORE_ENVIRONMENT: Development
  AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID}
  AWS_SECRET_ACCESS_KEY: ${AWS_SECRET_ACCESS_KEY}

services:
  daemon:
    image: my-image
    environment:
      # 引用公共变量
      <<: *common-env
      # 可追加服务独有变量
      SERVICE_SPECIFIC_VAR: xxx
  # 其他服务直接复用即可
  another-service:
    image: other-image
    environment:
      <<: *common-env

WSL环境注意事项 #

如果你在WSL子系统中执行docker命令，需注意：

• 变量必须在WSL的当前Shell中export，Windows系统环境变量默认不会自动传递到WSL Shell，除非你手动开启了WSL环境变量互通功能
• 不要混用Windows端和WSL端的Docker CLI，两边的环境变量是完全隔离的

内容的提问来源于stack exchange，提问作者dstj