如何通过VSCode的Project Manager高效管理多个项目？

本文共计920个文字，预计阅读时间需要4分钟。

Project Manager 是一个非 VS Code 官方插件，它只是一个第三方辅助工具，不能替代 .code-workspace 文件对多个项目的真实管理能力。它主要负责快速打开已知路径的文件夹，本质上是一个路径书签列表，不涉及设置、调试、扩展等任何工作区逻辑。

为什么 Project Manager 无法真正管理多项目

• 它不创建或加载 .code-workspace，每次打开都只是单文件夹模式（即「文件夹工作区」），所有跨项目能力全部丢失
• 搜索（Ctrl+Shift+F）默认只在当前打开的单个文件夹内进行，除非你手动勾选“在文件夹中”并指定其他路径
• 调试配置（launch.json）必须放在当前活动文件夹的 .vscode/ 下，无法统一调度前后端多个服务
• Project Manager 的“open project in new window”默认行为会启动全新 VS Code 实例，内存和扩展重复加载，反而加重负担
• 它保存的路径是绝对路径，换机器或重装系统后大量条目直接失效，且无法提交到 Git 协作

Project Manager 唯一适合的场景

• 你确实需要频繁切换完全无关、互不调用、也不共享类型或配置的独立项目（比如一个 Python 脚本工具 + 一个静态 HTML 演示页 + 一个 Markdown 笔记目录）
• 你不想也不需要跨项目跳转、联合搜索、统一终端或共用 ESLint 规则
• 你愿意手动维护每个项目的绝对路径，并接受每次重装后重新录入

此时可这样用：

• 安装插件后，按 Ctrl+Shift+P 输入 Project Manager: Save Project，为当前打开的文件夹存一个别名
• 后续用 Ctrl+Shift+P → Project Manager: List Projects 快速唤出列表，回车打开
• 在插件设置里关掉 projectManager.openInNewWindow，避免默认开新窗口；改用 projectManager.openInSameWindow 配合 workbench.editor.closeOnFileDelete 减少标签页堆积

真正该用什么：优先走 .code-workspace 路线

• 所有需要协作、调试联动、类型共享、统一 lint 或格式化的项目组合，必须用 .code-workspace
• 创建方式：空窗口下 Ctrl+Shift+P → Workspaces: Create Workspace → 多选文件夹 → 保存为 my-team.code-workspace
• 调试时每个 configuration 必须显式写 "cwd": "${workspaceFolder:backend}"，其中 backend 是 .code-workspace 中对应 folders 条目的路径末级目录名
• 如果项目名含空格或点号（如 my.app），VS Code 可能自动截断标识符，此时应手动在 .code-workspace 的 folders 里加 "name": "my-app" 字段，再在 launch.json 中引用 ${workspaceFolder:my-app}

容易被忽略的一点：VS Code 不会自动把已有 .vscode/settings.json 合并进工作区设置。如果你希望某项配置（如 files.exclude）对整个工作区生效，必须把它写进 .code-workspace 的 "settings" 字段里，而不是依赖某个子文件夹下的局部配置。