sublime text 默认不支持仅检查注释的拼写功能,需通过修改 word_separators 降低误报、安装 spellcheckcomments 插件实现注释内精准检查,或自定义颜色方案叠加 scope:comment 高亮拼写错误。

Sublime Text 默认不支持「仅检查注释」的拼写功能
它内置的拼写检查是全文档粒度的,无法按语法作用域(比如只对 comment)自动启用或高亮。想实现“精准纠错”,必须绕过默认行为,靠语法作用域 + 自定义设置组合实现。
用 spell_check 配合 word_separators 临时规避代码干扰
虽然不能真正隔离注释,但可以大幅减少误报:把编程常用符号加入分词分隔符,让拼写引擎更倾向把 function、return 这类词当整体跳过,而不是拆成 fun、ction 单独检查。
- 打开
Preferences → Settings - 在用户设置中添加:
"spell_check": true, "word_separators": "./\()"'-:,.;<>~!@#$%^&*|+=[]{}`~?" - 注意:这不会让拼写器“识别注释”,只是降低非注释区域的误标率
真正隔离注释需依赖插件 + 作用域匹配(推荐 SpellCheckComments)
社区插件 SpellCheckComments 是目前最接近需求的方案——它监听光标位置,只在当前行匹配 comment 作用域时触发检查,并用不同颜色高亮错误拼写。
- 通过
Package Control → Install Package → SpellCheckComments安装 - 安装后默认启用,无需额外配置;若失效,确认当前文件语法高亮正确(如
.py文件用了 Python 语法,而非 Plain Text) - 该插件不修改原文件,只做只读提示;不支持右键快速替换,需手动编辑
- 兼容性注意:Sublime Text 4 要求插件更新到 v2.0+,旧版可能报
AttributeError: 'NoneType' object has no attribute 'match'
自定义高亮规则(进阶):用 scope:comment 配合颜色方案
如果只想视觉上“看到”哪些拼写错误发生在注释里(而非实时检查),可手动扩展颜色方案,为拼写错误且位于 comment 中的单词加特殊背景色。
- 复制当前配色方案(
Preferences → Color Scheme显示路径),用 Sublime 打开该.sublime-color-scheme文件 - 在
rules数组末尾追加:{ "name": "Spelling error in comment", "scope": "markup.underline.spell.grammar, markup.underline.spell.grammar comment", "foreground": "#ff3333", "background": "#ff333320" } - 保存后重启 Sublime;此方式依赖编辑器已标记出拼写错误(即
spell_check: true),再叠加作用域过滤
真正难的是作用域嵌套场景——比如 Python 的 docstring 被识别为 string.quoted.double.python 而非 comment,这时候插件或配色规则都会漏掉。得去查对应语言的.sublime-syntax文件,确认注释的实际 scope 名称。










