为不同分支创建独立开发环境需从容器、虚拟机、解释器、编辑器等多层面隔离；通过 git worktree 建立独立工作目录，配合专属 venv 或 docker compose（显式设 compose_project_name）、vs code profile 绑定及自动化清理脚本实现完整分支级隔离。

为不同分支创建独立开发环境，核心是让每个分支拥有互不干扰的运行时、依赖、配置和状态。这不是简单地切换 git 分支，而是从容器、虚拟机、解释器、编辑器配置等多个层面做物理或逻辑隔离。

用 Git Worktree + 独立环境启动脚本

Git Worktree 允许你在同一仓库中为不同分支维护多个工作目录，避免频繁 checkout 导致的文件覆盖或构建缓存污染。

• 为 feature/login 创建独立工作目录：git worktree add ../myapp-login feature/login
• 在该目录下初始化专属环境：运行 python -m venv .venv 或 docker-compose --project-name myapp-login up -d
• 配合 .env 文件注入分支标识，如 BRANCH_NAME=feature/login，供应用读取或日志标记

基于 Docker Compose 的分支级项目隔离

Docker Compose 默认以目录名作为项目前缀，但更可靠的方式是显式指定 COMPOSE_PROJECT_NAME，确保网络、卷、容器名完全独立。

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• 启动分支环境时加环境变量：COMPOSE_PROJECT_NAME=myapp-feature-auth docker-compose up -d
• 在 docker-compose.yml 中引用：networks: app-net: name: ${COMPOSE_PROJECT_NAME:-default}-net
• 数据库卷也应绑定到项目名路径，例如 ./data-${COMPOSE_PROJECT_NAME}:/var/lib/postgresql/data

VS Code Profile 绑定分支工作区

VS Code 的 Profile 支持按文件夹绑定，而 Worktree 创建的目录天然就是独立路径，可直接关联专属 Profile。

• 在 ../myapp-login 目录中打开 VS Code，执行 Profile: Create Profile，命名为 login-dev
• 勾选 “Associate with a folder”，并选择该目录
• 安装仅用于此分支的扩展（如特定调试器、格式化插件），设置专属 launch.json 和 tasks.json
• 下次打开该路径，VS Code 自动加载对应 Profile，无需手动切换

自动化清理与状态管理

分支环境不应长期驻留，尤其在 CI/CD 或本地快速验证场景中，需配套清理机制。

• 编写 teardown.sh：停止容器、删除 .venv、清除临时卷
• 利用 git worktree remove 删除工作目录时，自动触发清理钩子（通过 shell alias 或 Makefile 封装）
• 在 IDE 启动任务中加入健康检查，比如确认数据库端口未被占用、.env 文件存在且非空