VSCode如何配置代码拼写检查_英文单词错误自动校正

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"（降低提示级别，减少干扰）

拼写检查的边界很清晰：它只管自然语言文本，不管变量命名是否合理；它依赖词典质量，不替代你对业务术语的理解；所有“自动”行为都该被当成辅助，而不是信任对象。