如何通过PHPStorm内置的TODO管理器高效统计项目进度与使用哪些管理工具？

本文共计990个文字，预计阅读时间需要4分钟。

PhpStorm的TODO功能主要用于标记代码中的待办事项或注释，它并非用于进度管理。通过设置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:...，并且每周花五分钟删掉已解决或已废弃的条目。