project manager 的 tags 字段需手动配置为字符串数组（如["fe", "vue"]），右键编辑项目或修改 projects.json，拼写必须为 tags；筛选需通过“list projects to open”命令输入标签名实时匹配，区分大小写且支持空格分隔多关键词；常见失效原因：rootpath 失效、json 格式错误、未执行 reload projects。
Project Manager 的标签不是自动识别的，必须手动编辑项目配置
插件本身不扫描文件内容或目录结构来打标签，tags 字段完全由你填写，且只在「编辑单个项目」时生效。右键项目 → Edit Project 才能加，不能批量设置；直接改 projects.json 也行，但得确保字段名拼写是 tags（不是 tag 或 label），值为字符串数组。
常见错误现象：输“frontend”搜不到项目，其实是填了 "tag": "fe"（少了个 s）或者用了对象格式 {"fe": true} —— 这两种都会让插件忽略该字段。
-
tags值必须是数组，例如["fe", "vue", "prod"] - 多个标签用英文逗号分隔只是视觉习惯，实际无效；必须写成数组格式
- 标签内容区分大小写，“Vue” 和 “vue” 是两个不同标签
- 修改后需执行
Project Manager: Reload Projects或重启 VSCode 才生效
按标签筛选项目列表，得先打开筛选面板再输入关键词
默认点击侧边栏项目图标只显示全部项目，不会触发标签过滤。必须主动唤出筛选界面：Ctrl+Shift+P → 输入 Project Manager: List Projects to Open，弹出列表后，**立刻开始输入标签名**（比如 fe），它会实时匹配 tags 数组里的任意一项，而非项目名。
容易被忽略的一点：筛选是“包含匹配”，不是“前缀匹配”。所以填了 ["backend", "auth"]，输 auth 能出来，输 back 也能出来；但输 be 就不行 —— 因为 be 不在任一标签字符串里。
- 支持空格分隔多关键词，例如输
fe vue会同时命中含这两个标签的项目 - 中文标签可用，但别混用全角/半角空格，否则匹配失败
- 如果列表里没反应，先检查是否误触了键盘布局（比如切换到中文输入法后输的是全角字符）
想用标签做分组标题？得配合 projectManager.groupProjectsByFirstSegment
这个设置和 tags 无关，它是靠项目 name 字段的冒号前缀来分组的。比如把项目名设为 fe: dashboard、be: api-gateway，再开启该设置，列表就会出现「fe」「be」两个分组标题。
别指望用 tags 实现同样效果 —— 插件目前没有「按标签生成分组标题」的功能。有人试过在 name 里硬塞标签如 [vue] admin，结果只是让名字变长，分组逻辑仍按第一个 : 切分。
- 设置路径：
Ctrl+,→ 搜groupProjectsByFirstSegment→ 勾选 - 分组名不支持空格或特殊符号，
fe v2会被截成fe v2（整个当一组），但fe:v2会被截成fe - 已存在的项目名没冒号，就不会进任何分组，统一归到“Other”下
标签搜索失效的三个高频原因
最常卡住人的不是不会填，而是填了却搜不到。核心就三点：路径失效、JSON 格式错、插件缓存没刷新。
-
rootPath对应的目录被移动或删了，插件仍保留记录，但搜索功能会静默降级——列表能显示，筛选却无响应 -
projects.json里多了一个逗号、少了一个引号，或用了中文引号“”，VSCode 不报错，但插件读取失败，tags全丢 - 改完 JSON 后没运行
Project Manager: Reload Projects，旧缓存还在，新标签根本没加载
真正麻烦的地方在于：这三类问题都不会弹红框报错，只会让你对着空白列表反复怀疑输入法、键盘、甚至 VSCode 版本。建议每次加完标签，立刻用命令面板搜一遍自己刚填的词，有响应才算落地成功。
