如何通过Docker Compose从本地文件向VS Code开发容器传递构建环境变量？

方案一：通过Docker Compose构建参数传递 #

直接在docker-compose.yml中通过Shell命令读取文件内容，将其作为构建参数传递给Dockerfile：

修改docker-compose.yml：

version: "3.9"

services:
  game:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        # 读取文件内容并移除换行符，避免环境变量包含无效字符
        - MY_VERSION=$(cat myVersion.txt | tr -d '\n')
    volumes:
      - ..:/home/node/game
    ports:
      - "3000:3000"

修改Dockerfile，用ARG接收构建参数并转为环境变量：

FROM node:20

WORKDIR /

# 接收构建阶段传递的参数
ARG MY_VERSION
# 将参数转为容器环境变量，后续命令可直接引用
ENV MY_VERSION=$MY_VERSION

RUN some_command --argument $MY_VERSION

方案二：通过VS Code Devcontainer配置传递构建参数 #

如果希望直接在Devcontainer配置中处理，修改devcontainer.json，让VS Code启动容器时读取本地文件内容并传递构建参数：

修改devcontainer.json：

{
  "dockerComposeFile": "./docker-compose.yml",
  "service": "game",
  "workspaceFolder": "/home/node/game",
  "remoteUser": "node",
  "build": {
    "args": {
      "MY_VERSION": "${localEnv:$(cat myVersion.txt | tr -d '\n')}"
    }
  }
}

此方案下，Dockerfile的修改与方案一完全一致，docker-compose.yml无需额外添加args（若已添加方案一的配置则二选一即可）。

关键注意事项 #

• 确保myVersion.txt的路径正确，需与执行Docker Compose命令的目录（或Devcontainer配置文件所在目录）相对应。
• 使用tr -d '\n'是为了移除文件中的换行符，避免环境变量包含无效字符导致后续命令执行异常。
• ARG仅在构建阶段有效，转为ENV后可让容器运行时也能访问该变量。

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