真正起作用的是环境配置分离、服务编排灵活性及启动参数控制；Docker Compose Profiles按需激活服务，环境变量动态注入配置，多文件叠加复用基础定义，外部配置挂载实现运行时适配。
靠容器状态本身无法实现一键部署与切换。真正起作用的是环境配置的分离、服务编排的灵活性，以及启动时的参数控制。容器运行状态（如running、exited）只是结果，不是驱动多环境切换的机制。
用 Docker Compose Profiles 按需激活服务
Profiles 是最轻量、最直接的环境分组方式。它不改变镜像，只决定哪些服务参与当前启动：
- 在
compose.yaml中为调试、监控、mock 数据库等非核心服务标注profiles: [dev]或profiles: [test] - 开发时执行
docker compose --profile dev up，自动拉起 API + 日志工具 + 本地 Redis - 生产环境默认不激活任何 profile，只运行
api和db这类无 profiles 字段的服务 - 支持组合激活，比如
--profile dev --profile debug同时加载两组辅助工具
靠环境变量动态注入配置
同一镜像在不同环境行为不同，关键在于运行时注入的变量：
- 把数据库地址、API密钥、调试开关等全部设为环境变量，不在镜像里写死
- 用
.env文件统一管理各环境值：ENV=prod、DB_HOST=pg-prod、DEBUG=false - Docker Compose 自动读取
.env并替换${VAR}占位符，无需改 YAML 文件 - 敏感信息可配合
docker compose --env-file prod.env up单独指定，避免混入开发配置
用多文件叠加复用基础定义
避免复制粘贴式维护，把通用部分和差异部分拆开：
-
docker-compose.base.yml定义镜像名、端口映射、网络、健康检查等共性项 -
docker-compose.dev.yml只覆盖挂载源码目录、开启热重载、暴露调试端口 -
docker-compose.prod.yml覆盖资源限制、重启策略、TLS 配置、日志轮转 - 启动命令明确指向组合：
docker compose -f base.yml -f prod.yml up -d
配合外部配置挂载实现运行时适配
有些配置无法靠环境变量表达（比如 Spring Boot 的完整 application.yml），适合挂载文件：
- 准备三套配置目录：
config/dev/、config/test/、config/prod/ - 在对应环境的 compose 片段中挂载：
volumes: ["./config/prod/application.yml:/app/config/application.yml"] - 镜像内程序统一读取固定路径，无需修改代码或重新构建
- 挂载方式比构建时 COPY 更灵活，换环境只需换挂载目标，不碰镜像层
