Project Manager插件需标志性文件识别项目，projects.json语法错误会导致列表为空，应通过命令面板编辑并备份；标签用tags数组，新开窗口需调整VS Code设置或使用强制命令。
Project Manager 插件不是“自动识别所有文件夹”的万能开关，它只认带标志性文件（如 package.json、.vscode/settings.json、pyproject.toml）的目录为项目；空文件夹或只有 README.md 的目录默认被跳过，必须手动添加。
为什么项目列表为空？先查 projects.json 是否合法
插件把所有项目存放在 projects.json 文件里（Linux/macOS 在 ~/.config/Code/User/projects.json，Windows 在 %APPDATA%\Code\User\projects.json）。这个文件一旦有语法错误——比如多一个逗号、少一个引号、用了中文引号——插件就静默失效，菜单直接变空。
- 用命令面板运行
Project Manager: Edit Projects，VS Code 会用自带 JSON 校验器打开该文件，错误位置会高亮 - 别用记事本、Sublime 或 VS Code 外部窗口直接改 —— 它们可能插入 BOM 或异常换行符，导致解析失败
- 如果项目突然全丢，去同目录找
projects.json.backup恢复
怎么给项目打标签？别硬写字段，用 tags 数组
在 projects.json 里给项目加 tags 字段，值是字符串数组。插件原生支持这个字段，且能通过顶部筛选框实时过滤。
- 正确写法：
"tags": ["backend", "team-a"] - 错误写法：
"team": "backend"—— 插件根本不读这个字段，升级时还可能被覆盖 - 标签名不区分大小写，但建议统一小写+短横线，比如
"vue3"、"ci-test"
“Open in New Window”没反应？不是插件问题，是 VS Code 窗口策略冲突
VS Code 默认开启 window.openFoldersInNewWindow 后，Project Manager 的普通“新开窗口”动作会被底层逻辑拦截或静默吞掉。
- 临时解决：把设置
window.openFoldersInNewWindow改成onClick或off - 更稳做法：不用右键菜单，改用命令面板执行
Project Manager: Open Project in New Window (Force) - macOS 用户注意：即使开了新窗，若系统启用了“在 Dock 中合并窗口”，任务栏图标也不会多一个，容易误判为没生效
真正麻烦的不是配置本身，而是 projects.json 文件一旦损坏，插件就彻底失联——它不会报错，也不会提示，只是安静地消失。每次手动编辑前，最好先复制一份备份；新增项目优先用 UI 添加，而不是直接改 JSON，减少手误风险。
