project manager插件列表为空是因为未手动保存项目或projects.json配置错误；它不自动扫描磁盘，只读取该文件中合法的绝对路径，且需执行reload projects刷新缓存、确保json格式正确。
Project Manager 插件本身不自动管理项目，必须手动保存或编辑 projects.json，否则“切换项目”菜单永远为空——这不是插件坏了，是你还没告诉它哪些路径算项目。
为什么 Project Manager: List Projects 没反应或列表为空
插件不扫描磁盘，只读取 projects.json 里写的绝对路径。常见原因和应对方式：
- 没执行过
Project Manager: Save Project（快捷键Ctrl+Alt+S/Cmd+Alt+S），且当前打开的文件夹不含package.json、.git、tsconfig.json等标识文件 -
projects.json路径不可写：Windows 在%APPDATA%CodeUserprojects.json，macOS 在~/Library/Application Support/Code/User/projects.json，Linux 在~/.config/Code/User/projects.json - 手动编辑后没刷新缓存：必须运行
Project Manager: Reload Projects，否则修改不生效 - JSON 格式错误（比如末尾多逗号、单引号、引号不闭合）会导致整个列表静默失效；可用 VSCode 右下角语言模式切换为
JSON with Comments再切回JSON，高亮报错
如何添加一个没有“项目特征文件”的旧项目（如纯 PHP 或文档目录）
VSCode 默认不识别这类目录，但你可以绕过检测，强制注册：
- 先用资源管理器打开目标文件夹（确保是根目录，不是子目录）
- 运行
Project Manager: Add Project（不是Save Project），它不校验内容，只认路径 - Windows 路径写成
D:/my-legacy-app或D:\my-legacy-app，别用D:my-legacy-app（末尾反斜杠会失败） - name 字段建议加前缀避免重名，比如
"name": "php-legacy-admin"，而非泛泛的"admin"
切换后 .vscode/settings.json 或调试配置没生效
Project Manager 只负责跳转路径，不接管 VSCode 的设置加载逻辑——它依赖你以「单文件夹模式」打开项目。如果你看到设置没变、终端还是旧环境、launch.json 不加载，大概率是因为：
- 你用的是多根工作区（Multi-root Workspace），而 Project Manager 打开的是单文件夹路径，两者机制不兼容
- VSCode 当前处于「空窗口」或「远程连接中」状态，导致路径跳转后未触发 settings 加载流程
- 项目路径虽然正确，但
.vscode文件夹不在rootPath下一级（比如你设了/src/project-a，但.vscode在/project-a）
验证方式：切换后看左下角是否显示「Folder: xxx」，而不是「Workspace: xxx.code-workspace」。
批量导入几百个项目时最常踩的坑
别指望插件自动扫描——它不支持递归发现。批量操作本质是生成合法 projects.json 后手动替换。关键细节：
-
rootPath必须是绝对路径，且不能以斜杠结尾（/home/user/proj/❌，/home/user/proj✅） - 路径权限要一致：如果部分项目在 NAS 或 WSL 中，挂载点变更（如从
/mnt/c/改成/c/）会导致批量失效 - 跨平台同步时，用符号链接统一路径比硬编码更可靠，例如
ln -s /wsl$/Ubuntu/home/user/project ~/project - 运行
Project Manager: Clean Projects前先备份projects.json，它会直接删掉所有rootPath不可读的条目，且不提示
真正容易被忽略的是：Project Manager 的「项目」只是 VSCode 启动命令的快捷参数，它不维护进程、不同步终端、不接管扩展启用状态——所有这些，都得靠你对单文件夹模式的理解和日常习惯来兜底。
