project manager 插件通过识别标志性文件（如 .vscode/settings.json、package.json 等）判断项目有效性，无则跳过；路径需用绝对或规范相对路径；项目消失时可编辑 projects.json 校验；多窗口打开需用强制命令；.code-workspace 与插件职责分离；tags 必须为字符串数组且格式正确。
Project Manager 插件怎么识别你的项目
Project Manager 不是“看到文件夹就加进来”，它靠标志性文件判断是否为有效项目。默认只认 .vscode/settings.json、package.json、pyproject.toml、go.mod 这类文件——没有其中之一，插件就跳过该目录，不会出现在项目列表里。
常见踩坑点：
- 空文件夹或只有
README.md的目录，必须手动添加：右键资源管理器 → Add Folder to Project Manager - 路径含波浪号（如
~/projects/myapp）可能解析失败，建议用绝对路径或相对路径（从用户主目录起） - 如果项目突然消失，先运行命令
Project Manager: Edit Projects，VS Code 会用内置 JSON 校验器打开projects.json，一眼看出逗号多/引号少/换行符乱码等问题
多项目切换时“Open in New Window”没反应
这不是插件失效，而是 VS Code 窗口复用策略和插件行为冲突导致的静默失败。尤其在启用了 window.openFoldersInNewWindow 的情况下，点击“Open in New Window”可能被拦截。
可靠解法：
- 改用命令面板执行
Project Manager: Open Project in New Window (Force)，它绕过 VS Code 默认窗口逻辑 - macOS 用户注意：即使开了新窗，若系统启用了“在 Dock 中合并窗口”，任务栏图标也不会多一个，容易误判为没生效
- Windows/Linux 上可临时关闭
window.openFoldersInNewWindow，设为off或onClick再试
.code-workspace 和 Project Manager 到底谁管谁
二者不冲突，但职责完全不同：.code-workspace 是 VS Code 原生工作区配置，定义文件夹结构、设置、终端上下文；Project Manager 是快捷入口，只负责“快速打开已知路径”。它不读取也不影响 .code-workspace 文件内容。
实操建议：
- 长期维护的关联项目（如 monorepo 的 frontend/backend），用
.code-workspace管理，确保launch.json、tasks.json、扩展启用范围精准控制 - 零散、不关联、需保密的项目（如客户定制脚本、内部工具），用 Project Manager 打标签（
tags字段），再通过筛选快速定位 - 别把
.code-workspace文件加进 Project Manager —— 它不是项目根目录，插件识别不到，还会导致路径错误
标签（tags）不是摆设，但得写对格式
Project Manager 的 tags 字段是字符串数组，不是单个字符串，写错格式会导致筛选失效。正确示例："tags": ["前端", "测试环境"]；错误写法："tags": "前端" 或 "tags": ["前端",]（末尾逗号在某些 JSON 解析器中不安全）。
真正好用的标签习惯：
- 按角色分：比如
"学习项目"、"录制视频"、"客户交付"，避免模糊词如"重要"或"待处理" - 按技术栈分：比如
"TypeScript"、"Python3.12"，方便快速过滤语言环境 - 标签名不要带空格或特殊符号，否则搜索框输入时容易断开或匹配失败
