Sublime Text 拼写检查卡顿源于全视图扫描注释/字符串,非 Bug而是设计限制;应禁用 word_wrap、highlight_line 等渲染项,仅对 .md/.txt 等非代码文件启用 spell_check,并用 Spell Check Comments 插件实现精准注释检查。

拼写检查开启后卡顿,是因为它在扫描整个视图文本
Sublime Text 的 spell_check 一开启,就会对当前视图所有被语法高亮标记为 comment、string 或 text.plain 的区域做实时词典匹配。大文件(比如 5MB+ 的 Markdown 文档或长日志)中大量注释或字符串会触发高频词干比对,CPU 占用飙升,编辑响应变慢,甚至光标移动都延迟。
这不是 Bug,是设计使然:它不区分“当前可见区域”和“全文”,也不做懒加载或分块处理。
- 关闭
word_wrap:自动换行会让拼写检查反复重算软换行位置,加剧卡顿 - 禁用
highlight_line和gutter:这两项本身不直接参与拼写,但它们的渲染开销叠加后会放大延迟感 - 避免在
.py、.js等代码文件中全局启用spell_check:变量名、函数名、API 路径(如teh_api_v2)会被误标,且每次右键Add to Dictionary都可能污染词典
只对注释启用拼写检查,必须用 Spell Check Comments 插件
原生 spell_check 没有“仅注释”模式,spelling_selector 参数虽能过滤作用域,但实际效果差——它无法精准识别 /* ... */ 中的纯注释内容,容易漏掉嵌套部分或误标中间的代码片段。
真正稳定的做法是装 Spell Check Comments 插件:
- 通过 Package Control 安装后即生效,无需额外配置
- 自动识别 Python、JS、C++、Java 等主流语言的单/多行注释语法,只在校验范围内运行词典匹配
- 字符串字面量(如
"recieve data")默认不参与检查,除非你手动选中并右键 →Spelling: Check Selection - 支持自定义用户词典路径,在插件设置里改
user_dictionary,可加入useState、__init__等技术术语防误报
词典路径写错会导致“标红线但无建议”,且完全静默失败
状态栏没出现 Spell Check 字样,说明拼写检查根本没跑起来;但如果已显示该标识,却右键看不到候选词、Add to Dictionary 灰掉,问题几乎肯定出在 dictionary 路径上。
Sublime 不报错、不提示、不 fallback,路径错一个字符就跳过加载:
- 正确写法只有这一种:
"dictionary": "Packages/Language - English/en_US.dic"(注意大小写、“-”、空格、斜杠方向,不能多也不能少) -
"en_US"、"en_US.dic"、"Packages/Language - English/dictionaries/en_US.dic"全部无效 - 验证方式:菜单 →
Preferences → Browse Packages…→ 进入Language - English/目录,确认存在en_US.dic(不是.aff或其他后缀) - macOS 用户若因权限问题加载失败,可把
en_US.dic复制到Packages/User/下,并设为"dictionary": "Packages/User/en_US.dic"
别在代码文件里配 syntax-specific spell_check
给 .py 或 .js 文件在 Settings – Syntax Specific 里加 "spell_check": true 是高风险操作。Python 语法包默认忽略该字段,但一旦你强行加上,它会把整个视图当作文本扫描——recieveData、initalize、teh_config 全被标红。
更麻烦的是,右键 Add to Dictionary 会把这些标识符加进用户词典,之后真拼错 receive 就永远漏检了。
合理做法是只对非代码类语法启用:
- 打开一个
.md或.txt文件 - 菜单 →
Preferences → Settings – Syntax Specific - 右侧加:
{"spell_check": true, "dictionary": "Packages/Language - English/en_US.dic"} - 这个配置只影响当前语法类型,
.py文件完全不受波及
复杂点在于:拼写检查的生效边界完全依赖语法定义和作用域标记,而不是文件后缀或用户直觉。哪怕你在 .py 文件里写了大段英文注释,只要语法高亮没把它归为 comment,它就不会被检查——这点很容易被忽略。











