VSCode安装ProjectManager 快速切换VSCode多个项目目录

Project Manager插件需手动保存项目才能切换，因其不自动发现无特征文件（如package.json）的目录；命令无效、列表为空或路径失效等问题，均源于未正确配置projects.json或路径不可用。

这里有个核心概念需要先明确：Project Manager 插件本身并不会自动帮你发现项目。如果你不手动保存或配置路径，那么“切换项目”的菜单将永远空空如也。

Project: Sa ve Project 为什么没反应？

最常见的原因，是当前打开的文件夹没有被插件识别为“项目”。它默认只认那些包含特定特征文件的目录，比如 package.json、tsconfig.json、.git 或者 webpack.config.js。

• 那么，像纯文档文件夹、脚本集合、或者一些老旧的 PHP 项目该怎么办？答案是先手动运行 Project Manager: Sa ve Project 命令（通过 Ctrl+Shift+P 调出命令面板输入），然后选中当前文件夹。
• 如果连这个命令都搜不到，第一步得检查插件是否真的启用了：留意 VSCode 右下角的状态栏，通常会有 Project Manager 的图标，点击可以开关。
• Windows 用户需要额外注意路径分隔符的问题——D:\my-app 和 D:/my-app 这两种写法都合法，但如果写成 D:\my-app\（末尾多了一个反斜杠），很可能导致后续打开失败。

添加了项目却提示 “No projects found”

问题可能出在配置的“位置”上。Project Manager 的项目元数据是存储在一个独立的 JSON 文件里的，它既不属于用户设置，也不属于工作区设置。一旦写错了位置或者格式有误，功能就会彻底失效。

• 首先确认，配置是写在全局的 settings（即 User Settings JSON）里，而不是当前工作区下的 settings.json。
• 接着，检查 projects.json 这个关键文件的路径：
  – Windows 系统下：%USERPROFILE%\AppData\Roaming\Code\User\projects.json
  – macOS 系统下：~/Library/Application Support/Code/User/projects.json
  – Linux 系统下：~/.config/Code/User/projects.json
• 如果你手动编辑了这个文件，务必验证 JSON 格式是否正确：打开文件后，点击编辑器右下角的语言模式，先切换到 JSON with Comments，再切回 JSON，VSCode 会自动高亮显示语法错误。
• 一个临时的修复方法是：运行 Project Manager: Refresh Projects 命令，强制插件重新加载缓存。

切换时打开空白窗口或报错 “File not found”

这是路径失效后最典型的症状。要知道，Project Manager 并不会在切换前校验路径是否存在，它只是原封不动地执行类似 code /old/path 这样的命令。

• 导致路径失效的常见原因有哪些？项目被移动或重命名了、磁盘挂载点发生了变更（比如在 WSL 中从 /mnt/c/ 改成了 /c/）、或者 NAS 的网络路径断连了。
• 建议定期清理：运行 Project Manager: Clean Projects 命令，它会逐个检查配置文件里每个项目的 rootPath 是否可读，并自动剔除掉无效的条目。
• 对于需要跨环境同步配置的情况，可以考虑使用符号链接来统一路径（例如执行 ln -s /wsl$/Ubuntu/home/user/project ~/project），避免在配置中硬编码不同系统下的路径前缀。
• 另外，不要试图用 VSCode 自带的「最近打开」列表来替代 Project Manager 的功能——这两者完全无关。

最后，还有一个真正容易被忽略的细节：Project Manager 只负责将你“跳转”到项目路径，它并不负责加载项目目录下的 .vscode/settings.json 文件，除非你当初是以单文件夹模式打开这个项目的。如果你之前是用多根工作区（Multi-root Workspace）的方式打开的，那么切换后，所有文件夹级别的设置都会丢失。这并非插件的缺陷，而是 VSCode 本身的设计机制使然。