PhpStorm的TODO功能仅聚合匹配正则的注释供手动查看跳转，不具进度管理能力；需正确配置作用域、正则模式及索引状态才能精准显示自定义待办项。
PhpStorm 的 TODO 功能不是进度管理工具，它不统计完成率、不跟踪状态、不关联责任人——它只做一件事：把符合正则的注释聚合出来，供你手动查看和跳转。
为什么 TODO 窗口显示的条目和你预期不符
常见现象是：刚加了 // TODO 注释却没出现在 Alt+6 列表里；或者 vendor 目录下的第三方 TODO 也混进来了，干扰判断。
- 索引未就绪：右下角显示
Indexing…时，TODO 视图不会实时更新；可手动执行File > Reload project from Disk - 作用域设成了
Current File或自定义范围，但你实际想看整个项目 —— 点击 TODO 窗口右上角漏斗图标，确认 Scope 是All Places - 第三方代码（如
vendor/、node_modules/）被纳入扫描：默认开启Show TODOs from non-project files，关闭它即可过滤掉外部依赖里的 TODO
如何让 TODO 只显示自己代码里的待办项
关键不是“过滤掉 vendor”，而是“只包含 src/ 或 app/ 这类你真正维护的目录”。直接改作用域比靠正则硬拦更可靠。
- 打开
Alt+6→ 点右上角漏斗图标 →Filter→ 选Scope Based - 点击
Configure（齿轮图标）→+ Add Scope→ 命名如My Code - Pattern 填
file:src/**/*.*;file:app/**/*.*;file:core/**/*.*（按你实际目录结构调整） - 保存后，在 TODO 窗口顶部下拉菜单中切换到这个新 Scope
注意：file: 前缀必须写全，路径用双星号通配，不能写成 src/**（少 /*.* 会导致匹配失败）
立即学习“PHP免费学习笔记（深入）”；
自定义 TODO 标签并提取上下文（比如 @backend 或 (urgent)）
默认模式只能识别 // TODO，但团队协作中常需要区分优先级或模块归属。这得靠正则分组，且必须启用“Show as tree”才能展开分组内容。
- 进入
Settings > Editor > TODO→ 点+新增 Pattern - 填正则：
// TODO\((\w+)\):\s*(.*)（匹配// TODO(backend): 重构登录流程） - 勾选
Case insensitive和Group by pattern - 在 TODO 窗口右键 →
View Options > Show as tree，就能看到按括号内标签分组的结构
⚠️ 修改正则后必须点 Apply（不是 OK），否则扫描逻辑不会刷新；而且如果正则写错（比如漏转义括号），整条规则会静默失效，导致对应注释完全消失
快捷键跳转和日常维护的真实成本
Ctrl+Alt+T（Win）或 Cmd+Option+T（macOS）能逐个跳转 TODO，但前提是光标在编辑器内、且该注释已被索引收录。很多人卡在这一步却不知道原因。
- 跳转失败？先按一次
Alt+6打开 TODO 窗口，触发强制重扫 - TODO 越来越多却没人处理？这不是工具问题，是流程问题 —— 每次 PR 合并前应清空本次修改涉及的 TODO，否则三个月后列表里 80% 是过期噪音
- 别依赖颜色高亮判断优先级：所有 TODO 默认同色，要区分 urgent / refactor / test，必须为每类新建独立 Pattern 并分配不同颜色
真正难的从来不是怎么配置，而是让所有人写 // TODO(backend): ... 而不是 // todo:...，并且每周花五分钟删掉已解决或已废弃的条目。
