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,可能导致工作区打不开。











