Atom本身不内置TODO管理能力,需组合language-todo(高亮)与todo-show(全局搜索)分别实现注释着色和跨文件扫描;language-todo是基础依赖,要求文件语法正确识别且冒号后有空格,todo-show需配置ignoreThesePaths等关键项以避免卡顿。

Atom 本身不内置 TODO 管理能力,但通过组合使用 language-todo(高亮) + todo-show(全局搜索)或 tasks(独立任务文件管理),就能覆盖代码内注释追踪和本地待办清单两类核心需求。选错插件类型,比如用 tasks 去找源码里的 // TODO:,会完全没反应。
如何让 // TODO: 在 Atom 中高亮显示
必须装 language-todo,它不是可选增强,而是基础依赖。没有它,todo-show 能搜到内容,但编辑器里不会变色、不带图标、无法快速识别。
-
language-todo会自动识别// TODO:、/* FIXME */、# HACK等 10+ 种前缀,不区分大小写,但要求冒号后有空格(// TODO: fix this✅,// TODO:fix this❌) - 它不修改文件,只做语法着色,所以和任何语言插件(如
language-javascript)共存无冲突 - 如果你发现高亮失效,先检查当前文件是否被 Atom 正确识别为对应语言(右下角状态栏显示 “JavaScript” 而非 “Plain text”)
如何全局搜索项目中所有 TODO 注释
用 todo-show,它是唯一能跨文件扫描并聚合结果的插件。它不解析语法树,而是正则匹配,速度快但依赖路径配置。
- 默认快捷键:
Alt + Shift + T(Windows/Linux)或Cmd + Shift + T(macOS) - 关键配置项在 Settings → Packages →
todo-show→ Settings 里:-
findTheseTodos:数组形式,如["TODO", "FIXME", "BUG"],删掉不需要的能减少误报 -
ignoreThesePaths:务必填["node_modules", ".git", "dist"],否则搜索卡死 -
autoRefresh关闭更稳——保存文件后手动按一次快捷键,比自动触发更可控
-
- 搜索结果点击可直接跳转到行,但双击不会自动打开文件(需单击 + 回车),这是常见操作预期偏差
如何像 PlainTasks 那样写独立 .todo 文件管理任务
用 tasks 插件,它专为 .todo 或 .taskpaper 文件设计,不是用来处理源码注释的。
- 新建文件,扩展名必须是
.todo(不能是.txt或无后缀),否则插件不激活 - 支持标准 PlainTasks 语法:
(A) 买咖啡 @today、- [x] 已完成、=== Archive ===归档区 - 常用快捷键:
-
Ctrl + Enter(Win/Linux)或Cmd + Enter(macOS):新增未完成任务 -
Ctrl + D/Cmd + D:切换完成状态 -
Ctrl + Shift + A/Cmd + Shift + A:把已完成项移到=== Archive ===下
-
- 注意:它不读取代码文件里的 TODO,也不和
todo-show共享数据,两者完全隔离
真正容易被忽略的是场景混淆:有人装了 tasks 却想让它高亮 // TODO,或开了 todo-show 却没配 language-todo 导致界面毫无提示。这两类需求底层机制完全不同,强行混用只会浪费调试时间。

















