project manager插件不生效需先确认工作区是否被识别为“项目”，它依赖.vscode/settings.json等标志性文件判断；若无则需手动添加或检查projects.json语法错误、窗口设置冲突及正确使用tags分类。

Project Manager插件不生效？先确认工作区是否被识别为“项目”

Project Manager 默认只把含有特定配置文件的文件夹当作可管理的“项目”，不是所有打开的文件夹都会自动入库。它靠的是识别 .vscode/settings.json、package.json、pyproject.toml、go.mod 等标志性文件来判断——没这些，插件就当你是临时打开的普通目录，不会存进项目列表。

• 手动添加：右键资源管理器里的文件夹 → “Add Folder to Project Manager”
• 批量识别：在设置里搜 projectManager.ignoredFolders，删掉误加的排除路径
• 常见坑：~/Desktop/test 这种纯空文件夹或只有 README.md 的目录，插件默认跳过，必须手动加

切换项目时提示“no projects found”？检查 JSON 配置格式是否合法

Project Manager 把所有项目信息存在 projects.json 里（路径通常为 ~/.config/Code/User/projects.json 或 Windows 下 %APPDATA%\Code\User\projects.json）。这个文件一旦有语法错误（比如多一个逗号、少一个引号），插件就静默失败，菜单里直接变空。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），运行 Project Manager: Edit Projects，它会用 VSCode 自带的 JSON 校验器打开该文件
• 不要用外部编辑器直接改 —— 某些编辑器会偷偷加 BOM 或换行符，导致解析失败
• 如果项目突然全丢，大概率是上次保存时崩溃了，可以去备份目录找 projects.json.backup 恢复

为什么“Open in New Window”没反应？和 VSCode 多窗口策略冲突

VSCode 默认开启 window.openFoldersInNewWindow 后，Project Manager 的 Open in New Window 动作可能被拦截或静默吞掉。这不是插件 bug，而是 VSCode 底层窗口复用逻辑在起作用。

• 临时解决：关闭设置项 Window: Open Folders In New Window（设为 onClick 或 off）
• 更稳的做法：用 Project Manager: Open Project in New Window (Force) 命令，它绕过 VSCode 的窗口判断逻辑
• 注意：macOS 上如果启用了“在 Dock 中合并窗口”，即使开了新窗，任务栏图标也不会多一个，容易误判为没生效

想按语言/团队分类项目？别硬改 JSON，用 tags + 过滤更可靠

直接在 projects.json 里手工加字段（比如 "team": "backend"）看似灵活，但插件本身不读这些字段，后续升级还可能被覆盖。真正支持的扩展方式是 tags 数组，配合命令面板过滤使用。

• 编辑项目时，在 tags 字段填字符串数组，例如："tags": ["python", "internal"]
• 之后用 Project Manager: List Projects by Tags 就能筛选出所有带 python 的项目
• 别给 tag 加空格或特殊符号，"node js" 会被当成两个 tag；写成 "nodejs" 才能准确匹配

项目管理本身不难，难的是边界情况——比如某个文件夹同时属于两个 Git 仓库、或者软链接路径被识别成重复项目。这时候插件不会报错，只会随机留一个。真要管得细，得定期用 Project Manager: List All Projects 过一遍，比等它出问题再救快得多。