Code Spell Checker 是 VSCode 中轻量实用的拼写检查扩展，支持注释、字符串等场景，默认检查英文，可配置多语言、自定义词典、忽略规则及禁用中文误报，与 ESLint 等工具无冲突。
VSCode 的 Code Spell Checker 是一个轻量但实用的拼写检查扩展，专为代码注释、字符串、变量名（可选）等场景设计，能有效减少文档和代码中的低级拼写错误。
安装与基础启用
在 VSCode 扩展市场中搜索 “Code Spell Checker”，点击安装并重启编辑器（通常无需重启，启用后立即生效）。安装后默认自动检查当前文件中的注释和字符串内容，不检查关键字或语法结构，因此不会干扰编码逻辑。
- 检查范围包括：单行/多行注释（
//、/* */、#）、双引号/单引号/反引号包裹的字符串 - 默认语言为英语（US），如需支持中文，需额外配置——该扩展原生不检查中文，但可禁用对中文的“误报”（见下文）
- 拼写错误会以波浪线下划线标出，悬停显示建议词，右键可快速更正或添加到用户词典
自定义词典与忽略规则
项目常含专有名词（如 API 名称、内部模块、缩写），需手动加入词典避免频繁误报。可在工作区根目录创建 cspell.json 配置文件，或通过命令面板（Ctrl+Shift+P → “Preferences: Open Settings (JSON)”）添加用户级设置。
- 添加自定义词：右键波浪线 → “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"或关闭非必要检查项
