extends支持服务模板复用，通过base.yml定义共性配置，子服务继承并局部覆盖；配合-f多文件加载实现环境分层，但不支持递归继承且需统一版本。
用 extends 可以把通用配置抽成“模板服务”，让多个服务复用同一套基础定义，避免重复写镜像、环境变量、卷挂载等字段。核心是“一次定义，多处继承”，不是复制粘贴。
提取基础服务为可继承模板
在单独文件（如 base.yml）中定义一个干净的服务模板，只包含共性配置：
- 使用标准镜像、默认端口、统一日志路径和基础环境变量
- 不写
ports或仅写开发常用端口，留出覆盖空间 - 避免在模板里设
container_name或depends_on等强绑定字段
示例：base.yml
base.app:
image: node:18-alpine
environment:
- NODE_ENV=production
volumes:
- ./logs:/app/logs
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
按需继承并局部覆盖
在项目主文件中用 extends 引入模板，再叠加差异化配置：
-
file指向模板文件路径，service指定要继承的服务名 - 同名标量字段（如
image、environment）会被子服务完全替换 - 列表字段（如
volumes、ports）会合并，不是覆盖
示例：docker-compose.yml
services:
api:
extends:
file: base.yml
service: base.app
ports:
- "3000:3000"
environment:
- API_ENV=staging
worker:
extends:
file: base.yml
service: base.app
command: npm run worker
environment:
- WORKER_CONCURRENCY=4
配合 override 文件做环境分层
当开发、测试、生产差异较大时，不建议全靠 extends 覆盖，而应结合 -f 多文件加载：
- 保持
docker-compose.yml为通用结构，只含extends和最小必要字段 - 用
docker-compose.prod.yml单独定义生产级资源限制、日志驱动、网络策略 - 启动命令变为：
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up
这样既保留 extends 的服务级复用，又用 override 实现环境级定制，逻辑更清晰。
注意避坑点
extends 功能强大但有边界，用错反而增加维护成本：
- 不支持递归继承：被继承的服务自身不能再用
extends - 不能跨版本混用：Compose v2+ 已弃用部分旧语法，确保所有文件都用
version: '3.8'或更高 - 慎用深度覆盖：如果 80% 字段都要重写，说明模板抽象失败，应回头重构基础服务定义
