中文注释中TODO高亮失效的根本原因是作用域(scope)未设为comment及正则缺少边界,而非编码问题;正确配置Highlight插件并指定"scope":"comment"和"\b(TODO|FIXME)\b"即可解决。

Sublime 中文注释里的 TODO 高亮,关键不是“能不能显示中文”,而是“能否正确匹配到注释作用域”。只要正则写对、scope 设准,中文注释里的 TODO 和英文一样能高亮,不需额外编码设置。
为什么中文注释里的 TODO 常常不亮?
根本原因不是编码问题,而是匹配范围错了。默认情况下,TODO 出现在中文注释里(比如 // 这里要重构 TODO)时,它仍属于 comment 作用域,但很多高亮配置漏掉了这个前提:
-
scope没设成comment,而是用了空值或source——结果会误匹配字符串、变量名甚至 JSON 字段名 - 正则没加
(单词边界),导致TODO_LIST、TODOX全被拉进来,Sublime 正则引擎在大文件里容易卡住 - 用了
.或.*这类贪婪表达式,而 Sublime 的 PCRE 引擎不优化回溯,一卡就是几秒 - 配置写在
Settings - User里,但插件实际只读Package Settings → Highlight → Settings - User
用 Highlight 插件配中文注释 TODO 高亮
这是最稳的路径,5 分钟内生效,不依赖语法文件、不改主题、不重启:
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 安装Highlight - 再按
Ctrl+Shift+P→ 输入Preferences: Highlight Settings – User - 填入以下配置(注意双反斜杠是 JSON 转义必需):
{
"highlights": [
{
"name": "chinese-todo",
"scope": "comment",
"regex": "\b(TODO|FIXME)\b",
"style": "fill",
"color": "hsla(48, 100%, 85%, 0.7)"
}
]
}
重点说明:
-
scope必须是comment,不是comment.line或comment.block——后者太具体,很多中文注释语法没细分到那么深 -
\b是必须的,单个在 JSON 里会被吃掉,变成无效转义 -
style: fill比underline更可靠:下划线在某些字体/缩放比例下会断开或看不清 - 颜色用
hsla()带 alpha,避免和暗色背景打架;纯#FFD700在深色主题下可能刺眼
UTF-8 编码设置只是基础,不是高亮开关
Sublime Text 3 默认就是 UTF-8,绝大多数中文注释都能正常读取。如果你发现中文注释本身乱码(比如显示成 ),才需要检查编码:
- 打开
Preferences → Settings(右侧用户设置) - 确认有这一行:
"default_encoding": "UTF-8" - 如果文件已乱码,可尝试右键 →
Reopen with Encoding → UTF-8,再保存 - 别动
fallback_encoding:它只影响无法识别编码的旧文件,对现代项目基本无用
真正影响高亮的,从来不是编码,而是你有没有让 TODO 被识别为注释内容——这点比编码设置重要十倍。
最容易被忽略的一点:高亮规则一旦写错 scope 或正则,Sublime 不报错也不提示,只是“静默失效”。光标停在 TODO 上,看状态栏是否显示 regex match,没显示就说明根本没命中——别猜,先验证。











