Code Spell Checker插件可实现实时拼写检查与修正,需安装启用、配置多语言支持、忽略专有名词或路径、自定义项目词典,并支持悬停建议与快捷修复。

如果您在vscode中编写代码或文档时希望自动检测拼写错误,Code Spell Checker插件可提供实时单词校验与建议。以下是该插件的典型配置与使用方式:
本文运行环境:macBook air,macOS Sequoia。
一、安装与启用插件
Code Spell Checker需通过VSCode扩展市场安装,并确保其处于启用状态,才能对打开的文件执行拼写检查。
1、点击左侧活动栏的扩展图标(四个方块组成的图标)。
2、在搜索框中输入Code Spell Checker,找到作者为Street Side Software的官方插件。
3、点击“安装”按钮,安装完成后点击“重新加载”或手动重启VSCode。
4、打开任意文本文件(如README.md或.py文件),观察编辑器右下角是否出现拼写检查状态指示器。
二、配置语言支持
插件默认仅启用英语词典,若需检查中文、法语、西班牙语等其他语言,须在设置中显式添加对应语言代码。
1、按下Cmd+,(macos)打开设置界面。
2、在搜索框中输入cSpell.language。
3、点击“在settings.json中编辑”,在数组中添加所需语言代码,例如:“en”,”zh”,”fr”。
4、保存文件,插件将立即开始对匹配语言的单词进行校验。
三、忽略特定单词或路径
项目中常存在专有名词、缩写或路径名,这些内容不应被标记为错误;可通过用户或工作区级配置实现精准忽略。
1、在VSCode中按下Cmd+Shift+P,输入并选择“Preferences: Open Settings (jsON)”。
2、在cSpell.words数组中添加需全局保留的单词,例如:[“react”, “API”, “UUID”]。
3、在cSpell.ignorePaths中填入不参与检查的目录模式,例如:[“node_modules/**”, “**/dist/**”]。
四、自定义词典文件
当团队需统一拼写规范或维护领域术语时,可创建独立的.cspell.json文件置于项目根目录,实现工作区级词典管理。
1、在项目根目录新建文件,命名为.cspell.json。
2、写入基础结构,包含version、language与words字段,例如:{“version”:”0.2″,”language”:”en”,”words”:[“graphql”,”typescript”]}。
3、保存后,插件自动读取该配置,覆盖用户级设置中同名字段。
五、快速修正拼写错误
插件在检测到疑似错误时,会以下划线形式标出,并支持鼠标悬停查看建议及一键替换,提升修正效率。
1、将光标移至带波浪线的单词上,等待提示框弹出。
2、点击提示框中的建议词,或按Ctrl+.(macOS为Cmd+.)唤出快速修复菜单。
3、从列表中选择正确拼写,或选择Add to Workspace Dictionary将当前词加入本项目词典。