Docker Compose文件能否定义内部变量统一环境变量默认值？

问题背景 #

现有Docker Compose配置中，两处环境变量默认值硬编码为SOME_DB_NAME，存在修改时容易遗漏一处导致配置不一致的风险：

services:
  backend:
    environment:
      DB_NAME: ${DB_NAME:-SOME_DB_NAME}

  postgres:
    image: postgres:
    environment:
      POSTGRES_DB: ${DB_NAME:-SOME_DB_NAME}

想要在同一文件内定义一个统一的内部变量来管理默认值，类似自定义vars块的写法，但Docker Compose原生不支持该语法，需要替代方案。

可行解决方案 #

1. 用Compose扩展字段 + YAML锚点统一管理 #

Docker Compose支持以x-开头的扩展字段（自定义元数据字段），结合YAML的锚点特性，可以在同一文件内定义全局默认值并复用：

# 全局统一默认值，修改这里即可同步所有引用处
x-global-defaults:
  &default-db-name SOME_DB_NAME

services:
  backend:
    environment:
      DB_NAME: ${DB_NAME:-*default-db-name}

  postgres:
    image: postgres:latest
    environment:
      POSTGRES_DB: ${DB_NAME:-*default-db-name}

• 扩展字段x-global-defaults不会被Compose解析为服务配置，仅作为自定义配置块使用
• 修改默认值时只需更新&default-db-name后的内容，所有引用该锚点的地方会自动同步

2. 定义环境变量配置块复用 #

如果需要管理多个默认值，可以把它们集中在一个自定义块中，通过锚点单独引用：

# 集中管理所有默认环境变量
x-env-defaults:
  db:
    name: &db-default-name SOME_DB_NAME
    port: &db-default-port 5432

services:
  backend:
    environment:
      DB_NAME: ${DB_NAME:-*db-default-name}
      DB_PORT: ${DB_PORT:-*db-default-port}

  postgres:
    image: postgres:latest
    environment:
      POSTGRES_DB: ${DB_NAME:-*db-default-name}
    ports:
      - "${DB_PORT:-*db-default-port}:5432"

这种方式结构更清晰，适合后续扩展更多统一配置项。

3. （可选）使用.env外部文件 #

如果允许使用外部文件，也可以在项目根目录创建.env文件定义统一默认值：

DEFAULT_DB_NAME=SOME_DB_NAME

然后在Compose文件中嵌套引用：

services:
  backend:
    environment:
      DB_NAME: ${DB_NAME:-${DEFAULT_DB_NAME}}

  postgres:
    image: postgres:latest
    environment:
      POSTGRES_DB: ${DB_NAME:-${DEFAULT_DB_NAME}}

注意：此方法需要维护外部.env文件，不符合“同一文件”的需求，但也是行业内常用的统一配置方式。

内容的提问来源于stack exchange，提问作者Işık Kaplan