Project Manager 列表为空是因为插件不自动扫描项目，必须手动执行“Project Manager: Save Project”将含标识文件（如package.json、.git）的文件夹根路径保存至projects.json，否则列表始终为空。
Project Manager 插件为什么列表为空
刚装完插件，点开左侧项目面板却一片空白——这不是 bug，是它根本没记录任何项目。Project Manager 不会自动扫描或记住你打开过的文件夹，只读取 projects.json 里的配置。必须手动触发一次 Project Manager: Save Project（Ctrl+Shift+P 输入后回车），给项目起个名、选好根路径，它才真正“入库”。
常见踩坑点：
- 名字里含空格或
/、:、等符号，后续用code .命令行调用时可能失败 - 路径写错：比如 WSL 项目，在 Windows 版 VS Code 里必须填
\wsl$\Ubuntu\home\user\my-app，而不是/home/user/my-app - 同名项目太多，列表里只显示名字不显示路径，容易点错——右键项目选
Edit Project，加description或icon能立刻区分
标签（tags）不是可有可无的装饰
标签是让几十个项目不乱套的核心机制，不是锦上添花的功能。你在 projects.json 里给每个项目加 "tags": ["Frontend", "Personal"]，就能在顶部筛选框输入 Frontend，瞬间收拢所有前端项目；输 Personal，就只留私有项目。
实际用法建议：
- 别只打一个标签，比如
["React", "Client", "2026"]，组合筛选更精准 - 避免模糊词如
"new"或"temp"，时间一长自己都忘了指哪个 - 标签名大小写敏感，
"backend"和"Backend"是两个标签
切换项目后 .vscode/settings.json 不生效
点了项目列表里的 “blog-admin”，打开后发现缩进还是 2 个空格，而你明明在项目根目录下的 .vscode/settings.json 里写了 "editor.tabSize": 4——问题不在插件，而在 VS Code 的加载逻辑。
关键判断点：
- 看左下角状态栏：有
[Workspace]标识，说明当前是多根工作区模式，此时.vscode/settings.json被忽略 - 没有
[Workspace]，但设置仍不生效，检查项目是否被保存为.code-workspace文件（即以工作区方式打开），这种情况下 rootPath 指向的是 workspace 文件，不是文件夹 - 想确保文件夹级设置生效，必须用单文件夹模式打开：保存项目时，rootPath 值得是文件夹绝对路径，且不能指向 .code-workspace 文件
和 .code-workspace 混用时最危险的细节
Project Manager 和 VS Code 原生的多根工作区（.code-workspace）走的是两套完全独立的管理路径，强行混用会导致行为不可预测。
典型翻车场景：
- 你用
Project Manager打开一个my-app.code-workspace文件，它会把整个 workspace 文件当做一个“项目”存进projects.json - 之后手误改了这个项目的
rootPath字段，比如删掉末尾的.code-workspace，再点击打开，VS Code 就报错找不到工作区 - 更隐蔽的问题：某个项目既被
Project Manager收藏，又作为子文件夹加入另一个工作区，切换时可能加载错 settings 或扩展
真正干净的做法是二选一：要么全用 Project Manager 管理单文件夹项目，要么用 .code-workspace 管理一组关联文件夹——中间态最容易出问题，而且排查起来要翻三处配置。
