VSCode 默认无拼写检查功能,需安装 Code Spell Checker 扩展实现错词高亮与手动替换;它支持多语言、自定义词典,但自动修正仅限保存时且需人工确认,不替代术语理解。

VSCode 默认不带拼写检查,必须装扩展
VSCode 本身不内置英文拼写检查功能,Ctrl+Click 或悬停不会标红错词,也不会提示正确拼法。想实现“单词错误自动校正”,得靠第三方扩展,且需注意:**自动校正 ≠ 拼写检查**——多数扩展只做高亮和建议,真自动替换要手动触发或额外配置。
推荐用 Code Spell Checker(最稳定通用)
这是目前 VSCode 商店里维护最勤、语言支持最全的拼写检查扩展。它不改代码逻辑,只标记疑似错词,并提供右键快速替换选项。
- 安装后默认启用,无需配置即可对
.js、.ts、.md、.py等常见文件类型生效 - 错词会带波浪下划线(红色),悬停显示建议词列表
- 右键点击错词 → 选择
Change to "xxx"即可替换;也可选Add to Workspace Dictionary把专有名词(如变量名useAuth、项目名MyApp)加入白名单,避免误报 - 若想关闭某类文件的检查(比如不想在 JSON 配置里查拼写),可在工作区
.vscode/settings.json中加:
{
"[json]": {
"cSpell.enabled": false
}
}
cSpell.language 和自定义词典容易配错
扩展默认只认英语,遇到技术术语(如 jsx、httpd、zsh)常报错。别急着关掉,优先用词典解决:
- 全局词典路径是
~/.cspell.json(macOS/Linux)或%USERPROFILE%\.cspell.json(Windows),内容格式为:
{
"words": ["jsx", "httpd", "zsh", "vitepress"],
"ignorePaths": ["node_modules/**", "dist/**"]
}
- 工作区级词典更安全:在项目根目录放
cspell.json,VSCode 会自动识别并优先使用 - 注意
cSpell.language是指「检查时参考的语言」,不是编辑语言。设成"en,es,fr"可同时校验多语种文本,但对代码注释帮助不大,反而可能漏报
别信“自动校正”宣传,真实场景中慎开 cSpell.autoFix
扩展确实提供了 cSpell.autoFix 设置项,但开启后仅在**保存时**尝试修正(非实时),且只处理“明确唯一建议”的情况(比如 recieve → receive)。多数技术词无唯一映射,它不会动。
- 自动修正有风险:把
resovle改成resolve是对的,但把redux改成reduces就是灾难 - 真正可靠的流程是:靠波浪线发现错词 → 右键看建议 → 人工确认 → 手动选替换
- 如果硬要开自动修复,务必配合
cSpell.allowCompoundWords: true(允许连写词如stateManagement)和cSpell.diagnosticLevel: "Hint"(降低提示级别,减少干扰)










