Highlight插件的TODO高亮配置位于Packages/User/Highlight.sublime-settings文件中,需手动添加含(TODO|FIXME)正则及"scope":"comment"等字段的JSON规则,且必须通过符号链接或Git同步该文件,而非仅同步插件目录。

TODO高亮配置不能靠“同步插件”实现,它本质是Highlight插件的User Settings文件,必须随Packages/User目录一起备份或符号链接,否则换电脑就失效。
Highlight插件的TODO高亮配置存在哪?
它不是插件自带的默认行为,而是你手动写进Preferences → Package Settings → Highlight → Settings - User里的JSON内容。这个文件真实路径是:Packages/User/Highlight.sublime-settings。
常见错误是只装Highlight插件、不写配置,或写了但没保存到User Settings——插件默认不启用任何高亮规则。
- 配置必须放在
Highlight.sublime-settings里,不是Settings - Default(改Default会被插件更新覆盖) - 正则必须带单词边界
(TODO|FIXME),且在JSON中要写成\b(双反斜杠) -
"scope":"comment"不能省,否则会误匹配字符串里的"TODO_API" - 别用
style":"outline",它在部分主题下不可见;"fill"或"underline"更可靠
同步时为什么不能只复制Highlight插件目录?
因为Packages/Highlight/目录里只有插件逻辑,不包含你的个性化规则。所有用户定义的高亮都落在Packages/User/下——这是Sublime唯一认可的“可移植配置层”。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
如果你把Highlight.sublime-settings留在旧电脑,新电脑即使装了Highlight,打开文件也看不到任何TODO背景色。
- 同步范围必须包含:
Packages/User/Highlight.sublime-settings+Packages/User/Preferences.sublime-settings(确保字体、缩进等基础显示正常) - 不要同步
Packages/Highlight/本身——插件可通过Package Control重装,且不同系统版本可能有兼容性差异 - 如果用了自定义颜色值如
"color":"hsl(48, 100%, 85%)",注意hsl在部分老主题里渲染异常,建议优先用hex如"#ffeb3b"
跨平台同步Highlight.sublime-settings要注意什么?
Windows和macOS/Linux对路径分隔符、换行符、JSON空格容忍度不同,直接拷贝可能让Sublime加载失败并静默忽略该文件。
最稳做法是:用Git管理Packages/User/目录,并在提交前检查文件末尾无BOM、换行符为LF、JSON语法合法(可用jq . Highlight.sublime-settings验证)。
- 避免在Windows上用记事本编辑后保存为UTF-8 with BOM——Sublime会拒读
- macOS用户若用TextEdit保存,务必选“Plain Text”模式,否则自动转成RTF
- 如果同步后高亮消失,先检查Sublime控制台(
Ctrl+`)是否有error loading syntax file或invalid json报错 - 别依赖云盘自动同步整个
Packages目录——里面混着缓存、Session、.cache等运行时文件,会破坏插件状态
真正可靠的同步,从来不是“让配置跟着人走”,而是“让人跟着配置走”:用符号链接把Packages/User指向一个Git仓库或云盘同步文件夹,删掉本地冗余副本。否则每次换设备,你都在重复解决\b少写一个反斜杠、scope拼错成commment这种低级但致命的问题。

















