重置用户设置不能解决TODO高亮异常,因TODO高亮由Highlight或TodoReview等插件独立驱动,其配置位于Package Settings或.todocofnig文件中,而非Preferences.sublime-settings;该文件仅控制缩进、字体等编辑行为,不参与语法着色或关键词标记。

重置用户设置不能解决TODO高亮异常——问题几乎从不发生在用户设置本身,而是出在插件配置、scope绑定或正则匹配逻辑上。
为什么重置 Preferences.sublime-settings 没用
Sublime Text 的 Preferences.sublime-settings 只控制编辑器行为(如制表符宽度、自动换行),不参与语法高亮或关键词标记。TODO 高亮由插件(如 Highlight 或 TodoReview)驱动,它们的配置独立存在:
-
Highlight的规则全在Package Settings → Highlight → Settings - User里 -
TodoReview的扫描逻辑依赖.todoconfig文件 + 项目打开方式 +file_extensions配置 - 重置主设置只会让你重新配缩进、字体大小,对高亮零影响
高亮失效时该检查哪几个地方
先别删配置,按顺序快速验证这四点:
- 光标停在
TODO上,按Ctrl+Shift+P→ 输入Developer: Show Scope Name,确认显示的是comment.line.double-slash类 scope —— 如果是string.quoted或source,说明它没被识别为注释,scope: "comment"就必然不生效 - 在
Highlight用户配置中,regex必须写成"\b(TODO|FIXME)\b"(双反斜杠),JSON 字符串里单个会被吃掉 - 检查是否误把
style设为"outline"或"solid_underline":部分主题下这些样式极淡甚至不可见,改用"fill"最稳 - 如果用了
TodoReview,打开命令面板输TodoReview: Find TODOs in project—— 若无响应,99% 是没通过File → Open Folder…打开项目,或根目录缺.todoconfig
真要“重置”,只该动哪几处文件
所谓重置,其实是清理干扰项,不是格式化整个配置体系:
- 删掉
Packages/User/Highlight.sublime-settings,重装插件后重新粘贴最小可用配置(只留一个highlights数组) - 删掉项目根目录下所有
.todoconfig.*变体,只留空的.todoconfig(注意没有扩展名) - 检查
Packages/User/下有没有自定义语法文件(如JavaScript-TODO.sublime-syntax),临时重命名它,排除 scope 提升冲突 - 别碰
Preferences.sublime-settings、Color Scheme或Theme文件——它们和 TODO 是否高亮无关
最常被忽略的点:正则里的 在 JSON 中必须双写,且 scope 必须精确匹配注释类型;很多人改完配置不重启 Sublime,但 Highlight 插件需要手动触发一次重载(关掉再开设置文件即可)。

















