Sublime拼写检查需先启用spell_check并指定语法，自定义词典必须存为Packages/User/Local Dictionary.en_US.txt且UTF-8无BOM，中文术语无需添加，中英混排英文词须整体加入词典。
拼写检查没开启，加词根本无效
Sublime 的拼写检查默认完全关闭，spell_check 不设为 true，右键菜单里连 “Add to Dictionary” 都不会出现——你手动敲再多术语也没用。必须先确认当前文件语法支持拼写校验（比如 Plain Text 或 Markdown），再在 Settings – Syntax Specific 里启用：
- 右下角状态栏要显示
Spell Check: On，不显示就说明没生效 - 别在全局
Preferences → Settings里只写{"spell_check": true}——代码类语法（如Python、JavaScript）会无视它，甚至满屏标红注释里的正常英文 - 正确做法：打开一个 .md 或 .txt 文件 → 菜单 Preferences → Settings – Syntax Specific → 右侧加：
{"spell_check": true, "dictionary": "Packages/Language - English/dictionaries/en_US.dic"}
自定义词该往哪加？Local Dictionary.en_US.txt 是唯一正解
想批量导入专业术语（比如 zod、ReactQuery、Llama Coder），不能直接改 en_US.dic，那是只读编译字典；也不能随便建个 mywords.txt 放错位置。Sublime 只认这个路径和命名：
- 文件必须放在
Packages/User/目录下（可通过 Preferences → Browse Packages… 快速打开） - 文件名必须严格为
Local Dictionary.en_US.txt（注意空格、下划线、语言后缀、.txt 缺一不可） - 每行一个词，全小写即可（
reactquery和ReactQuery都能匹配），不要引号、逗号、空格或空行 - 编码必须是 UTF-8 无 BOM，否则控制台报
invalid dictionary，整文件失效
为什么加了词还不标绿？优先级和缓存问题最常被忽略
即使文件放对、命名对、编码对，新词也可能不生效——根本原因是 Sublime 拼写检查加载的是合并词典：en_US.dic + Local Dictionary.en_US.txt + 右键添加的临时词，但任何一处配置错误都会打断链路：
- 检查 Settings – Syntax Specific 里是否写了错误的
dictionary路径（比如指向不存在的 .dic 文件），这会直接绕过Local Dictionary - 如果用了项目级配置（
Project.sublime-project），里面settings块若覆盖了spell_check或dictionary，用户词典同样被屏蔽 - 改完
Local Dictionary.en_US.txt后，已打开的文件需关闭重开，或执行Ctrl+Shift+P→Reload Syntax，否则缓存未刷新 - 右键菜单里
Spell Check若是灰色，说明当前语法没启用拼写检查，不是词库问题
中文术语怎么办？原生不支持，得另辟路径
Sublime 原生拼写检查只处理英文，zh_CN.dic 不是内置词典，也不被默认加载。如果你的文档混有中英术语（比如 “Llama Coder 接入”），想避免 “Llama” 被标红但又不想误判中文词：
- 中文本身不会触发拼写检查，所以不用加中文词到
Local Dictionary.en_US.txt——加了也无效 - 真正要防误判的是中英混排里的英文部分（如
LlamaCoder连写），这时必须把它作为整体单词加入Local Dictionary.en_US.txt - 别指望插件自动识别“专业名词”，所有有效添加都依赖你手动整理、命名规范、路径准确、编码干净
最容易被跳过的其实是编码和命名细节：少一个下划线、多一个 BOM、路径放错层级，都会让整份自定义词库静默失效。与其反复试错，不如先用 Sublime 自身另存为 UTF-8 无 BOM，再核对一次 Packages/User/ 下的文件名全貌。
