alt+6无反应不是快捷键失效,而是todo窗口依赖索引状态和作用域设置:需确认右下角是否正在索引、scope是否设为all places、show todos from non-project files是否关闭,并在修改设置后点击apply且重新打开todo窗口。

Alt+6 是打开 TODO 列表的默认快捷键,但按了没反应?先确认三件事
不是快捷键失效,而是 TODO 窗口依赖索引状态和作用域设置。常见现象是:写了 // TODO 却点 Alt+6(macOS 为 Cmd+6)后一片空白。
- 右下角是否显示
Indexing…?等待完成或手动执行File > Reload project from Disk - TODO 窗口右上角漏斗图标里,
Scope是否设成了Current File?要查全项目,必须选All Places或自定义合理范围 -
Show TODOs from non-project files是否勾选?勾选后vendor/和node_modules/的第三方注释会混入,干扰判断,建议关闭
Ctrl+Alt+T 跳转下一个 TODO,但光标位置影响实际效果
这个快捷键不依赖窗口是否打开,但对当前编辑器焦点敏感:光标必须在代码编辑区,不能落在搜索框、侧边栏或空行注释上。
- Windows/Linux:
Ctrl+Alt+T→ 下一个;Ctrl+Shift+Alt+T→ 上一个 - macOS:
Cmd+Option+T→ 下一个;Cmd+Shift+Option+T→ 上一个 - 如果跳转后“看不见”目标行,可能是光标停在空行或缩进行——按
Home或End确认位置再试 - 首次使用前,建议先按
Alt+6打开 TODO 窗口,触发一次完整扫描,后续跳转才稳定
自定义 TODO 模式后,为什么新注释还是不显示?
改了正则却无效,90% 是因为没点 Apply 或没重启扫描。PhpStorm 不会自动重载规则,也不实时监听文件变更。
- 路径:Settings > Editor > TODO(macOS 为 Preferences > Editor > TODO)
- 新增 Pattern 示例:
\b(todo|待办|fixme):?\b,务必勾选Case insensitive - 改完必须点
Apply(仅点OK不生效) - 然后关掉再按一次
Alt+6,强制重新扫描索引 - 颜色别忘设——否则编辑器里不加亮,你根本注意不到自己写的
// todo
TODO 注释格式写错,比没写还麻烦
默认规则只匹配特定结构,小写、冒号粘连、多行注释、空格错位都会导致静默失败。
- ✅ 正确:
// TODO 实现登出逻辑、// FIXME 处理空数组、/* TODO: 注意SQL注入 */ - ❌ 无效:
// todo:(小写且无空格)、//TODO(urgent)(冒号前无空格)、// TODO-xxx(连字符非默认分隔符) - ⚠️ 特别注意:
// TODO:后面必须跟空格,写成// TODO:修复在部分版本中不触发索引 - 多行注释里用
TODO可以,但必须每行都带//前缀,/*块内写TODO默认不识别
真正卡住人的不是快捷键记不住,而是改了注释、配了正则、点了 Apply,却忘了关掉再开一次 Alt+6 窗口——它不会自己刷新。索引机制和作用域设置才是实际生效的门槛。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










