在 macos 的 vs code 中配置代码拼写检查需安装 code spell checker 插件，设置 stringsonly、checkidentifiers 和 enabledlanguageids 以聚焦注释与字符串，通过 language、words 和 ignoreregexplist 支持中英文及专有名词，配合 ignorepaths 和 diagnosticlevel 减少误报。
在 macos 的 vs code 中配置代码拼写检查，核心是装对插件、设对范围、管好词典——不是所有英文都该被检查，重点盯住注释、字符串和 markdown 里的自然语言文案。
安装并启用 Code Spell Checker
这是目前唯一稳定支持 macOS、能智能区分代码与文案的拼写插件：
- 打开 VS Code，按 Cmd+Shift+X 进入扩展市场
- 搜索 Code Spell Checker（作者：Street Side Software）
- 点击安装，安装后建议关闭再重开当前工作区，确保字典加载完整
- 它默认就启用，无需手动开关
cSpell.enabled，但可确认设置中该值为true
让检查聚焦文案，避开干扰项
变量名、API 路径、环境变量这些不该标红。关键靠三步收敛范围：
- 只检查自然语言内容：在
settings.json中添加"cSpell.stringsOnly": true，这样仅检测字符串字面量和注释，跳过 JSX 标签、CSS 类名等 - 禁用标识符检查：确保
"cSpell.checkIdentifiers": false（默认已关，但可显式声明防误启） - 限定语言类型：用
"cSpell.enabledLanguageIds"明确指定要检查的文件类型，例如：["javascript", "typescript", "python", "markdown", "html"]
注意：若不希望检查 HTML 标签内文本，就把"html"去掉
处理中英文混合与项目专有名词
中文注释里的英文单词要检，技术术语要放过：
- 启用双语支持：在
settings.json中设"cSpell.language": "en, zh-CN"（逗号后别加空格） - 项目专属词统一管理：在项目根目录建
.cspell.json，填入团队常用词，例如："words": ["zustand", "vitepress", "authz", "JWT"] - 临时忽略某行文案：在行尾加
// cSpell:ignore，或写成// cSpell:ignore next-line忽略下一行
减少误报的实用技巧
路径、URL、全大写缩写常被误标，不用全关，只需精准过滤：
- 自动跳过全大写词：在
.cspell.json中加"ignoreRegExpList": ["\b[A-Z]{2,}\b"] - 跳过特定目录：用
"ignorePaths": ["node_modules/**", "dist/**", ".git/**"] - 降低提示强度：设
"cSpell.diagnosticLevel": "hint"，避免红色波浪线抢眼，但仍保提醒
