docker compose是最直接、落地最快的本地多服务协同方案，通过docker-compose.yml定义服务拓扑，支持健康检查、自定义网络、卷挂载及vscode dev containers集成，实现“一键启动+开箱即用”。
用 Docker Compose 是最直接、落地最快的方式。它不依赖 Kubernetes 的复杂性，专为本地开发阶段的多服务协同而设计，能真正实现“一条命令启动全部服务”，且配置清晰、调试方便、团队协作友好。
写好 docker-compose.yml 描述整个服务拓扑
把后端集群里的每个组件（比如 API 服务、数据库、缓存、注册中心、网关）都定义为一个 service。关键点包括：
- 明确镜像来源：用官方镜像（如 mysql:8.0、redis:7-alpine）或本地构建（build: ./auth-service）
- 设置健康检查：让依赖关系真正可靠，例如 MySQL 加上 healthcheck，再让业务服务通过 depends_on: {mysql: condition: service_healthy} 等待就绪
- 统一网络：定义自定义 network（如 backend-net），所有服务加入其中，内部可通过服务名直接通信（redis、nacos）
- 挂载配置与数据：用 volumes 挂载 application.yml、SQL 初始化脚本、本地数据目录，便于调试和状态保留
用一条命令完成启动、等待与验证
执行 docker compose up -d 后，不需要手动 sleep 或轮询。配合健康检查和依赖条件，Compose 会自动按序拉起容器并等待基础服务就绪。你可以再加一层轻量封装：
- 写个 start.sh：先 docker compose down 清场，再 up -d，最后用 docker compose logs -f api 或 curl http://localhost:8080/actuator/health 快速确认主服务是否可用
- 对 Java 微服务，可预置 spring.profiles.active=docker，自动适配容器内数据库地址（如 jdbc:mysql://mysql:3306/appdb）
进阶：对接 VSCode Dev Containers 实现开箱即用
如果团队使用 VSCode，可在项目根目录建 .devcontainer/devcontainer.json，指向你的 docker-compose.yml：
{
"name": "Backend Cluster",
"dockerComposeFile": "docker-compose.yml",
"service": "api",
"workspaceFolder": "/workspace"
}
新成员只需点击 “Reopen in Container”，VSCode 就自动拉起整个后端集群，并把代码挂载进容器，终端、调试器、扩展全就位，无需装 JDK、MySQL 或 Redis。
替代方案对比：什么情况下考虑别的工具
不是所有场景都适合纯 Compose：
- 需要模拟真实 K8s 行为（如 Ingress、ConfigMap、HPA）→ 用 ksail：基于 K3s 预装了镜像仓库、Ingress 和 DNS，一条命令启一个轻量但完整的本地 K8s 环境
- 服务非容器化（比如本地运行的 Python 脚本、Java JAR、前端 dev server）→ 用 Station5：通过 YAML 描述任意命令行服务，支持混合启动容器与主机进程，更灵活
- 已有 Vagrant 或 CoreOS Kubernetes 经验，想快速复用 → 可走 CoreOS Kubernetes + Vagrant 单节点方案，但启动慢、资源占用高，日常开发不如 Compose 轻快
