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。
