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 匹配失败——这些细节不报错，只让切换静默失效。
