project manager 插件需手动添加项目路径并确保配置在用户级 settings.json 或 projects.json 中，否则 ctrl+shift+p 无法显示“project: switch project”；切换仅改变工作区，不自动同步扩展、终端或调试配置。
Project Manager 插件安装后为什么 Ctrl+Shift+P 找不到 “Project: Switch Project”？
插件本身不自动注册全局快捷键，必须手动触发命令面板。常见原因是插件未正确激活（比如没重启 VSCode 或工作区权限受限），或项目根目录下缺少识别标识。
- 确保已安装官方
Project Manager插件（作者：alefragnani） - VSCode 重启后，在任意空工作区或文件夹中按
Ctrl+Shift+P（macOS 为Cmd+Shift+P），输入Project: Switch Project—— 如果仍不出现，检查插件是否被禁用（右下角状态栏有插件图标，点击可启用） - 插件默认只识别含
package.json、tsconfig.json、.git等“项目特征文件”的文件夹；纯文档目录不会被收录，需手动添加
如何让自定义路径（如 D:my-legacy-app）出现在项目列表里？
Project Manager 不扫描全盘，它依赖显式配置。你得告诉它哪些路径是“项目”，否则切换菜单永远为空。
- 打开命令面板，运行
Project: Add Project，然后选择目标文件夹（支持多选） - 或者直接编辑配置文件：
Ctrl+,→ 搜索projectManager.projectsPath→ 添加自定义路径，例如：["D:\my-legacy-app", "C:\dev\microservices"] - 注意 Windows 路径要用双反斜杠
\或正斜杠/，单反斜杠会报错 - 添加后无需重启，下次执行
Project: Switch Project就能看见新项目（名称默认取文件夹名，可后续在projects.json中修改）
切换项目时提示 “No projects found”，但明明刚加过？
大概率是项目缓存没刷新，或配置写错位置。Project Manager 的项目元数据存在用户级 JSON 文件里，不是工作区设置。
- 确认项目配置是否写在了错误位置：应写在
User Settings (JSON)（全局），而非Workspace Settings (JSON)（当前文件夹） - 检查
projects.json文件是否被意外删除 —— 它通常位于：%USERPROFILE%AppDataRoamingCodeUserprojects.json（Windows）或~/Library/Application Support/Code/User/projects.json（macOS） - 如果手动编辑过该文件，JSON 格式错误（如末尾多逗号、引号不匹配）会导致整个列表失效，可用 VSCode 自带的 JSON 验证（打开该文件 → 右下角点“JSON” → 改为“JSON with Comments”再切回来）
- 临时解决：运行
Project: Refresh Projects强制重载
为什么切换到某个项目后，扩展、终端、调试配置都还是上一个项目的？
Project Manager 只切换工作区（即打开的文件夹），不接管扩展启用状态、终端环境变量或 .vscode/launch.json 等本地配置。它不是“沙盒切换器”，只是快速打开预设路径。
- 每个项目应自带独立的
.vscode/extensions.json（推荐扩展）、.vscode/settings.json（项目专属设置），否则你会反复手动调整 - 终端默认继承系统 PATH，若需项目专属环境（如不同 Node 版本），得配合
nvm或direnv，Project Manager 不处理这个 - 调试配置必须放在对应项目的
.vscode/launch.json中；跨项目复用配置容易出错，别图省事共用一个
Remote-Containers 或单独开多个 VSCode 窗口 —— 切换快，不代表上下文真的干净。
