使用Atom Todo-show插件管理项目中的TODO标记

夏萱小哥_3301

夏萱小哥_3301

2026-07-09

863人浏览

原创

因为默认配置仅识别fixme、hack、note等关键词,未包含todo;需在插件settings中tags栏添加todo并取消大小写敏感选项,再手动刷新扫描。

使用atom todo-show插件管理项目中的todo标记

为什么Todo-show在Atom里搜不到TODO但能搜到FIXME

默认配置下,todo-show 只识别 FIXME、HACK、NOTE 这几类标记,TODO 被排除在外——不是插件坏了,是它故意没开。

解决方法很简单:打开 Atom 设置 → 插件 → 找到 todo-show → 点击「Settings」→ 在 Tags 输入框里把 TODO 加进去,多个用英文逗号分隔,比如:TODO,FIXME,HACK,NOTE。

  • 别漏掉大小写:默认匹配是大小写敏感的,todo 或 Todo 不会命中,除非你勾选了 Case insensitive
  • 如果项目里混用 // TODO 和 /* TODO */,不用额外配置,插件自动兼容单行/多行注释格式
  • 改完设置后不用重启 Atom,但得手动触发一次扫描(快捷键 ctrl-alt-t 或右键菜单选「Todo: Show」)

扫描范围总漏掉node_modules或dist目录

todo-show 默认会跳过常见构建产物和依赖目录,这是为了性能,不是 bug。但它用的是硬编码黑名单,不是靠 .gitignore 或 .eslintignore。

要让它扫 node_modules(比如你想查某个库源码里的 TODO),得进插件设置,找到 Exclude VCS Ignored Paths 和 Exclude Directories 两项:

  • 取消勾选 Exclude VCS Ignored Paths(否则它会读 .gitignore 并自动跳过 node_modules)
  • 在 Exclude Directories 输入框里删掉 node_modules(默认值通常是 node_modules,.git,coverage,dist)
  • 改完立刻生效,但已有缓存结果不会自动刷新,需要再按一次 ctrl-alt-t

点击列表项打不开对应文件或跳错行

常见现象:列表里显示 src/utils.js:42,点进去却停在第 1 行,或者直接打开空白窗口。

学习导航
学习导航

一款AI开发辅助工具,主要用于学习者优质的学习网址导航网站,适合需要提升相关任务效率的用户。

下载

根本原因通常是路径解析失败——尤其当项目根目录不是 Atom 当前工作区根目录时(比如你在子文件夹里双击打开 Atom)。

  • 确保 Atom 是从项目根目录启动的:atom .,而不是 atom src/
  • 检查文件是否已被删除或重命名,todo-show 不实时监听文件变更,旧缓存可能指向不存在的路径
  • 某些编辑器插件(如 project-manager)会干扰路径解析,可临时禁用测试
  • Windows 用户注意反斜杠:todo-show 内部用正则提取路径,如果日志里看到 src\utils.js 这种格式,建议统一用正斜杠或启用插件的 Use platform-specific path separator 选项

想让TODO带优先级或分类怎么加标签

todo-show 本身不支持语义化标签(比如 TODO(high)),但它能识别括号包裹的任意内容,只要在 Tags 里定义好就行。

例如,你想区分紧急和普通 TODO,可以这样写注释:

// TODO(urgent): refactor auth flow
// TODO(low): update README

然后在插件设置的 Tags 里填:TODO(urgent),TODO(low),FIXME。

  • 括号里不能有空格,否则匹配失败:TODO( high ) ≠ TODO(high)
  • 匹配是前缀式,TODO(urgent) 不会匹配 TODO,所以如果还想保留通用 TODO,得单独加上:TODO,TODO(urgent),TODO(low)
  • 颜色区分靠 Atom 主题,插件不控制样式;想高亮 urgent,得自己改主题 CSS 或装 highlight-selected 配合关键词

复杂项目里,靠人工维护 TODO 分类容易失效,真要分级管理,不如上专用工具(比如 Jira 或 Linear),todo-show 适合轻量、临时、开发中快速追踪。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c语言编程软件有哪些
c语言编程软件有哪些

c语言编程软件有GCC、Clang、Microsoft Visual Studio、Eclipse、NetBeans、Dev-C++、Code::Blocks、KDevelop、Sublime Text和Atom。更多关于c语言编程软件的问题详情请看本专题的文章。php中文网欢迎大家前来学习。

2023.11.02

8579

18

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

2026.10.22

0

15

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

2026.10.22

0

12

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理,讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

2026.10.22

0

16

剧云故事大纲与分场规划教程
剧云故事大纲与分场规划教程

本专题讲解剧云梗概与多级大纲功能,覆盖全局、分集、分场结构生成,以及主线冲突、剧情节点和场次顺序调整。

2026.10.22

0

15

VibeKnow PPT讲解视频教程汇总
VibeKnow PPT讲解视频教程汇总

本专题介绍VibeKnow PPT讲解模式的素材准备、旁白生成、页面节奏、画面呈现与导出设置,适合课程和培训场景。

2026.10.22

0

16

VibeKnow PDF转视频教程合集
VibeKnow PDF转视频教程合集

本专题围绕VibeKnow的PDF转视频功能,讲解文件准备、内容解析、脚本生成、重点可视化及配音字幕检查方法。

2026.10.22

0

12

二狗PPT模板与视觉设计
二狗PPT模板与视觉设计

本专题介绍二狗PPT的职场模板、主题风格与页面版式,覆盖模板切换、色彩选择、内容匹配和正式汇报场景下的视觉优化方法。

2026.10.22

0

13

php漏洞修复方法
php漏洞修复方法

PHP漏洞聚合专题,持续整理PHP最新高危漏洞、CVE安全预警、受影响版本、自查命令及修复方案,覆盖PHP-FPM、Docker、Ubuntu与Linux服务器环境,帮助开发者快速完成漏洞排查、版本升级和安全加固。

2026.10.22

20

31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.9万人学习