vscode 通过 Code Spell Checker 插件可实现多语言拼写检查,支持注释、字符串 及 Markdown 实时校验;需配置 language、words、enabledLanguageIds 等项,并推荐项目级 .cspell.json 统一管理。

VSCode 默认不带拼写检查功能,但通过插件可以轻松实现对注释、字符串甚至 Markdown 文档的实时拼写校验。选对插件 + 合理配置,才能真正提升写作准确性和开发体验。
推荐插件:Code Spell Checker
这是目前 VSCode 中最成熟、活跃度最高、支持最广的拼写检查插件。它支持 20+ 种语言(含中文拼音模糊匹配)、可自定义词典、区分代码 / 注释 / 字符串上下文,并兼容多种文件类型(.js、.py、.md、.ts、.html 等)。
- 安装方式:在扩展市场搜索 Code Spell Checker,点击安装
- 默认启用,打开任意文本或代码文件即可看到拼写错误(波浪线标红)
- 右键点击错词可快速添加到用户词典或忽略本次
基础配置:让检查更贴合你的习惯
在设置(Ctrl+,)中搜索 spelling,或直接编辑 settings.json 添加以下常用项:
- cSpell.language:指定主语言,如
"en-US"或"zh-CN"(中文支持有限,建议主要用于英文文档和注释) - cSpell.words:添加项目级专有名词,比如
["react", "vue3", "APIKey"] - cSpell.enabledLanguageIds:明确开启检查的语言,例如
["javascript", "typescript", "markdown", "python"] - cSpell.ignorePaths:跳过 node_modules、dist 等目录,避免干扰
进阶技巧:个性化与协作友好
团队开发时,建议把拼写配置纳入项目统一管理,避免每人一套规则:
- 在项目根目录新建 .cspell.json,内容类似:
{"language": "en-US", "words": ["myComponent", "authToken"], "ignorePaths": ["build/**"] } - 启用 cSpell.allowCompoundWords 可减少驼峰命名(如
userProfile)被误报 - 配合 Prettier 或 ESLint 使用时,拼写检查只作用于文本内容,不影响代码格式化逻辑
基本上就这些。不需要复杂工具链,装一个插件、配几行 JSON,就能让代码里的英文更干净、文档更专业。