VSCode 的 Project Manager 扩展支持一键保存和切换多项目,无需 .code-workspace 文件;通过命令保存项目、快捷键 Ctrl+Alt+P 切换,并支持分组、图标及自定义命令。

VSCode 的 Project Manager 扩展能帮你把常用项目“存档”起来,一键跳转,省去反复打开文件夹、切换工作区的麻烦。它不依赖 .code-workspace 文件,对单文件夹项目也友好,适合多项目并行的开发者。
如何添加当前项目到管理列表
打开你的项目根目录(比如一个含 package.json 或 src/ 的文件夹),按下 Ctrl+Shift+P(macOS 是 Cmd+Shift+P),输入 Project Manager: Save Project,回车。默认会用文件夹名作为项目名,你也可以在弹出框里改个更易识别的名字,比如 “my-blog-dev” 或 “api-v3-test”。
- 保存后,项目自动写入全局 JSON 配置(路径通常在 ~/.vscode/projects.json)
- 支持中文项目名,但建议避免空格和特殊符号,以防某些终端环境出问题
- 如果项目移动了位置,下次切换时会提示路径失效,可选择更新或删除
快速切换项目的几种方式
最常用的是快捷键:Ctrl+Alt+P(Windows/Linux)或 Cmd+Alt+P(macOS),唤出项目列表,输入关键词过滤,回车即打开——VSCode 会自动在新窗口或当前窗口(可配置)中加载该项目。
- 右键资源管理器空白处,也能看到 Project Manager: Quick Switch Project 菜单项
- 命令面板里搜 Project Manager: List Projects,效果一样
- 想在当前窗口打开?在设置里搜索 projectManager.openInCurrentWindow,勾选即可
进阶用法:分组、图标和自定义命令
你可以在 projects.json 里手动编辑项目条目,加入 group 字段做分类,比如 "frontend"、"backend";加 icon 字段指定图标(支持 emoji 或 VS Code 内置图标 ID);还能配 beforeOpenCommand,比如自动拉取最新代码或启动本地服务。
- 示例片段:
"group": "work", "icon": "?", "beforeOpenCommand": "git pull origin main" - 所有字段文档可在扩展主页的 README 查看,无需重启 VSCode 即生效
- 不想让某些项目出现在列表?加 hidden: true
基本上就这些。不用建一堆 .code-workspace,也不用记路径,点几下就回到昨天写的那个小工具或者客户项目里——项目一多,这个扩展真不是可有可无。










