Project Manager插件不会自动保存项目，首次使用必须手动执行“Project Manager: Save Project”命令并命名，否则列表为空；它仅读取projects.json中的记录，不监听当前打开的文件夹。
Project Manager 插件本身不自动保存项目，第一次用必须手动执行 Project Manager: Save Project，否则列表永远为空。
为什么 Project Manager: List Projects 找不到你刚打开的文件夹
插件不会监听“当前打开了什么”，它只读取本地 projects.json 文件里的记录。你关掉 VSCode 再重开，它也不会凭空记住上次那个 /home/user/my-app。
- 必须显式触发
Project Manager: Save Project（Ctrl+Shift+P 输入后回车），然后给项目起名 - 名字别用空格或
/、、:等符号，否则某些终端调用code命令时会出错 - 如果项目在 WSL 或 NAS 上，保存时填的路径必须是 VSCode 实际显示的路径（例如 Windows 上 WSL 要写成
\wsl$Ubuntuhomeusermy-app，不是/home/user/my-app）
同名项目太多，点错了打开旧分支怎么办
Project Manager 允许重复名称，切换时按顺序列出所有匹配项，仅靠路径末尾区分——你看到两个 client，第一个可能是 ~/git/client，第二个才是 ~/git/client-feat/auth，但界面上只显示名字。
- 保存时就在名字里嵌入标识：用
client-prod、client-feat/auth、client-legacy这类命名 - 直接编辑
.vscode/projects.json改name字段，比反复删重存快得多 - 右键项目列表 →
Edit Project可加图标、分组、描述，提升可识别性
切换后 .vscode/settings.json 不生效
Project Manager 只做路径跳转，它不控制 VSCode 的设置加载逻辑。真正起作用的是 VSCode 的「单文件夹模式」机制——只有以单个文件夹为根启动，该文件夹下的 .vscode/settings.json 才会被读取。
- 如果你之前是用多根工作区（
.code-workspace）打开的，切过去后仍是多根模式，此时.vscode/settings.json被忽略 - 检查左下角状态栏有没有
[Workspace]标识：有，说明是多根；没有，才是单文件夹模式 - 想让设置生效，要么确保项目是作为独立文件夹保存的（不是工作区的一部分），要么改用
"settings"字段写进.code-workspace文件里
最常被忽略的一点：Project Manager 和多根工作区是两套机制，混用时行为不可预测——比如你用它打开一个 .code-workspace 文件，它记的是整个工作区路径，但后续编辑 projects.json 时若手误改了 rootPath，可能导致工作区打不开。
