Todo Show 插件仅扫描符合格式的注释（如 // TODO），不自动提取或持久化任务；需正确配置项目路径、关键词大小写及语法包兼容性，且不支持任务状态管理。

Todo Show 插件在 Atom 中不能直接“收集”待办事项——它只扫描文件中符合格式的注释（如 // TODO、/* TODO */），不自动提取或持久化任务，也不支持跨项目统一管理。

插件安装后为什么看不到任何 TODO？

常见原因是未正确配置扫描范围或注释格式不匹配。Todo Show 默认只扫描当前打开的项目根目录，且严格识别特定前缀。

• 确认项目已通过 File → Add Project Folder 添加到 Atom，而非仅打开单个文件
• 注释必须以 TODO、FIXME、NOTE 等大写关键词开头，中间用冒号或空格分隔，例如：// TODO: 修复登录超时逻辑，而 // todo: … 或 // todo … 不会被识别
• 检查插件设置：打开 Atom → Preferences → Packages → todo-show → Settings，确认 Base Path 为 project（不是 current），并勾选 Scan on Startup

如何让 Todo Show 支持自定义关键词（比如 HACK 或 REVIEW）？

默认关键词列表固定，但可通过修改插件配置扩展。修改后需重启 Atom 才生效。

• 打开 Atom → Config…，在 "todo-show" 配置块内添加 "keywords" 数组
• 示例配置片段：

  "todo-show": {
    "keywords": [
      "TODO",
      "FIXME",
      "HACK",
      "REVIEW"
    ]
  }
  

• 注意：新增关键词必须全大写，且不能含空格或特殊符号；大小写敏感，"hack" 无效

点击列表项无法跳转到对应代码行？

这是 Atom 权限或路径解析问题，不是插件本身故障。

• 确保文件未被 Atom 缓存为只读状态（右下角查看是否显示 Read-only）
• 如果项目路径含中文或空格，Todo Show 可能解析失败——尝试将项目移到纯英文无空格路径（如 /Users/name/project/）
• 部分语法包（如 language-babel）会干扰行号定位，可临时禁用测试；若恢复跳转，则需在该语法包设置中启用 Enable Scope Map

Todo Show 的本质是“实时快照”，不是任务看板。它不保存状态、不支持标记完成、不关联优先级或截止时间——所有管理动作都得靠你手动删掉对应注释或换行加 // DONE 这类非标准标记，后者也不会被识别。