WebStorm中唤出TODO工具窗口的唯一可靠快捷键是Mac按Cmd+6、Windows/Linux按Ctrl+6；该窗口不会自动弹出，需手动触发，且仅扫描源码根目录下正确文件类型的行注释，自定义标签须配置正则（如\bBUG\b），过滤器仅按已配Pattern筛选，不支持路径/作者/日期过滤。
快捷键唤出TODO工具窗口是唯一可靠入口
WebStorm的TODO列表不会自动弹出，也不在侧边栏常驻。你必须手动触发，否则所有// TODO都只是普通注释，不聚合、不筛选、不高亮。
Mac用户按Cmd + 6，Windows/Linux用户按Ctrl + 6——这是唯一直接唤出TODO工具窗口的快捷键。别用Ctrl+Shift+Alt+T或Cmd+Shift+Option+T，那是旧版或误传，2026年主流版本已弃用。
- 按了没反应？先确认光标是否落在编辑器代码区（不在终端、Git面板或设置页里）
- 窗口默认停靠在左下角；若被关掉，可右键底部状态栏 →
TODO，或走View → Tool Windows → TODO - 刚加的
// TODO可能延迟1–3秒才出现——WebStorm在后台重建索引，不用手动刷新或重启
自定义标签如// BUG必须配正则，否则永不显示
WebStorm默认只识别TODO、FIXME、XXX（大小写不敏感），且仅对行注释//有效。// BUG或// REVIEW这类自定义标签，必须手动添加正则模式，否则永远扫不出来。
路径：Settings/Preferences → Editor → TODO → Patterns → +（Alt+Insert）
-
Pattern填\bBUG\b：\b是单词边界，避免匹配到DEBUG或BUGGY -
Case sensitive建议不勾——协作中大小写混乱太常见 - 不要写
// BUG这种完整字符串，模式只管“内容”，注释语法由WebStorm自动处理 - JSX/TSX文件若没出现在列表里，检查
Settings → Editor → File Types中是否把它们归类到JavaScript files
为什么有些// TODO就是不显示？三个硬限制最常踩坑
不是配置错，而是掉进了WebStorm的扫描规则盲区。90%的“没显示”问题都卡在这三点上：
-
node_modules、dist、.git这些目录默认被排除在索引外——里面的// TODO本就不该显示，别去改排除规则 - 新建的
src/utils如果没被标记为源码根目录，里面的TODO也不会扫到；右键目录 →Mark Directory as → Sources Root - 非JS/TS文件中写
/* TODO: xxx */（块注释）大概率不识别，但// TODO（行注释）通常可以；/** @todo */这类JSDoc注释默认不识别，得加正则：@todo\b
过滤器不是搜索框，是Pattern组合开关
TODO工具窗口顶部的漏斗图标（Filter）不是用来输关键词搜索的，它只控制“显示哪些已配置的Pattern”。想快速聚焦高优事项，得提前建好过滤器。
操作路径：TODO窗口顶部 → 漏斗图标 → Edit Filters → Add
- 起名如
Critical Only，只勾选你定义的BUG、FIXME、CRITICAL等Pattern，其他全取消 - 切回TODO窗口顶部下拉菜单，选刚建的过滤器——立刻只显示对应标签的行
- 不同过滤器可配不同图标（⚠️ 表
BUG，? 表REVIEW），靠视觉快速区分优先级 - 注意：过滤器无法按文件路径、作者、日期筛选；想带人名？得用Live Template自动生成
// REVIEW[alice]
真正容易被忽略的是索引范围和文件类型绑定——改完正则后，如果某个文件里的TODO仍不出现，先看它是不是被归类到了错误的File Type，再确认目录是否被标记为Sources Root。这两点不解决，调再多正则也没用。
