VSCode中的代码拼写检查器(Code Spell Checker)

1次阅读

Code Spell Checker 是 vscode 中轻量实用的拼写检查扩展,支持注释、字符串等场景,默认检查英文,可配置多语言、自定义词典、忽略规则及禁用中文误报,与 ESLint 等工具无冲突。

VSCode中的代码拼写检查器(Code Spell Checker)

VSCode 的 Code Spell Checker 是一个轻量但实用的拼写检查扩展,专为代码注释、字符串、变量名(可选)等场景设计,能有效减少文档和代码中的低级拼写错误。

安装与基础启用

在 VSCode 扩展市场中搜索 “Code Spell Checker”,点击安装并重启编辑器(通常无需重启,启用后立即生效)。安装后默认自动检查当前文件中的注释和字符串内容,不检查关键字或语法结构,因此不会干扰编码逻辑。

  • 检查范围包括:单行/多行注释(///* */#)、双引号/单引号/反引号包裹的字符串
  • 默认语言为英语(US),如需支持中文,需额外配置——该扩展原生不检查中文,但可禁用对中文的“误报”(见下文)
  • 拼写错误会以波浪线下划线标出,悬停显示建议词,右键可快速更正或添加到用户词典

自定义词典与忽略规则

项目常含专有名词(如 API 名称、内部模块、缩写),需手动加入词典避免频繁误报。可在工作区根目录创建 cspell.json 配置文件,或通过命令面板(Ctrl+Shift+P → “Preferences: Open Settings (json)”)添加用户级设置。

VSCode中的代码拼写检查器(Code Spell Checker)

Hugging Face

Hugging Face ai开源社区

VSCode中的代码拼写检查器(Code Spell Checker) 270

查看详情 VSCode中的代码拼写检查器(Code Spell Checker)

  • 添加自定义词:右键波浪线 → “Add to workspace cspell.json” 或 “Add to user cspell.json
  • 忽略特定模式:在 cspell.json 中配置 "ignoreRegExpList",例如 "ignoreRegExpList": ["b[A-Z]{2,}b"] 可跳过大写字母缩写
  • 禁用中文误报:添加 "language": "en" 并启用 "allowCompoundwords": true,再配合 "ignoreRegExpList" 过滤中文字符串(如 "[u4e00-u9fa5]+"

多语言与团队协作支持

支持英语(US/UK/CA/AU)、西班牙语、法语、葡萄牙语等十余种语言,可通过 cspell.json"language" 字段指定,或使用文件顶部注释临时切换:

  • 在文件开头添加 // cSpell:language es 即对该文件启用西班牙语检查
  • 团队共用词典:将 cspell.json 提交至 git,统一拼写规范,避免成员各自添加私有词导致差异
  • 配合 ESLint 或 Prettier 不冲突:它只做拼写检查,不影响代码格式或语法校验

常见问题处理

若拼写检查未生效,优先检查以下几项:

  • 确认文件语言模式正确(右下角显示如 “javaScript”,不是 “Plain Text”)
  • 检查是否被其他扩展禁用(如某些主题或 LSP 扩展可能覆盖语法高亮范围)
  • 确认 "cSpell.enabled" 在设置中为 true;若仅想检查注释,可设 "cSpell.checkCommentsOnly": true
  • 大文件可能延迟响应,可调整 "cSpell.maxNumberOfProblems" 或关闭非必要检查项

text=ZqhQzanResources