Project Manager 插件列表为空，90% 是 projects.json 语法错误导致静默失效；应使用“Project Manager: Edit Projects”命令由 VS Code 校验 JSON，路径需为绝对路径且无 BOM、多余逗号或单引号，Linux/macOS 在 ~/.config/Code/User/projects.json，Windows 在 %APPDATA%CodeUserprojects.json。
Project Manager 插件不显示项目？先检查 projects.json 是否合法
插件列表为空，90% 是 projects.json 文件语法出错。它不报错，只静默失效。
正确做法是：用命令面板运行 Project Manager: Edit Projects，让 VS Code 自带的 JSON 校验器打开该文件。别用记事本或 Sublime 直接改——BOM、多余逗号、单引号都会让它失效。
-
projects.json通常在~/.config/Code/User/projects.json（Linux/macOS）或%APPDATA%CodeUserprojects.json（Windows） - 如果项目突然全丢，去同目录找
projects.json.backup恢复 - 手动添加项目时，
rootPath必须是 VS Code 实际识别的路径（例如 WSL 下要写成\wsl$Ubuntuhomeusermy-proj，不是/home/user/my-proj）
为什么 .vscode/settings.json 切换后不生效？确认是否进入单文件夹模式
Project Manager 打开的是文件夹路径，但 VS Code 是否加载该文件夹下的 .vscode/settings.json，取决于启动方式。
关键看左下角状态栏：有 [Workspace] 标识 → 多根工作区模式 → .vscode/settings.json 被忽略；没标识 → 单文件夹模式 → 设置生效。
- 如果你把一个项目保存为 Project Manager 项目，但它原本属于某个
.code-workspace，切换过去仍会保持多根模式 - 想让
.vscode/settings.json生效，必须确保它是以独立文件夹方式打开的（即 rootPath 指向纯文件夹，不是.code-workspace文件） - 混用 Project Manager 和多根工作区容易导致行为不可预测，比如误把 workspace 文件当普通文件夹存进项目列表
按团队/语言分类项目？别硬加字段，用 tags + 筛选
直接在 projects.json 里加 "team": "frontend" 或 "lang": "python" 没用——插件不读这些字段，升级还可能被覆盖。
真正支持的分类方式只有 tags 字段，配合顶部筛选框使用：
- 每个项目可定义多个标签，如
"tags": ["backend", "python", "prod"] - 在项目管理器顶部输入
backend，所有含该标签的项目即时聚合 - 标签名建议小写、无空格、避免特殊字符（
py3.12可以，Python 3.12容易出错）
切换项目后终端/调试配置丢失？那是工作区级配置没对齐
Project Manager 只跳转路径，不接管终端、任务、launch 配置。这些依赖 .code-workspace 或当前文件夹的 .vscode/tasks.json/launch.json。
- 如果常用调试配置，优先放在项目根目录的
.vscode/launch.json中（单文件夹模式下自动生效） - 若必须用多根工作区，把通用配置写进
.code-workspace的"settings"或"launch"字段，而非靠 Project Manager 切换 - 终端默认复用当前窗口，想每次新开独立终端，需设
"terminal.integrated.defaultProfile.linux": "bash"并配合workbench.action.terminal.new快捷键
最常被忽略的一点：Project Manager 是“快捷入口”，不是“配置引擎”。它解决的是“怎么快速找到并打开”，而不是“打开后怎么运行”。项目级行为（格式化、调试、终端）始终由 VS Code 的原生工作区机制决定，插件不干预也不覆盖。
