可在VSCode中通过五种方式配置拼写检查忽略规则：一、在settings.json中添加cSpell.words数组；二、在文件顶部用// cSpell:ignore注释；三、创建cSpell.json项目级配置；四、禁用特定语言ID；五、使用.cspellignore文件排除路径。

如果您在 VSCode 中启用代码拼写检查后，发现某些专有名词、缩写或自定义标识符被误标为拼写错误，则需要配置拼写检查工具以忽略这些单词或整个文件。以下是实现此目标的具体步骤：

本文运行环境：MacBook Pro，macOS Sequoia。

一、通过 settings.json 添加忽略单词

拼写检查扩展（如 Code Spell Checker）支持在用户或工作区设置中声明全局忽略词列表。该方式适用于频繁出现且跨项目复用的术语。

1、按下 Cmd + , 打开设置界面。

2、点击右上角的“打开设置（JSON）”图标，进入 settings.json 编辑模式。

3、在 JSON 对象内添加或修改 "cSpell.words" 数组字段。

4、将需忽略的单词以字符串形式逐个加入该数组，例如："MyAPI"、"JWTToken"、"XMLHttpRequest"。

5、保存文件，VSCode 将立即停止对这些单词标记拼写错误。

二、在当前文件顶部添加注释指令

Code Spell Checker 支持基于文件级的内联配置，通过特殊注释可临时禁用对本文件的拼写检查，或仅忽略特定行中的单词。

1、在文件最顶部空白处插入一行注释：// cSpell:ignore MyComponent, propsData, Vuex。

2、确保该行位于所有 import 或 require 语句之前，且无前置空行干扰解析。

3、若需忽略整行，可在对应行末添加：// cSpell:ignoreLine。

4、若需忽略某段连续多行，使用 // cSpell:ignoreStart 和 // cSpell:ignoreEnd 包裹该区域。

三、配置 cSpell.json 文件实现项目级忽略

在项目根目录下创建独立的 cSpell.json 配置文件，可集中管理词汇表、语言偏好及路径排除规则，适合团队协作场景。

1、在项目根目录新建文件，命名为 cSpell.json。

2、写入基础结构，包含 "words" 字段和 "ignorePaths" 字段。

3、在 "words" 数组中填入项目专用术语，如："Pinia"、"VitePress"、"TSX"。

4、在 "ignorePaths" 数组中列出需跳过拼写检查的路径，例如："dist/**"、"node_modules/**"、"*.min.js"。

5、保存后，VSCode 将自动读取该配置并应用至整个工作区。

四、禁用特定语言的拼写检查

当某类文件（如 JSON 配置、YAML 清单）中大量使用键名导致误报时，可通过禁用对应语言的拼写检查来避免干扰。

1、打开设置界面，搜索 cSpell.enabledLanguageIds。

2、点击“在 settings.json 中编辑”，找到该配置项。

3、从数组中移除目标语言 ID，例如删除 "json" 或 "yaml"。

4、也可直接设为仅启用特定语言，如只保留 "javascript" 和 "typescript"。

五、使用 .cspellignore 文件排除路径

与 .gitignore 类似，.cspellignore 文件用于声明完全不参与拼写检查的文件或目录路径，优先级高于其他忽略配置。

1、在项目根目录创建名为 .cspellignore 的纯文本文件。

2、每行填写一个 glob 模式，例如：/build/、**/*.mdx、src/generated/**。

3、支持以 # 开头的注释行，以及以 ! 开头的反向匹配规则。

4、保存后，Code Spell Checker 将跳过所有匹配路径下的文件扫描。

# vue  # node  # json  # git  # js  # vscode  # java  # word  # javascript  # vite