project manager 插件需手动保存项目路径才能启用快速切换,否则列表为空;它仅识别通过“save project”存档的含标识文件的根目录,不自动扫描projects文件夹或历史工作区。

Project Manager 插件本身不自动识别项目结构,必须手动添加或配置项目路径,否则“快速切换”只是空转。
为什么 Project Manager 没列出你的项目
插件默认只扫描你主动保存过的文件夹(即通过 Project Manager: Save Project 命令存档的路径),不会自动遍历 ~/Projects 或工作区历史。常见现象是打开 VSCode 后按 Ctrl+Alt+P(Windows/Linux)或 Cmd+Alt+P(macOS)弹出空列表。
- 检查是否已执行过
Project Manager: Save Project(快捷键Ctrl+Alt+S),且选中的是含.git、package.json、pyproject.toml等标识文件的根目录 - 若项目在符号链接路径下,VSCode 可能读取真实路径,导致重复保存或匹配失败;建议用
realpath验证路径一致性 - 插件配置项
projectManager.sortList设为false时,新项目不会自动置顶,容易被忽略
如何批量导入已有项目(比如 Git 仓库目录)
手动一个个 Save Project 效率低,可直接编辑插件的 JSON 配置文件,实现批量注册。
- 配置文件路径:
~/.vscode/extensions/alefragnani.project-manager-1.*/projects.json(Windows 是%USERPROFILE%.vscodeextensionslefragnani.project-manager-*.\projects.json) - 每个项目对象至少包含
name和rootPath字段,rootPath必须是绝对路径,结尾不带斜杠 - 示例片段:
{ "my-web-app": { "name": "web-app", "rootPath": "/home/user/dev/web-app" }, "api-service": { "name": "api-service", "rootPath": "/home/user/dev/api-service" } } - 修改后重启 VSCode 或执行
Project Manager: Reload Projects,避免缓存未更新
切换时打不开正确文件夹?检查 projectManager.openInNewWindow
默认行为是复用当前窗口,但如果你习惯每个项目一个窗口,而实际却覆盖了旧项目,大概率是这个配置没设对。
-
projectManager.openInNewWindow默认为false;设为true后,每次切换都会新开独立窗口(适合多屏开发) - 若希望部分项目新开、部分复用,可在单个项目配置里加
openInNewWindow字段,优先级高于全局设置 - 注意:macOS 上新窗口可能被系统“合并”到同一 Dock 图标,需按
Cmd+`切换,而非点击 Dock
真正卡住人的地方,往往不是怎么添加项目,而是路径写错(相对路径无效)、权限不足(如 root 创建的文件夹无法读取)、或者 VSCode 工作区已打开某个子文件夹导致 rootPath 匹配失败——这些细节不报错,只让切换静默失效。











