VSCode中注释拼写检查可通过四种方法实现：一、安装启用Code Spell Checker扩展；二、配置其仅检查注释与字符串；三、使用cSpell CLI进行项目级批量校验；四、启用内置TextMate语法联动检查。
如果您在VSCode中编写代码注释时频繁出现拼写错误，且编辑器未自动提示或标出错误，则可能是拼写检查功能未启用或配置不完整。以下是实现注释内拼写检查的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用Code Spell Checker扩展
该扩展是VSCode中最常用且专为代码上下文优化的拼写检查工具，支持识别注释、字符串和标识符中的拼写问题，并能区分编程术语与自然语言。
1、打开VSCode，点击左侧活动栏的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入Code Spell Checker，找到作者为“Street Side Software”的官方扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”使扩展生效。
4、在任意包含英文注释的文件中（如JavaScript或Python），将光标悬停在疑似错别字上，查看是否出现波浪下划线及提示。
二、配置Spell Checker仅检查注释与字符串
默认情况下，该扩展会检查所有文本，包括变量名和函数名，可能产生干扰。通过调整设置可限定其作用范围，避免误报。
1、按下Cmd+,（macOS）打开设置界面。
2、在搜索框中输入cSpell.language，确认已设置为en或en-US。
3、搜索cSpell.words，点击“在settings.json中编辑”，添加自定义词表以保留技术词汇。
4、在settings.json中添加以下配置项：
"cSpell.enabledLanguageIds": ["javascript", "python", "typescript", "html", "markdown"],
"cSpell.ignoreRegExpList": ["\b[A-Z][a-z]*[A-Z][a-zA-Z]*\b", "/\*[^*]*\*+(?:[^/*][^*]*\*+)*/", "//.*"]
三、使用cSpell CLI进行项目级批量校验
当需要对整个代码库的注释进行离线扫描或集成进CI流程时，可借助命令行工具执行深度检查，覆盖VSCode图形界面未触发的边界场景。
1、在终端中全局安装cSpell：npm install -g cspell。
2、进入项目根目录，运行cspell --config .cspell.json \"**/*.{js,ts,py,html}\"。
3、若项目尚无配置文件，先执行cspell init生成.cspell.json。
4、编辑该文件，在languageSettings中为每种语言指定enableFiletypes为["comment", "string"]。
四、启用内置TextMate语法高亮联动检查
VSCode原生语法高亮引擎可识别注释语法节点，配合正则匹配规则，实现轻量级、零依赖的拼写标记，适用于禁用扩展的受限环境。
1、打开命令面板（Cmd+Shift+P），输入并选择“Preferences: Configure Language Specific Settings…”。
2、选择当前文件类型（如Python），在弹出的JSON片段中添加：
"editor.spellCheck": true,
"editor.unicodeHighlight.allowedLocales": {"en": true}
3、确保当前文件编码为UTF-8，且文件顶部未声明# -*- coding: latin-1 -*-等冲突编码。
4、重启VSCode窗口，打开含英文注释的.py文件，观察注释区域是否出现灰色波浪线。
