Sublime Text 默认不识别 TODO/FIXME,需启用内置 todo 插件并配置 keywords、regex 及 symbol_index_files 才能实现高亮与 Goto Symbol 支持。
Sublime Text 默认不识别 TODO/FIXME,需手动启用语法高亮
Sublime Text 本身不把
或
当作特殊标记处理,它们只是普通注释文本,不会加粗、变色或出现在 Goto Symbol(
)里。要让它们“活起来”,得靠内置的
插件——但它默认是禁用的。
启用 todo 插件并确认语法作用域匹配
Sublime 的
插件依赖当前文件的语法定义(如
、
)是否声明了注释作用域(
或
)。多数主流语法都支持,但部分自定义或老旧语法包可能漏配。
打开
填入最小必要配置:
保存后重启 Sublime(插件加载在启动时完成,改配置后不重启常无效)
检查当前文件右下角语法名(如
),再按
输入
试试——如果换成纯文本后高亮消失,说明原语法支持正常;若仍不亮,可能是语法包本身没导出注释 scope
自定义关键词或调整正则匹配范围
默认只识别
、
、
和
,且要求全大写、冒号后带空格(如
)。不匹配就看不到高亮。
仿Sublime和notepad++编辑器效果
仿Sublime和notepad++编辑器效果
下载
在
中扩展关键词:
若想匹配小写或混合大小写,改
(注意转义):
避免过度宽松:比如用
会误标变量名含
的行(如
),导致高亮污染
Goto Symbol(Ctrl+R)里不显示 TODO?检查 symbol list 配置
即使高亮正常,
默认也不索引 TODO 行——这是独立功能,需额外开启。
打开
加入:
(按需增减后缀)
确保
插件的
为
(新版默认开启,旧版可能需显式设)
首次启用后需等待索引完成(状态栏左下角显示 “Indexing…”),期间
查不到新条目
真正麻烦的是跨项目符号索引:Sublime 不像 VS Code 那样自动扫描整个工作区的 TODO,它只索引已打开的文件 + 符合
规则的路径。关掉的文件、子目录里的未打开文件,都不会进
列表。
TODOFIXMECtrl+Rtodotodosource.pythonsource.jscomment.linecomment.blockPreferences → Package Settings → Todo → Settings – User{
"todo": {
"enabled": true,
"highlight": true
}
}PythonCtrl+Shift+PSet Syntax: Plain TextTODOFIXMEXXXHACK// TODO: fix thisPackage Settings → Todo → Settings – User"keywords": ["TODO", "FIXME", "NOTE", "BUG", "HACK"]regex"regex": "(?i)\b(TODO|FIXME|NOTE|BUG|HACK)\b[:\s]*".*TODO.*todoconst todoList = [];Ctrl+RPreferences → Settings – User"index_files": true,
"index_workers": 4,
"symbol_index_files": ["*.py", "*.js", "*.ts", "*.html", "*.css"]todotodo_symbol_listtrueCtrl+Rsymbol_index_filesCtrl+R