Multi-Project Creator
多工作区创建工具,帮助开发者在同一项目中基于不同的 Git 分支创建多个工作区,大大减少手动克隆新项目的时间。
功能特点
- 📦 支持工程模板管理,可快速选择已配置的工程
- 🔗 支持在同一工作区下克隆多个 Git 仓库
- 🌿 每个仓库支持独立的分支配置
- 💻 支持多种 IDE 自动打开(VSCode、Cursor、Qoder、Kiro、IDEA)
- 📝 实时执行日志显示
- 🎨 简洁美观的弹窗式界面
- ➕ 支持在已有需求工作区中追加新工程
- 📂 管理已有需求:基于文件系统扫描工作区,查看/追加工程(不依赖 Global State)
- 🔄 工程分支自动识别,支持远程分支下拉选择与手动刷新
更新日志
1.5.0
- 新建需求:Git 仓库列表每行通过工程模板下拉选择,选后自动加载远程分支下拉
- 移除「使用选中工程」按钮,避免只覆盖第一行的问题
1.4.0
- 新增「管理已有需求」模式:扫描工作区根目录、查看已有 Git 工程、追加新工程
- 工作区根目录默认填充当前 IDE 打开的工作区路径
- 修复工程分支识别(兼容 worktree、submodule)
- 选择工程后自动加载远程分支下拉列表
- 已有工程列表支持单条分支刷新
1.3.0
快捷键设置
插件支持快捷键快速访问,你可以根据个人习惯设置喜欢的快捷键。
设置方法
打开 VSCode/Cursor 的键盘快捷方式设置:
- Mac:
Cmd + Shift + P → 输入 "键盘快捷方式"
- Windows/Linux:
Ctrl + Shift + P → 输入 "键盘快捷方式"
搜索以下命令并设置快捷键:
- 创建工作区:
Multi-Project Creator: Create Project
- 查看项目列表:
Multi-Project Creator: List Projects
推荐快捷键(可自定义):
- Mac:
Cmd + Control + W(创建工作区)、Cmd + Control + L(查看列表)
- Windows/Linux:
Ctrl + Alt + W(创建工作区)、Ctrl + Alt + L(查看列表)
使用方法
1. 打开创建界面
- 通过命令面板输入「Multi-Project Creator: Create Project」或设置的快捷键
- 在 IDEA 等支持侧边栏图标的编辑器中点击「Multi-Project Creator」图标
2. 维护工程列表(可选)
点击「📦 工程列表」按钮打开工程管理弹窗:
- 添加工程:填写工程名称和 Git 地址,点击添加
- 编辑工程:点击编辑按钮修改信息,点击保存
- 删除工程:点击删除按钮移除工程
3. 填写工作区信息
需求名称:输入需求名称(仅支持英文、数字和下划线)
工作区路径:输入或点击「浏览...」选择本地工作目录
Git 仓库列表:
- 点击「+ 添加仓库」添加多行,每行独立配置
- 选择工程:从工程模板下拉选择(需先在「工程列表」中维护模板)
- 分支名:选择工程后自动加载远程分支列表,再从下拉选择
- 点击「删除」移除不需要的仓库行
目标 IDE:选择用于打开工作区的 IDE
4. 创建工作区
点击「创建工作区」按钮,插件会自动:
- 在工作区路径下创建以需求名称命名的文件夹
- 克隆所有配置的 Git 仓库
- 切换到指定分支(如不存在则新建)
- 使用选中的 IDE 打开工作区
5. 管理已有需求
切换到「管理已有需求」模式:
- 工作区根目录默认当前 IDE 工作区,可浏览或刷新扫描
- 从下拉框选择需求(工作区下一级子文件夹)
- 查看该需求下已有 Git 工程(仓库名、URL、当前分支)
- 在「添加新工程」选择工程模板,分支从远程分支列表下拉选择
- 点击「追加工程」克隆到该需求目录,或「在 IDE 中打开」
6. 查看项目列表
- 使用快捷键
Cmd + Control + L(Mac)或 Ctrl + Alt + L(Windows/Linux)
- 或在 IDEA 等编辑器的侧边栏点击「Multi-Project Creator」图标
在项目列表中可:
- 打开项目
- 刷新项目
- 删除项目(仅删除记录或同时删除文件)
清空表单
点击「清空表单」按钮可重置所有输入内容。
注意事项
- 请确保已正确安装 Git 并配置好环境变量
- 选择的 IDE 需已在本地安装
- 分支名要求符合 Git 分支命名规范
| |