核心是利用容器环境隔离能力，配合定制镜像、专属网络、限定目录挂载及独立docker-compose.yml管理，实现多项目完全隔离。
在 macos 上配置支持多项目隔离的 docker 开发环境，核心是利用容器天然的环境隔离能力，配合合理的镜像管理、网络划分和资源约束，避免项目间端口冲突、依赖干扰或文件污染。不需要额外虚拟机，docker desktop 已内置所需能力。
按项目定制独立镜像
每个项目应有专属 Dockerfile，不共用同一基础镜像标签（如都用 node:latest），防止隐性升级导致构建不一致。
- 在项目 A 根目录写 Dockerfile.a，指定固定版本：
FROM node:18.19-alpine，安装其特有 CLI 工具（如yarn或pnpm） - 在项目 B 根目录写 Dockerfile.b，用不同基础：
FROM node:20.12-slim，预装其需要的 Python 绑定或数据库客户端 - 构建时加项目前缀命名：
docker build -f Dockerfile.a -t proj-a/dev-env .和docker build -f Dockerfile.b -t proj-b/dev-env .
用自定义网络实现项目通信隔离
默认 bridge 网络所有容器互通，容易引发端口或服务名冲突。为每个项目创建专属网络，让其内部服务可发现，对外则完全隔离。
- 创建项目 A 网络：
docker network create proj-a-net - 启动容器时显式接入：
docker run --network proj-a-net --name api-server -p 3001:3000 proj-a/dev-env - 同网络下另一容器可直接用
api-server:3000访问，其他项目容器无法解析该主机名
挂载本地目录时限定作用域
避免多个容器挂载同一开发目录导致文件覆盖或权限混乱。推荐“单向只读 + 显式路径”策略：
- 代码源挂载设为只读：
-v $(pwd)/src:/app/src:ro，防止容器内误删或生成临时文件 - 构建产物单独映射输出目录：
-v $(pwd)/dist:/app/dist，不与源码混在同一层级 - 敏感配置通过
--env-file加载，而非挂载整个.env文件夹
用 docker-compose.yml 管理项目生命周期
每个项目配一个独立的 docker-compose.yml，声明完整服务栈（如前端+后端+DB），并统一控制启停与日志查看。
- 项目 A 的
docker-compose.yml中设置networks: { default: { name: proj-a-net } } - 运行
docker compose up -d自动创建网络、拉取镜像、启动全部服务 - 执行
docker compose logs -f api只看该项目 API 容器日志，不被其他项目干扰
