phpstorm默认识别全大写todo、fixme、xxx后接冒号或空格的注释;快捷键ctrl+alt+t(win/linux)或cmd+option+t(macos)可跳转,需确保todo窗口已激活并完成扫描;支持自定义正则模式与作用域过滤。
todo注释在phpstorm里默认就生效,但得写对格式
phpstorm 识别 todo 不是靠插件,而是内置的“todo 工具窗口”自动扫描匹配正则。关键不是加不加,而是怎么写才被认出来。
常见错误是写成 // todo: xxx 或 // TODO-xxx —— 默认规则只认全大写 TODO、FIXME、XXX 开头,且后面紧跟冒号或空格(中间不能有换行或缩进干扰)。
-
// TODO 实现用户登出逻辑✅ 被识别 -
// todo: 修复时间戳偏移❌ 小写不匹配,默认规则不触发 -
/* TODO: 注意SQL注入 */✅ 多行注释里也有效 -
//TODO(无空格)❌ 冒号前必须有空格,否则部分版本可能漏掉
用快捷键快速跳转到下一个TODO,比翻文件快得多
手动搜 TODO 字符串太慢,PhpStorm 提供了原生导航支持。只要注释格式正确,就能用快捷键逐个跳转,不用打开工具窗口也能推进进度。
- Windows/Linux:
Ctrl+Alt+T(不是Ctrl+T)→ 跳到下一个 TODO - macOS:
Cmd+Option+T - 反向跳转:加
Shift键,即Ctrl+Shift+Alt+T/Cmd+Shift+Option+T - 注意:光标必须在代码编辑区,不在搜索框或侧边栏时才生效
这个快捷键依赖“TODO 工具窗口”的扫描状态。如果刚改完注释却跳不到,先按 Alt+6(macOS Cmd+6)打开 TODO 窗口,它会自动触发一次重新扫描。
自定义TODO模式:支持小写todo、中文标签、项目专属关键词
默认只认英文大写,但团队协作中常需要 // todo: 或 // 待办:。PhpStorm 允许添加自定义模式,但配置位置藏得有点深,容易设错范围。
- 路径:
Settings > Editor > TODO(macOS 是Preferences > Editor > TODO) - 点
+新增模式,Pattern 填正则,比如:\b(todo|待办|fixme):?\b - 勾选
Case insensitive才能匹配小写todo - 别忘了给新规则设颜色(Color),否则在编辑器里看不到高亮
- ⚠️ 重点:修改后需重启扫描——关闭再重开 TODO 窗口(
Alt+6关 → 再按一次开),否则旧缓存还在
TODO窗口里筛选和分组,避免被测试代码里的临时标记刷屏
默认 TODO 窗口把整个项目所有匹配项堆一起,但实际只想看当前模块或某人留的待办。它支持按作用域、文件类型甚至正则过滤,但入口不明显。
- 打开
Alt+6后,右上角点漏斗图标(Filter),可选Scope(比如只看src/下) - 点齿轮图标 →
Configure Filters,能按文件后缀排除*.test.php或vendor/** - 想临时隐藏某类 TODO?右键某条目 →
Remove from TODO view(只是视图隐藏,不删注释) - 性能提示:大项目开启正则过滤后首次扫描稍慢,后续编辑实时更新无压力
真正麻烦的是跨分支协作:A 分支加的 // FIXME 在 B 分支没配置对应模式,就会看不见。团队统一导出/导入 TODO 设置(File > Manage IDE Settings > Export Settings)比口头约定靠谱。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










