Project Group Manager
一个强大的 VS Code 扩展，用于批量管理和批量打开项目，支持本地项目、Dev Container、SSH Remote、WSL 等多种项目类型，让你轻松管理大量项目
✨ 功能特性
- 📦 自动载入项目：自动扫描 Project Manager 的配置文件，无需手动导入
- ✅ 可视化选择：在树形视图中勾选/取消勾选项目，直观便捷
- 📁 分组管理：将常用项目保存为命名组，一键打开整个项目组
- 🚀 批量打开：支持批量打开多个项目，可配置延迟避免系统卡顿
- 🔍 快速搜索：快速搜索和定位项目
- 🎯 多种视图模式：支持平铺、按类型分组、按路径分组、按选中状态分组等多种显示模式
- 🌐 多环境支持：支持本地项目、Dev Container、SSH Remote、WSL 等多种项目类型
- ⚙️ 灵活配置：可自定义打开延迟、批次大小等参数
- 🎨 权重排序：为项目组设置权重，按优先级排序
📦 安装
从 VS Code Marketplace 安装
- 打开 VS Code
- 按
Cmd+Shift+X (macOS) 或 Ctrl+Shift+X (Windows/Linux) 打开扩展面板
- 搜索 "Project Group Manager"
- 点击安装
从 VSIX 文件安装
- 下载
.vsix 文件
- 打开 VS Code
- 按
Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows/Linux)
- 输入 "Install from VSIX"
- 选择下载的
.vsix 文件
🚀 使用方法
基础使用
查看项目列表
- 点击侧边栏的 Project Groups 图标
- 在"项目列表"视图中查看所有项目
选择项目
保存为组
- 勾选需要的项目后，点击工具栏的"保存为组"按钮
- 输入组名称
- 组会出现在"组合列表"视图中
打开项目组
- 方式一：在"组合列表"中右键点击组，选择"打开组"
- 方式二：点击"组合列表"工具栏的"显示所有组合列表"按钮（或使用快捷键
Cmd+Ctrl+G），在弹出的列表中选择要打开的组
- 所有项目会按配置的延迟依次打开
高级功能
视图模式切换
点击"项目列表"工具栏的"显示模式"按钮，可以选择：
- 平铺展示：所有项目平铺显示
- 按类型分组：按项目类型（本地、Dev Container、SSH、WSL）分组
- 按路径分组：按项目路径分组
- 按选中状态分组：将已选中和未选中的项目分开显示
项目操作
在项目上右键可以：
- 打开项目：在新窗口打开单个项目
- 重命名：修改项目显示名称
- 添加到组合：将项目添加到已有的组
- 删除：从列表中删除项目
组合操作
在组合上右键可以：
- 打开组：批量打开组内所有项目
- 重命名：修改组名称
- 复制：复制组（创建副本）
- 设置权重分：设置组的优先级（权重越高越靠前）
- 删除组：删除该组
快速搜索
- 搜索项目：点击"项目列表"工具栏的搜索按钮，输入关键词快速定位项目
- 显示组合列表：点击"组合列表"工具栏的列表按钮（或使用快捷键
Cmd+Ctrl+G / Ctrl+Alt+G），快速查看和打开所有组合
🎹 快捷键
Cmd+Ctrl+G (macOS) / Ctrl+Alt+G (Windows/Linux)：显示所有组合列表
⚙️ 配置选项
在 VS Code 设置中搜索 "Project Group Manager" 或直接编辑 settings.json：
{
// 每个项目打开之间的延迟（毫秒）
"projectGroups.openDelay": 2000,
// 每批打开的项目数量
"projectGroups.batchSize": 3,
// 批次之间的延迟（毫秒）
"projectGroups.batchDelay": 10000,
// Project Manager 配置文件的自定义路径（留空自动检测）
"projectGroups.projectManagerPath": "",
// 组合配置文件的自定义路径（留空使用默认位置，所有 Profile 共享）
"projectGroups.groupsConfigPath": "",
// 显示操作完成通知
"projectGroups.showNotifications": true,
// 启动时自动刷新项目列表
"projectGroups.autoRefreshOnStartup": true
}
配置说明
- openDelay：控制每个项目打开的间隔时间，避免同时打开太多窗口导致系统卡顿
- batchSize：每批打开的项目数量，建议设置为 3-5 个
- batchDelay：批次之间的延迟，给系统足够的时间处理已打开的项目
- projectManagerPath：如果 Project Manager 配置文件不在默认位置，可以手动指定路径
- groupsConfigPath：组合配置文件的自定义路径。默认情况下，组合数据存储在
~/Library/Application Support/Code/User/globalStorage/guabutian.project-group-manager/groups.json（macOS），所有 Profile 共享同一份配置
- showNotifications：是否显示操作完成的通知消息
- autoRefreshOnStartup：启动 VS Code 时是否自动刷新项目列表
💾 数据存储
项目列表
项目列表数据来自 Project Manager 扩展的配置文件，所有 Profile 共享同一份数据。
组合列表
组合列表数据存储在文件系统中，所有 Profile 共享同一份配置：
- macOS:
~/Library/Application Support/Code/User/globalStorage/guabutian.project-group-manager/groups.json
- Windows:
%APPDATA%\Code\User\globalStorage\guabutian.project-group-manager\groups.json
- Linux:
~/.config/Code/User/globalStorage/guabutian.project-group-manager/groups.json
这意味着：
- ✅ 在不同的 Profile 中可以看到相同的组合列表
- ✅ 切换 Profile 不会丢失组合数据
- ✅ 可以手动编辑配置文件（点击"组合列表"工具栏的"编辑组合配置文件"按钮）
数据迁移
如果你之前使用的是旧版本（组合数据存储在 Profile 的 globalState 中），插件会在首次启动时自动将数据迁移到新的存储位置。
📋 依赖要求
必需依赖
系统要求
- VS Code 版本：1.80.0 或更高
- 操作系统：目前仅支持 macOS（Windows 和 Linux 支持即将推出）
🎯 使用场景
场景 1：微服务开发
如果你在开发微服务项目，需要同时打开多个服务：
- 在 Project Manager 中添加所有微服务项目
- 在 Project Group Manager 中勾选需要的服务
- 保存为"微服务-开发环境"组
- 下次开发时，一键打开整个项目组
场景 2：前后端分离项目
将前端、后端、管理后台等项目保存为一个组，快速启动整个开发环境。
场景 3：多客户端项目
如果你维护多个客户的项目，可以为每个客户创建一个项目组，快速切换工作环境。
场景 4：Dev Container 开发
批量打开多个 Dev Container 项目，自动启动容器环境。
🔧 故障排除
项目列表为空
- 确保已安装 Project Manager 扩展
- 在 Project Manager 中至少添加一个项目
- 点击刷新按钮重新加载项目列表
- 检查配置中的
projectManagerPath 是否正确
项目打开失败
- 检查项目路径是否存在
- 对于 Dev Container 项目，确保 Docker 正在运行
- 对于 SSH 项目，确保 SSH 配置正确
- 查看 VS Code 输出面板的错误信息
打开速度慢
- 减少
batchSize 的值
- 增加
openDelay 和 batchDelay 的值
- 关闭不必要的扩展以提高性能
📝 更新日志
查看 CHANGELOG.md 了解版本更新历史。
🤝 贡献
欢迎提交 Issue 和 Pull Request！
📄 许可证
MIT License
🔗 相关链接
享受高效的项目管理体验！ 🎉
