Project Manager 插件不运行项目，仅快速打开指定路径文件夹；列表为空因未保存项目或 projects.json 配置错误；新窗口失效多因 VSCode 设置冲突；设置和调试配置需依赖单文件夹模式；批量导入须确保绝对路径、权限及 JSON 格式正确。
Project Manager 插件本身不“运行”项目，它只负责快速打开指定路径的文件夹——所谓“运行”，实际依赖你手动配置的调试器、终端命令或扩展行为。如果你切换后没反应、没加载设置、没启动服务，问题大概率出在路径、模式或 VSCode 原生机制上，而不是插件坏了。
为什么 Project Manager: List Projects 没反应或列表为空
这不是插件失灵，是你还没告诉它哪些是项目。它不扫描磁盘，只读 projects.json 里存的绝对路径。
- 确认已执行过
Project Manager: Save Project（快捷键Ctrl+Alt+S/Cmd+Alt+S），且当时打开的是含.git、package.json、pyproject.toml等标识文件的根目录 - 检查
projects.json路径是否可写：Linux/macOS 在~/.config/Code/User/projects.json，Windows 在%APPDATA%\Code\User\projects.json - 手动编辑该文件后，必须用
Project Manager: Reload Projects刷新缓存，否则修改不生效 - JSON 格式错误（比如末尾多逗号、引号不闭合）会导致整个列表静默失效；用
Project Manager: Edit Projects打开它，VSCode 会高亮语法错误
Open in New Window 不起作用或窗口被合并
VSCode 底层窗口策略会覆盖插件行为，尤其在 macOS 上容易误判为“没反应”。
- 先关掉 VSCode 设置里的
window.openFoldersInNewWindow（设为off或onClick），避免冲突 - 改用命令
Project Manager: Open Project in New Window (Force)，它绕过 VSCode 默认判断逻辑 - macOS 用户注意：即使开了新窗口，Dock 图标也可能被系统合并；用
Cmd+`切换窗口，别只靠点击 Dock - 全局配置
projectManager.openInNewWindow设为true后，所有项目默认新开窗；如需混用，可在单个项目对象里加"openInNewWindow": false字段，优先级更高
切换后 .vscode/settings.json 或调试配置没生效
Project Manager 只切换文件夹路径，不接管 VSCode 的设置加载机制——它依赖你以「单文件夹模式」打开项目。
- 确保保存项目前，VSCode 当前只打开一个文件夹（关闭其他文件夹或工作区），否则
.vscode/settings.json可能被忽略 - 检查目标项目根目录下是否存在
.vscode/settings.json，且没有被上层目录的用户级设置覆盖（VSCode 设置优先级：文件夹 > 工作区 > 用户） - 调试配置（
launch.json）必须放在当前活动文件夹的.vscode/下；如果项目本应是多根工作区（如前后端共存），Project Manager 不适用，该换用.code-workspace文件 - 终端不会自动重载环境变量或启动脚本——你得手动在新窗口里运行
npm run dev或python main.py
批量导入几百个项目却总失败
逐个点 Save Project 不现实，但直接写 projects.json 有陷阱：路径必须绝对、结尾不能带斜杠、name 不能重复、文件权限要对。
- rootPath 必须是 VSCode 实际看到的路径：WSL 项目写
/wsl$/Ubuntu/home/user/project，不要写/home/user/project - 生成 JSON 时用 Python 脚本比手敲安全：
import json; projects = {"my-app": {"name": "my-app", "rootPath": "/abs/path"}}; open("projects.json", "w").write(json.dumps(projects, indent=2)) - 写完后执行
Project Manager: Clean Projects，它会扫描每个rootPath是否可读，自动剔除失效条目 - 路径含中文或空格不报错，但某些 Shell 命令可能出问题；建议 name 用短横线（
my-backend）而非下划线或空格
真正卡住人的地方，从来不是怎么加项目，而是路径写成相对路径、projects.json 权限被锁死、或误把多根工作区当单文件夹项目来存——这些错误不会报红，只会让你反复点击却毫无反应。
