VSCode 拼写检查需配置 Code Spell Checker 扩展、启用 macOS 内建检查器、集成 cSpell CLI 或调整语言模式。具体包括安装扩展并设置语言、开启系统拼写服务、生成项目级 cspell.json 及正确设置文件语言模式。
如果您在 VSCode 中编写代码注释或 Markdown 文档时发现拼写错误未被识别，可能是编辑器未启用拼写检查功能或缺少对应语言支持。以下是实现拼写检查的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并配置 Code Spell Checker 扩展
Code Spell Checker 是 VSCode 中最常用且支持多语言的拼写检查工具，它能实时标记注释、字符串和 Markdown 中的拼写错误，并提供纠正建议。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入Code Spell Checker，找到由 Street Side Software 发布的官方扩展。
3、点击“安装”，安装完成后重启 VSCode 或重新加载窗口。
4、按下 Cmd+, 打开设置，在搜索栏输入cSpell.language，点击“在 settings.json 中编辑”，添加所需语言代码，例如：“cSpell.language”: “en, zh”。
二、启用内建文本检查器（仅限 macOS 系统）
macOS 系统自带的拼写检查服务可被 VSCode 调用，适用于纯文本、Markdown 和部分注释区域，无需额外扩展，但依赖系统级设置。
1、进入系统设置 → 键盘 → 文本输入 → 编辑 → 勾选 自动拼写更正 与检查拼写随输入进行。
2、在 VSCode 中打开命令面板（Cmd+Shift+P），输入并选择Preferences: Configure Language Specific Settings…。
3、选择 markdown 或plaintext，在弹出的 JSON 中添加：“editor.spellcheck”: true。
三、使用 cSpell CLI 集成到工作区
通过本地项目级 cSpell 配置文件，可实现跨团队一致的术语白名单、忽略词表及自定义字典，特别适合技术文档和多语言混合注释场景。
1、在项目根目录执行命令：npx cspell init，生成 cspell.json 配置文件。
2、编辑该文件，在 words 数组中添加项目专有词汇，例如：“useState”, “useEffect”, “TypeScript”。
3、在 VSCode 设置中搜索 cSpell.enabled，确保其值为true；再确认cSpell.configPath 指向项目内cspell.json。
四、调整语言模式以激活拼写检查
VSCode 按文件后缀或显式语言模式启用对应检查器，若注释未被识别，常因语言模式未正确识别导致拼写检查失效。
1、打开一个 JavaScript 文件，右下角状态栏显示语言标识（如JavaScript），点击它。
2、在弹出菜单中选择 Configure File Association for ‘.js’，输入javascriptreact 或typescript以增强注释解析能力。
3、对 Markdown 文件，确保状态栏显示 Markdown 而非Plain Text；若显示错误，点击后选择Change language mode → Markdown。
