Project Manager 列表为空是因为插件不自动记忆或扫描文件夹,仅读取 projects.json;必须手动执行“Project Manager: Save Project”保存含标识文件的绝对路径,否则列表始终为空。

Project Manager 插件不会自动记住你打开过的文件夹,第一次用必须手动执行 Project Manager: Save Project,否则列表永远为空。
Project Manager 为什么列表为空
插件不监听当前打开的文件夹,只读取本地 projects.json 文件。关掉 VSCode 再重开,它也不会“记得”上次那个 /home/user/my-app。
- 必须显式触发
Project Manager: Save Project(Ctrl+Shift+P 输入后回车) - 项目名避免空格、
/、:、\等符号,否则code命令调用可能失败 - 路径要填 VSCode 状态栏里显示的真实路径:WSL 上得写成
\wsl$\Ubuntu\home\user\my-app,不是/home/user/my-app
切换后 .vscode/settings.json 不生效
Project Manager 只做路径跳转,不控制 VSCode 的设置加载逻辑。真正起作用的是「单文件夹模式」——只有以独立文件夹为根启动,该文件夹下的 .vscode/settings.json 才会被读取。
- 检查左下角状态栏:有
[Workspace]标识 → 多根模式 →.vscode/settings.json被忽略 - 确保项目是作为单文件夹保存的(不是工作区的一部分)
- 若必须用多根工作区,把配置写进
.code-workspace的settings字段里 - 混用 Project Manager 和多根工作区时行为不可预测:比如它存了
.code-workspace路径,但你手误改了rootPath,可能导致整个工作区打不开
生成项目目录结构用哪个插件
别用 Project Tree(已多年未更新,兼容性差),推荐 directory-tree:中文界面友好,自动生成带图标、层级清晰的树状结构,直接追加到 README.md 底部。
- 安装插件
directory-tree - 打开目标项目,Ctrl+Shift+P → 输入
Directory Tree回车 - 若无
README.md,会自动创建;已有则在末尾追加目录树 - 支持通过
.gitignore过滤不显示的文件或目录 - 生成内容含 Unicode 图标(??),GitHub 渲染正常,点击路径可跳转(需启用 GitHub Pages 或预览插件)
最常被忽略的一点:Project Manager 和 .vscode/settings.json 加载机制完全解耦,路径跳转成功 ≠ 设置就生效;而 directory-tree 的输出位置和格式,取决于你是否提前存在 README.md —— 没这个文件时它会新建,但不会主动插入到文档开头或指定锚点。


















