webstorm的todo工具窗口需手动唤出，mac按cmd+6、windows/linux按ctrl+6；若快捷键无效，需确认光标在编辑器内、文件未被excluded、目录已设为sources root，且正则模式已正确配置并等待索引完成。
怎么打开TODO工具窗口，快捷键为什么没反应
WebStorm的TODO列表不会自动弹出，必须手动唤出工具窗口，否则所有// TODO都只是普通注释，不聚合、不筛选、不高亮。
Mac按Cmd+6，Windows/Linux按Ctrl+6——这是唯一直接唤出的快捷键。别去菜单栏翻View → Tool Windows，效率低且容易点错。
- 按了没反应？先确认光标是否在编辑器代码区（比如不在终端、Git工具窗或设置页里）
- 窗口默认停靠在左下角；如果被关掉，可右键底部状态栏 →
TODO，或走View → Tool Windows → TODO - 刚加的
// TODO可能延迟几秒才出现——WebStorm在后台重建索引，不用手动刷新或重启 - 项目刚导入，或文件夹被标记为
Excluded（右键 →Mark as Excluded），里面的TODO永远不会被扫描到
自定义TODO标签（如// BUG）为什么不显示
WebStorm默认只识别TODO、FIXME、XXX（大小写不敏感），且仅对行注释//有效。/* TODO */块注释在非JS/TS文件中基本不识别。
路径：Settings / Preferences → Editor → TODO → Patterns → +（Alt+Insert），填正则如\bBUG\b：
-
\b是单词边界，防止匹配到BUGGED或DEBUG - Case sensitive建议不勾——协作时大小写混乱太常见
- 不要写
// BUG这种完整字符串——模式只管“内容”，注释语法由WebStorm自动处理 - JSX/TSX文件若没出现在TODO列表，检查
Settings → Editor → File Types中是否把它们归类到JavaScript files -
/** @todo */这类JSDoc注释默认不识别，得加正则：@todo\b
为什么有些TODO没出现在列表里
最常被忽略的是文件类型支持范围和索引状态——不是所有语言、所有注释形式都被一视同仁。
- 非JS/TS文件中写
/* TODO: xxx */（块注释）大概率不显示，但// TODO（行注释）通常可以 - 文件被标记为
Excluded后，里面的所有TODO都不会索引 - 刚添加的模式不会立即生效于已打开的编辑器标签页，需切换文件或稍等5–10秒等索引完成
-
node_modules、dist、.git这些目录默认被排除在索引外，里面的// TODO不会显示——这是对的，不用改 - 新建的
src/utils若没被WebStorm当源码根目录，那里的TODO也不会扫到；右键目录 →Mark Directory as → Sources Root
TODO太多怎么聚焦关键项
过滤器本质是“显示哪些已配置的Pattern”，不是文本模糊匹配。它解决的是信息过载，不是找错字。
在TODO工具窗口顶部点漏斗图标 → Edit Filters → Add，起名如Critical Only：
- 只勾选你定义的
BUG、FIXME、CRITICAL等Pattern，其他全取消 - 切回TODO窗口顶部下拉菜单，选刚建的过滤器——立刻只显示对应标签的行
- 不同过滤器可配不同图标（⚠️ 表
BUG，? 表REVIEW），靠视觉快速区分优先级 - 注意：过滤器无法按文件路径、作者、日期筛选；想带人名？得用Live Template自动生成
// REVIEW[alice]
真正容易被忽略的是作用域限制和索引滞后——哪怕正则写对了，文件没进Sources Root、或刚加完模式没等索引完成，都会导致“明明写了却看不到”。别急着重装，先看状态栏有没有Indexing…提示。
