Code Spell Checker可检测代码中拼写错误:1. 安装扩展并重启;2. 在settings.json中配置cSpell.language添加zh-cn等语言;3. 通过.cspell.json的words字段忽略专有名词;4. 调整cSpell.diagnosticLevel和editorWaveDecoration自定义提示级别与颜色。

如果您在使用 VSCode 编写代码时频繁遇到拼写错误,例如变量名、注释或字符串中的错别字,Code Spell Checker 扩展可帮助识别并纠正这些错误。以下是启用与配置该扩展的具体操作:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 Code Spell Checker 扩展
该扩展需先通过 VSCode 的扩展市场下载并启用,才能对当前工作区生效。未安装前,所有拼写检查功能均不可用。
1、打开 VSCode,点击左侧活动栏最下方的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Code Spell Checker。
3、在搜索结果中找到作者为 Street Side Software 的官方扩展。
4、点击“安装”按钮,等待安装完成。
5、安装完毕后点击“重新加载”使扩展立即生效。
二、启用默认词典与语言支持
扩展默认仅启用英语词典,若项目含中文注释或使用其他编程语言关键字,需手动添加对应语言支持以避免误报。
1、按下 Cmd + , 打开设置界面。
2、在右上角搜索框中输入 cSpell.language。
3、点击“在 settings.json 中编辑”,在数组中添加 "zh-cn" 或 "en-us" 等所需语言代码。
4、保存文件后,扩展将自动加载对应语言词典。
三、配置忽略特定单词或路径
项目中常存在专有名词、缩写或第三方库名称,这些词汇不应被标记为拼写错误。可通过配置文件将其加入忽略列表。
1、在项目根目录下创建文件 .cspell.json(若不存在)。
2、在文件中添加 "words" 字段,并填入需忽略的单词,例如 ["React", "API", "JSON"]。
3、如需忽略整个文件夹,在 "ignorePaths" 中添加路径模式,例如 ["node_modules/**", "dist/**"]。
4、保存后,扩展将跳过所列单词及路径下的拼写检查。
四、调整高亮样式与错误级别
默认情况下,拼写错误以波浪线下划线形式提示,但部分用户偏好更显著的视觉反馈,或希望降低警告强度以减少干扰。
1、打开 VSCode 设置,搜索 cSpell.diagnosticLevel。
2、将值设为 "hint" 可降级为轻量提示,或设为 "error" 强制标为错误。
3、搜索 cSpell.silent,设为 false 确保所有提示正常显示。
4、如需修改下划线颜色,搜索 workbench.colorCustomizations,添加 "editorWaveDecoration": "#ff0000"。










