VSCode中的代码拼写检查:配置与自定义词典

4次阅读

vscode需通过Code Spell Checker扩展实现拼写检查,支持多语言、自定义词典及精细配置;安装后默认检查注释与字符串,红波浪线提示错误,可右键修正或忽略。

VSCode中的代码拼写检查:配置与自定义词典

VSCode本身不内置拼写检查功能,需借助扩展实现。最常用的是 Code Spell Checker,它轻量、开源、支持多语言,且可灵活配置自定义词典。

安装与基础启用

在扩展市场搜索 “Code Spell Checker”,安装后重启或直接启用即可。默认会检查注释、字符串、变量名等常见位置的拼写,但不会检查关键字(如 ifreturn)或已知语法标识符

  • 安装后无需额外配置就能工作,适合快速上手
  • 拼错的单词下方会出现红色波浪线,悬停可查看建议
  • 右键点击可快速添加到用户词典或忽略本次

配置检查范围与语言

通过 settings.json 可精细控制哪些内容参与检查。例如禁用对变量名的检查(避免误报),或为不同文件类型指定语言:

  • 添加 "cSpell.enabled": true 确保全局开启
  • "cSpell.language": "en, zh" 同时支持中英文检查
  • 通过 "cSpell.words": ["axios", "vuex"] 直接内联添加专有名词
  • "cSpell.ignorePaths": ["node_modules/**", "dist/**"] 跳过无关目录

添加自定义词典(项目级 & 全局)

词典分两级:项目级(推荐)更精准,全局级更省事。项目词典放在项目根目录的 cspell.json 中:

VSCode中的代码拼写检查:配置与自定义词典

Gaga

曹越团队开发的AI视频生成工具

VSCode中的代码拼写检查:配置与自定义词典 1151

查看详情 VSCode中的代码拼写检查:配置与自定义词典

  • 新建 cspell.json,写入:
    { "words": ["typescript", "eslint", "vite"], "language": "en" }
  • VSCode 会自动识别并加载,无需重启
  • 全局词典路径可通过命令面板运行 Preferences: Open Settings (json),在其中添加 "cSpell.userWords": ["npm", "cli"]
  • 注意:项目词典优先级高于全局词典

处理误报与例外规则

有些缩写、技术术语或大小写组合容易被误标(如 HTTPStatusURLs)。可通过正则或格式规则过滤:

  • cspell.json 中添加:
    "ignoreRegExpList": ["[A-Z]{2,}"] 忽略全大写词组
  • "allowCompoundWords": true 允许连写词(如 backgroundColor
  • 对特定文件类型关闭检查:
    "cSpell.enabledLanguageIds": ["javascript", "typescript", "markdown"]

基本上就这些。配置一次,后续开发中拼写问题能及时暴露,尤其对文档注释、配置项名称、API字段等场景帮助明显。不复杂但容易忽略。

text=ZqhQzanResources