Project Manager插件不会自动识别项目，必须手动执行“Project Manager: Save Project”保存含标识文件（如package.json、.git）的绝对路径根目录，否则列表为空；projects.json路径或格式错误、路径失效、命令名拼错等均导致“No projects found”。
Project Manager 插件不会自动把所有打开过的文件夹变成可切换项目，必须手动执行 Project Manager: Save Project 才能入库——否则按 Ctrl+Alt+P 或调用列表永远是空的。
为什么“List Projects”命令返回 no projects found
插件不扫描历史打开记录，也不遍历 ~/Projects 这类目录，只认你明确保存过的路径。常见原因包括：
- 当前打开的文件夹不含识别特征（如
package.json、.git、pyproject.toml），导致Save Project命令不可见或静默失败 - 误删或写错
projects.json路径：Windows 是%APPDATA%\Code\User\projects.json，macOS 是~/Library/Application Support/Code/User/projects.json，Linux 是~/.config/Code/User/projects.json - 该 JSON 文件存在语法错误（多逗号、少引号、BOM 头），VSCode 不报错但插件直接拒读
- 在命令面板里搜的是
Project: Save Project或拼错成Project Manager: Add Project—— 正确命令名是Project Manager: Save Project
保存项目时路径和命名要注意什么
路径必须是绝对路径，结尾不能带斜杠；命名建议用短英文+数字，避免空格和中文标点——虽然支持中文名，但某些终端或脚本环境会出问题。
- 符号链接路径可能被解析为真实路径，造成重复保存或匹配失效，可用
realpath .验证当前目录实际路径 - 移动或重命名项目后，下次切换会提示 “path not found”，此时选 “Update” 即可修正，别手动生成新条目
-
projectManager.sortList默认为true，新项目自动置顶；设为false后新项目沉底，容易被忽略
切换项目总在当前窗口覆盖，怎么强制新开窗口
默认行为是复用当前窗口，即使你点了 “Open in New Window” 也可能没反应——这通常不是插件问题，而是 VSCode 窗口策略拦截了。
- 全局设置
projectManager.openInNewWindow设为true，所有切换都新开窗 - 更灵活的做法：在单个项目配置里加
"openInNewWindow": true字段，优先级高于全局设置 - 如果仍无效，改用命令
Project Manager: Open Project in New Window (Force)，它绕过 VSCode 的窗口复用逻辑 - macOS 用户注意：新窗口可能被系统合并到同一 Dock 图标，需用
Cmd+`切换，而非点击 Dock
批量管理项目：直接编辑 projects.json 最可靠
手动一个个保存太慢，尤其已有几十个 Git 仓库时。直接编辑配置文件效率最高，且支持分组、图标、预执行命令等进阶功能。
- 每个项目对象至少含
name和rootPath，rootPath必须是绝对路径（/home/user/app，不是~/app） - 加
"group": "frontend"可分类，侧边栏视图会按组折叠；加"icon": "???"支持 emoji 或内置图标 ID - 修改后不要直接重启 VSCode，运行
Project Manager: Reload Projects即可热更新 - 定期运行
Project Manager: Clean Projects，它会检查每个rootPath是否可读，自动剔除失效条目
真正卡住人的地方，往往不是功能不会用，而是路径写成相对路径、JSON 手动改错格式、或以为插件会自动发现项目——它只认你亲手存进去的那几条记录。
