Project Manager插件需手动保存项目才能切换，因其不自动发现无特征文件（如package.json）的目录；命令无效、列表为空或路径失效等问题，均源于未正确配置projects.json或路径不可用。
Project Manager 插件本身不自动发现项目，必须手动保存或配置路径，否则“切换项目”菜单永远为空。
Project: Save Project 为什么没反应？
常见原因是当前打开的文件夹不被插件识别为“项目”。它默认只接受含 package.json、tsconfig.json、.git 或 webpack.config.js 等特征文件的目录。
- 纯文档、脚本集合、旧 PHP 项目等，需先手动运行
Project Manager: Save Project命令（Ctrl+Shift+P 输入），再选中该文件夹 - 如果命令面板里搜不到该命令，检查插件是否启用：右下角状态栏有 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，除非你以单文件夹模式打开。如果你之前是用多根工作区打开的，切换后所有文件夹级设置都会丢失——这不是插件问题，而是 VSCode 的设计机制。
