docker compose 的 override 机制通过自动加载 docker-compose.override.yml 并叠加于 docker-compose.yml 之上，实现开发环境隔离；它支持服务新增、端口映射、卷挂载、环境变量等高频调试配置的覆盖或追加，且无需 -f 参数，天然适配本地开发与 git 忽略需求。
docker compose 的 override 机制是实现开发环境隔离最直接、最常用的方式。它不依赖额外工具或脚本，靠文件加载顺序和合并规则就能让本地配置自动生效，同时不影响团队共享的基础配置。
docker-compose.override.yml 是默认生效的“本地补丁”
只要当前目录存在 docker-compose.override.yml，Docker Compose 会**自动加载它，并叠加在 docker-compose.yml 之上**，无需加 -f 参数。这个行为是内置约定，不是可选项。
- 它天然适配开发场景：每个开发者可自由修改自己的 override 文件，不影响他人
- Git 忽略该文件（
.gitignore中加一行docker-compose.override.yml），避免误提交本地路径或密钥 - 服务定义可以新增：比如基础文件里没数据库，你可以在 override 里加一个
mysql服务，它会被一起启动
覆盖哪些配置最实用
开发时高频覆盖的字段，基本都集中在调试便利性和本地适配上：
-
端口映射：把服务端口暴露到本地（如
ports: ["3000:3000"]），而基础文件中可能完全不写或只写内部端口 -
卷挂载（volumes）：用
./src:/app/src实现热重载；基础文件里通常用只读镜像或空卷 -
环境变量：启用调试模式（
DEBUG=1）、连接本地数据库（DB_HOST=host.docker.internal） -
command 或 entrypoint：覆盖默认启动命令，比如加
--watch或跳过健康检查 -
资源限制放开：删掉
mem_limit或cpus，让本地容器跑得更“自由”
覆盖规则要心里有数
不是所有字段都按“后写覆盖前写”简单处理，Docker Compose 有明确的合并逻辑：
- environment、ports、command：完全替换，后定义的值生效
- volumes、depends_on、networks：追加合并，基础文件 + override 文件的内容都会保留
- image、build、restart：直接覆盖，override 里的值彻底取代基础文件中的同名项
例如，基础文件定义了两个 volume：["/data", "/logs"]，override 里写 ["./config:/etc/app"]，最终容器会挂载三个路径。
进阶技巧：精准控制服务启停
有时你只想运行部分服务（比如只启前端，不启后台任务），可以在 override 中“哑化”不需要的服务：
- 把某个 service 的
image改成hello-world - 把
command设为["true"]或["sleep", "3600"] - 或者直接加
profiles: ["dev-only"]，再用--profile dev-only启动（需 Compose v2.20+）
这样既保持 docker-compose.yml 干净，又能让本地开发流程更轻量。
