Project Manager 插件可实现 VSCode 中多项目一键切换:安装后保存当前工作区为命名项目,通过命令面板或自定义快捷键(如 Cmd+Alt+P)快速打开;支持手动编辑 projects.json 进行分组、路径修正等批量管理。

如果您在使用 VSCode 进行多项目开发时频繁手动打开文件夹或工作区,Project Manager 插件可帮助您一键加载已保存的项目配置。以下是利用该插件实现快速项目切换的操作说明:
本文运行环境:MacBook Air M2,macOS Sequoia。
一、安装并启用 Project Manager 插件
Project Manager 是一个开源 VSCode 扩展,它通过读取本地 JSON 配置文件来管理多个工作区入口,无需重复配置路径即可直接启动指定项目。
1、打开 VSCode,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在搜索框中输入 Project Manager,找到作者为 alefragnani 的插件。
3、点击“安装”按钮,安装完成后点击“重新加载”使插件生效。
二、添加当前工作区到项目列表
插件默认不会自动收录打开过的文件夹,需手动将当前打开的工作区保存为命名项目,以便后续快速调用。
1、确保当前已打开一个文件夹或工作区(例如包含 package.json 的前端项目)。
2、按下 Cmd + Shift + P(Mac)或 Ctrl + Shift + P(Windows/Linux)打开命令面板。
3、输入并选择 Project Manager: Save Project。
4、在弹出的输入框中为该项目输入唯一名称,如 my-react-app,按回车确认。
三、通过命令面板快速切换项目
保存项目后,所有已注册项目均纳入全局索引,可通过模糊搜索即时定位并打开,避免手动浏览文件系统。
1、按下 Cmd + Shift + P(Mac)或 Ctrl + Shift + P(Windows/Linux)打开命令面板。
2、输入 Project Manager: List Projects 并回车。
3、在下拉列表中键入项目名关键词(如 react),匹配项将高亮显示。
4、使用方向键选中目标项目,按回车即可在新窗口中打开该工作区。
四、使用快捷键直接唤出项目菜单
为提升操作效率,可为项目列表绑定自定义快捷键,跳过命令面板输入步骤,实现单次按键触发项目选择界面。
1、按下 Cmd + Shift + P(Mac)或 Ctrl + Shift + P(Windows/Linux),输入 Preferences: Open Keyboard Shortcuts (JSON)。
2、在打开的 keybindings.json 文件中插入以下配置:
{"key": "cmd+alt+p", "command": "project-manager.listProjects"}
3、保存文件,之后按下 Cmd + Alt + P 即可直接唤出项目选择菜单。
五、手动编辑项目配置文件以批量管理
Project Manager 将所有项目信息存储于用户级 JSON 文件中,支持直接编辑实现分组、路径修正或批量导入导出,适用于项目结构迁移或团队共享场景。
1、执行命令 Project Manager: Edit Projects File,VSCode 将自动打开 projects.json。
2、每个项目以对象形式存在,包含 name、rootPath 和可选的 group 字段。
3、如需为项目添加分组,在对应项目对象中加入 "group": "Frontend" 字段。
4、修改完成后保存文件,插件将立即识别变更,分组项目将在列表中按标题归类显示。










