必须重启VSCode并确保插件启用；若命令仍不显示，检查是否在含package.json/.git等特征文件的目录中，且projects.json路径正确、格式无误（如JSON逗号/引号匹配）。
Project Manager 插件不显示 “Project: Switch Project” 怎么办
插件安装后命令面板搜不到，基本是没激活或路径识别失败。它不会自动注册快捷键，必须手动触发 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）再输入命令。
常见原因包括：
- VSCode 没重启 —— 安装插件后必须重启才能加载完整生命周期
- 右下角状态栏有 Project Manager 图标但灰了，点一下启用
- 当前打开的是空窗口或纯文档目录，而插件默认只收录含
package.json、.git、tsconfig.json等特征文件的文件夹 - Windows 用户路径用了单反斜杠
D:my-app，JSON 解析会出错；应改用双反斜杠D:\my-app或正斜杠D:/my-app
项目添加后仍提示 “No projects found”
Project Manager 的项目元数据不存于 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 强制重载缓存。
切换项目后扩展、终端、调试配置没变
Project Manager 只切换工作区路径，不接管任何运行时状态。它等价于手动执行 code /path/to/project，不会自动启用/禁用插件，也不会加载 .vscode/settings.json 或 .vscode/launch.json，除非你以单文件夹模式打开。
如果你之前是用多根工作区（.code-workspace）打开的，切换后所有文件夹级设置都会丢失 —— 这不是插件问题，是 VSCode 的设计机制。
真正起作用的配置层级是：文件夹 > 工作区 > 远程 > 用户。Project Manager 不改变这个优先级顺序，也不触发重新读取逻辑。
跨电脑同步项目列表要注意什么
Project Manager 的 projects.json 是绝对路径，直接复制到另一台电脑大概率失效（比如 C:\dev\old-project 在新机器上根本不存在）。
可行做法有：
- 用符号链接统一路径（Linux/macOS：
ln -s /mnt/wsl/my-project ~/my-project；Windows WSL：mklink /D C:\dev\my-project \wsl$\Ubuntu\home\user\my-project） - 在新电脑上重新运行
Project: Add Project，不要复用旧的projects.json - 配合 Settings Sync 同步用户设置，但别让它同步
projects.json—— 它不在同步白名单里，强行加进去反而容易冲突
最常被忽略的一点：Project Manager 从不校验路径是否存在。它只是原样调用 code 命令打开路径，所以移动、重命名、NAS 断连后，切换时只会报 “File not found”，不会提前预警。
