Project Manager 扩展可高效管理多项目:安装后保存工作区为命名项目,支持命令面板模糊搜索或侧边栏点击切换,并允许手动编辑 projects.json 进行批量配置。

如果您在使用 VSCode 进行多项目开发时频繁手动打开文件夹或工作区,效率明显下降,则可能是由于缺乏对项目集合的集中管理。Project Manager 扩展专为解决此问题而设计,它允许您将常用工作区保存为命名项目,并通过快捷方式一键切换。
本文运行环境:MacBook Air,macOS Sequoia。
一、安装并启用 Project Manager 扩展
Project Manager 是一个由 alefragnani 开发的开源扩展,需先在 VSCode 扩展市场中安装并激活,才能使用其项目保存与切换功能。
1、启动 VSCode,点击左侧活动栏中的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Project Manager,找到作者为 alefragnani 的扩展。
3、点击“安装”按钮,安装完成后点击“重新加载”或关闭重启 VSCode 以启用扩展。
二、保存当前工作区为命名项目
保存操作将当前打开的文件夹或代码工作区注册为一个带名称和可选图标的项目条目,后续可通过命令面板或侧边栏快速调用。
1、确保当前已打开一个文件夹或工作区(File → Open Folder)。
2、按下 Cmd+Shift+P(macOS)调出命令面板。
3、输入 Project Manager: Save Project 并回车。
4、在弹出的输入框中为该项目输入唯一名称,例如 my-react-app,然后按回车确认。
三、通过命令面板快速切换项目
命令面板是 Project Manager 最常用的触发入口,支持模糊匹配项目名,适用于键盘优先的工作流。
1、按下 Cmd+Shift+P 打开命令面板。
2、输入 Project Manager: List Projects 并回车。
3、在下拉列表中使用方向键浏览已保存项目,或直接输入项目名片段进行筛选。
4、选中目标项目后按回车,VSCode 将自动关闭当前窗口并以新项目路径重新打开工作区。
四、使用侧边栏项目视图切换
启用侧边栏项目视图后,所有已保存项目将以树形结构常驻显示,支持单击打开、右键编辑或删除,适合视觉导向操作习惯。
1、点击 VSCode 左侧活动栏底部的 项目管理器图标(两个重叠的文件夹),若未显示则需右键活动栏 → “更多命令” → 启用 Project Manager 视图。
2、在侧边栏中展开项目列表,找到目标项目名称。
3、将鼠标悬停在项目名上,点击右侧出现的 文件夹图标 即可立即切换至该项目。
五、手动编辑 projects.json 配置文件
Project Manager 将所有项目信息存储于用户级 JSON 配置文件中,直接编辑该文件可批量增删项目、调整顺序或添加自定义图标路径,适合高级用户精细化管理。
1、按下 Cmd+Shift+P,输入 Project Manager: Edit Projects File 并回车。
2、VSCode 将打开 projects.json 文件,其中每个项目为一个对象,包含 name、rootPath、icon 等字段。
3、在数组中新增一个对象,例如:
{ "name": "backend-api", "rootPath": "/Users/you/dev/backend", "icon": "server" }
4、保存文件,更改立即生效,无需重启 VSCode。










