安装Code Spell Checker插件可实现代码拼写检查,通过配置settings.json或cspell.json文件启用检查、忽略路径、设置语言及管理词典,支持用户词典与工作区词典,提升代码质量与团队协作一致性。

VS Code 中的代码拼写检查并非内置功能,需借助扩展实现。最常用的是 Code Spell Checker 插件,它能识别代码中的拼写错误,包括变量名、注释、字符串等。正确配置和管理词典,可避免误报并提升编码质量。
安装与启用拼写检查插件
打开 VS Code 扩展市场(快捷键 Ctrl+Shift+X),搜索 Code Spell Checker,选择由 streetsidesoftware 发布的版本并安装。安装后无需额外启动,插件会自动对当前项目中的文本进行拼写检查。
启用后,拼写错误的单词下方会出现红色波浪线。将鼠标悬停其上可查看建议修正项,右键可选择“添加到用户词典”或“添加到工作区词典”。
配置拼写检查规则
通过修改 .vscode/settings.json 文件可自定义拼写检查行为。常见配置包括:
- 启用/禁用检查:
"cSpell.enabled": true - 忽略特定文件类型:
"cSpell.ignorePaths": ["**/node_modules", "**/*.min.js"] - 设置支持的语言:
"cSpell.language": "en, zh"(支持中英文混合) - 是否检查驼峰命名:
"cSpell.checkCamelCase": true
词典管理:用户词典与工作区词典
拼写检查器允许将专有名词、技术术语加入词典以避免误报。有两种主要方式:
- 用户词典:全局生效,适用于所有项目。路径通常位于
~/.config/Code/User/settings.json(Linux/macOS)或%APPDATA%\Code\User\settings.json(Windows)。添加方式:"cSpell.userWords": ["React", "useState", "TypeScript"] - 工作区词典:仅对当前项目有效。可在项目根目录创建
cspell.json或在.vscode/settings.json中添加"cSpell.words": ["MyComponent", "apiEndpoint"]
推荐将团队通用术语放入工作区词典,确保协作一致性。
自定义词典文件(cspell.json)
在项目根目录创建 cspell.json 可更灵活地管理拼写规则。示例配置:
{
"version": "0.2",
"language": "en",
"words": [
"Vue",
"Redux",
"async"
],
"ignorePaths": [
"dist/**",
"build/**"
]
}
该文件可提交至版本控制,便于团队共享拼写规范。
基本上就这些。合理配置拼写检查能提升代码可读性,减少命名错误,尤其适合多人协作或文档密集型项目。










