Sublime Text原生不支持代码拼写检查,仅对注释和字符串做基础校验;开启spell_check需在语法专属设置中配置正确dictionary路径,状态栏显示“Spell Check”为唯一生效依据。

Sublime Text 本身不提供代码拼写检查——它默认只对注释和字符串做基础拼写校验,且不识别变量名、函数名、关键字等代码上下文。想靠它“写出零拼写错误的代码”,必须手动配置词典、禁用误报、并明确区分哪些内容该查、哪些不该查。
为什么 spell_check 开了却没反应?
默认情况下,Sublime 的拼写检查是关闭的;即使开启,也只作用于当前视图的语言模式(syntax)所允许的范围。比如在 Python 文件中,spell_check 默认只检查 string 和 comment scope,跳过所有代码逻辑部分。
- 确认已启用:
"spell_check": true写在用户设置(Preferences → Settings)里 - 检查当前文件是否绑定了支持拼写的语法:右下角显示
Plain text或Markdown才最可能触发;Python、JavaScript等需额外配置spelling_selector - 若用的是
Package Control安装的第三方插件(如AutoFileName),它们可能覆盖或禁用原生拼写行为
spelling_selector 怎么写才不误标 className?
这个设置决定哪些语法 scope 被送进拼写引擎。写得太宽(比如 "*")会导致 fetchUserById、XMLHttpRequest 全被标红;写得太窄(比如只留 string)又漏掉文档字符串里的错字。
- 推荐最小可用组合:
"spelling_selector": "text.html -source, string, comment, meta.tag" - 在 Python 中想检查 docstring?加
meta.docstring.python;但要排除变量名,就绝不能包含variable或entity.name - 中文项目慎用:Sublime 内置词典不支持中文分词,
用户管理模块会被整个当一个“单词”查,大概率报错
如何让拼写检查适配你的团队术语?
内置词典不认识 grpc、consul、idempotent 这类工程词汇,每次都要右键 Add to Dictionary 太慢。更稳的方式是维护一个项目级自定义词典。
- 新建文件
Packages/User/MyTeam.sublime-spell-check,每行一个词(小写,无空格) - 在设置中指定:
"dictionary": "Packages/User/MyTeam.sublime-spell-check" - 注意:路径必须准确,大小写敏感;如果用了
SynWrite或SpellCheck插件,其词典格式可能不兼容原生机制
真正难的不是打开拼写检查,而是界定“什么是拼写错误”——在代码里,parseJSON 不是错字,paraseJSON 才是;但 Sublime 不懂这个区别。你得亲手告诉它哪些 scope 可查、哪些词可信、哪些语言该关掉,否则它只会用英语词典给你满屏标红。


















