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 导致界面毫无提示。这两类需求底层机制完全不同，强行混用只会浪费调试时间。