PhpStorm的TODO功能仅为代码注释高亮与聚合，非任务管理系统
开门见山地说，PhpStorm 的 TODO 功能并非一个完整的任务管理系统。它本质上是一个代码注释的“高亮显示器”和“聚合器”，帮你把散落在各处的特定标记找出来、集中展示。至于项目管理中常见的截止日期、任务指派、状态流转这些功能，它一概没有。理解这一点，是高效使用它的前提。
TODO 注释怎么写才被识别
想让 PhpStorm 认出你的待办事项，格式是关键。默认情况下，它只认准以 // TODO、// FIXME 和 // XXX 开头的单行注释，而且大小写不敏感。但有个细节必须注意：标记必须紧跟在 // 后面，中间不能有任何空格或其他字符。
- ✅ 正确示范：
// TODO 重构用户验证逻辑、// fixme 处理空数组异常 - ❌ 常见错误：像
// TODO: 重构…（冒号后多了空格）、/* TODO 登录超时处理 */（用了多行注释）、// todo（如果未启用大小写不敏感模式）这些写法，都可能不会被识别。 - ⚠️ 重要提示：当然，匹配规则可以在
Settings > Editor > TODO里自定义正则表达式。但修改前务必做好备份，一旦正则写错，可能会导致所有的 TODO 条目瞬间“消失”。
如何查看和筛选所有 TODO
写好注释后，怎么全局查看呢？答案就是 TODO 工具窗口，默认快捷键是 Alt+6。这里需要明确一个概念：这个视图展示的不是实时搜索结果，而是基于项目索引扫描出来的静态快照。
- 双击列表中的任何一项，就能直接跳转到对应的代码行，非常方便。
- 右键点击条目，可以选择「Show in Explorer」快速定位文件，或者「Remove from TODO list」临时隐藏它（这个操作只影响当前会话，并不会删除代码里的注释）。
- 窗口顶部的过滤栏支持按文件路径、模块或自定义标签进行筛选。不过，想用自定义标签（比如
@backend），你得先在TODO patterns里配置好带分组捕获的正则表达式，例如// TODO\((\w+)\):\s*(.*)，才能提取出括号里的标签。 - ⚠️ 排查重点：如果打开
TODO窗口却发现里面空空如也，首先检查是否勾选了「Show TODOs from non-project files」选项。如果这个选项没勾上，那么像 vendor、node_modules 这类目录下的 TODO 注释是不会显示出来的。
为什么改了注释但 TODO 窗口没更新
这是新手最常遇到的困惑：明明在代码里添加了 TODO，为什么列表里看不到？根本原因在于，TODO 视图依赖的是项目索引，而不是实时监听文件变化。问题通常出在以下几个方面：
立即学习“PHP免费学习笔记（深入）”；
- 索引未完成：如果 IDE 右下角显示「Indexing…」，那么 TODO 列表的更新就会滞后。耐心等待索引完成，或者手动触发
File > Reload project from Disk强制刷新。 - 文件未加入项目：单独打开的文件，如果不在当前项目的根目录下，是不会被纳入扫描范围的。
- 作用域设置错误：点击
TODO窗口右上角的漏斗图标，确认当前的作用域（Scope）是All Places，而不是Current File或某个自定义的受限范围。 - ⚠️ 关键一步：如果你修改了 TODO 的正则匹配模式，记得点击
Apply按钮来应用更改并触发重新扫描。只点OK是没用的。
说到底，技术操作本身并不复杂。真正的挑战在于，如何让整个团队对 TODO 的书写格式达成一致，并且建立起定期清理过期条目的习惯。一个无人维护的 TODO 列表，不出三个月，就会彻底沦为毫无用处的信息噪音。
