词典文件必须放在packages/user/目录下且命名为en_us.dic或zh_cn.dic,编码为utf-8无bom,配置需在syntax specific设置中指定路径并启用spell_check,全局设置无效;add to dictionary灰色说明拼写检查未启用。

词典文件必须放对位置,否则Sublime直接忽略
Sublime 不会报错、不提示、不 fallback,dictionary 路径错一个字符(比如多一级 dictionaries/、少空格、大小写不对),它就当没这回事。唯一验证方式:菜单 → Preferences → Browse Packages… → 进入 Packages/User/ 目录,确认你的词典文件确实在那儿,且名字是 en_US.dic 或 zh_CN.dic(不是 .aff、.txt、.dict)。
常见错误路径:
-
"dictionary": "en_US.dic"(缺前缀,无效) -
"dictionary": "Packages/User/en_US"(漏 .dic 后缀) -
"dictionary": "Packages/Language - English/en_US.dic"(仅适用于原装英文包;若你手动复制过,得用Packages/User/en_US.dic)
Settings – Syntax Specific 里配才生效,全局 Settings 不管用
你在 Preferences → Settings(全局)里加 "spell_check": true,对 .py、.js 文件完全没反应——语法包自己决定是否响应拼写检查,Python 语法默认屏蔽它。真要启用,必须针对具体语法类型单独配置。
操作步骤:
- 打开一个
.md或Plain Text文件(右下角显示对应语法) - 菜单 → Preferences → Settings – Syntax Specific
- 在右侧用户设置里写:
{"spell_check": true, "dictionary": "Packages/User/en_US.dic"} - 保存,状态栏右下角出现 Spell Check 才算真正启用
中文词典要自己准备,且格式极严格
Sublime 原生不带中文词典,zh_CN.dic 必须手动下载或生成,且必须满足三个条件:
- 文件编码为 UTF-8 无 BOM(用 VS Code 或 Sublime 自己另存时选“UTF-8”而非“UTF-8 with BOM”)
- 内容为纯文本,每行一个词,不能有空行、注释、制表符或拼音(例如:
人工智能✔️,人工智能\tAI❌) - 文件名必须是
zh_CN.dic,放在Packages/User/下,配置项写"dictionary": "Packages/User/zh_CN.dic"
中英混排场景(如 teh_api_v2)会被整体当作一个词校验,想让它通过,就得把整个字符串加进词典。
Add to Dictionary 灰掉?说明 spell_check 没真跑起来
右键菜单里 Add to Dictionary 不可用,90% 是因为当前视图压根没启用拼写检查——不是词典加载失败,而是 spell_check 根本没生效。先看状态栏右下角有没有 Spell Check 字样,没有就别折腾词典路径。
另外注意:
- 按
F6只是临时开关,关文件就重置,不持久 - 如果误在
source.python的 Syntax Specific 设置里开了spell_check,变量名(如recieveData)会被标红,加进词典后,真拼错receive就永远漏检 - 自定义术语不能靠右键添加,必须手动编辑
Packages/User/en_US.dic(或zh_CN.dic),加完重启 Sublime 或重载词典(部分版本需重启)
最易被忽略的一点:词典文件必须是 Sublime 认可的 .dic 格式,哪怕内容完全一样,.txt 后缀也不会加载。别省那几秒重命名。











