Docker Compose通过YAML锚点复用公共卷配置消除重复定义

你之前两次配置报错的核心原因：

• 变体1中- *default-volumes的写法，是将整个公共卷数组作为volumes列表下的单个子元素插入，相当于传入了一个数组类型的卷配置，不符合Compose对卷条目必须为字符串/对象的校验规则，因此触发类型错误。
• 变体2中直接在块级序列里裸写数组别名后追加同级元素，不符合YAML块语法解析规则，因此触发解析错误。

不需要退回到单条卷逐一定义锚点的写法，以下两种方案都可以实现整组卷数组的直接复用：

方案1：扩展字段+YAML序列合并（最简洁，推荐Compose v2.20+版本使用） #

不需要额外定义服务继承链，直接通过扩展字段锚定公共卷数组，需要追加自定义卷时用合并键展开数组即可，无冗余配置。
示例配置：

# 顶层定义公共卷数组并打锚点
x-common-volumes: &common-volumes
  - /etc/localtime:/etc/localtime:ro
  - /etc/timezone:/etc/timezone:ro

services:
  service1:
    image: nginx:alpine
    restart: always
    networks: [default]
    # 不需要自定义卷的服务直接引用整个数组
    volumes: *common-volumes

  service2:
    image: node:20-alpine
    restart: always
    networks: [default]
    volumes:
      # 用合并键展开公共卷数组，不会将数组作为单个条目
      - <<: *common-volumes
      # 直接追加自定义卷即可
      - ./app:/app
      - app_data:/data

volumes:
  app_data:

方案2：extends服务继承（全版本兼容，支持Compose v2所有正式版本） #

如果使用的Compose版本较低，可利用Compose原生的服务继承能力，数组类配置字段默认会执行追加合并，不会覆盖父服务的原有配置，不需要依赖YAML高级语法。
示例配置：

# 定义公共基础服务模板，可加hidden profile避免被误启动
services:
  base-service:
    image: node:20-alpine
    restart: always
    networks: [default]
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
    profiles: ["hidden"]

  service1:
    # 直接继承基础服务所有配置
    extends:
      service: base-service

  service2:
    extends:
      service: base-service
    # 直接写自定义卷即可，Compose会自动合并父服务的公共卷
    volumes:
      - ./app:/app
      - app_data:/data

volumes:
  app_data:

补充说明：如果继承后需要移除某条公共卷，在对应卷条目后加!reset标签即可，例如要移除/etc/timezone挂载：

service3:
  extends:
    service: base-service
  volumes:
    - /etc/timezone:/etc/timezone:ro!reset
    - ./custom.conf:/etc/config.conf

两种方案都可以实现整组公共卷的一次定义、多处复用，维护成本远低于单条卷逐一定义锚点的写法。

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