Project Manager扩展可高效管理VSCode多项目切换。通过安装扩展、手动添加项目、启用Git自动扫描、快捷键调出列表及配置分组图标，实现一键加载与可视化分类。
如果您在VSCode中频繁切换多个项目，却因手动打开文件夹或工作区而感到效率低下、容易出错，则可能是缺乏统一的项目管理机制。Project Manager扩展正是为此设计，它能将常用项目以命名条目形式集中存储并一键加载。以下是实现高效项目切换的具体操作：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装Project Manager扩展
该扩展由alefragnani开发，是VSCode Marketplace中星标最高的项目管理工具之一，支持工作区、文件夹及Git仓库的自动识别与持久化注册。
1、启动VSCode，点击左侧活动栏中的扩展图标（或按快捷键Cmd+Shift+X）。
2、在搜索框中输入Project Manager，找到作者为alefragnani的官方扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”使扩展生效。
二、手动添加当前项目到项目列表
适用于尚未被自动检测的本地文件夹或自定义命名场景，通过配置文件显式注册项目路径与别名。
1、按下Cmd+Shift+P打开命令面板，输入并选择Project Manager: Edit Projects。
2、在打开的projects.json文件中，定位到"projects"数组内。
3、插入新对象，格式为：{"name": "MyWebApp", "rootPath": "/Users/yourname/dev/webapp"}，其中name为显示名称，rootPath为绝对路径。
4、保存文件，项目即刻出现在项目列表中。
三、启用自动Git项目发现
利用Git仓库的.git目录作为标识，自动扫描指定父目录下的所有子仓库，并将其注册为可切换项目，避免重复手动录入。
1、按下Cmd+Shift+P，输入并选择Project Manager: Toggle Auto-scan Folders。
2、在弹出的输入框中填入父级路径，例如/Users/yourname/dev，回车确认。
3、扩展将在后台扫描该路径下所有含.git的子目录，并为每个仓库生成唯一项目条目。
四、快速切换已注册项目
通过快捷键或命令面板调出项目列表，实现毫秒级工作区加载，无需记忆路径或重复浏览文件系统。
1、按下默认快捷键Cmd+Ctrl+P（macOS），或执行命令Project Manager: List Projects。
2、在出现的下拉菜单中使用方向键或鼠标选择目标项目名称。
3、回车后，VSCode将关闭当前窗口并以新项目路径启动独立窗口（若设置为多窗口模式）或直接替换当前工作区。
五、配置项目分组与图标标识
通过JSON配置为不同项目分配分组标签和SVG图标，提升视觉辨识度，尤其适用于跨技术栈或客户维度的项目归类。
1、再次执行Project Manager: Edit Projects打开配置文件。
2、为某项目对象添加"group": "Frontend"字段，使其归入Frontend分组。
3、添加"icon": "src/icons/react.svg"字段，引用本地SVG图标路径（需确保路径可访问）。
4、保存后，下次调出项目列表时将按group分节显示，且对应条目前缀显示指定图标。
