# 拼写检查

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> 配置：  `设置 | 编辑器 | 语言 | 拼写`
>
>
>
> 检查：  `设置 | 编辑器 | 检查 | 校对 | 拼写`

CLion 会查找标识符名称、字符串文字、注释、 [Markdown 文件](markdown.html)和提交消息中的拼写错误。 为此，CLion 提供了一个专用的   拼写  检查，默认情况下启用。

> **Tip:**
> 要了解如何管理语法和样式检查，请参阅 [语法](grammar.html)。

Procedure: 修正拼写错误

1. 将文本光标放在由   拼写  检查突出显示的单词处。

2. 按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 或点击文本光标左侧的 ![黄色灯泡图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) 以显示 [可用操作](null)。

3. 选择一种建议的方式来修复拼写错误。

![更正拼写错误](https://resources.jetbrains.com/help/img/idea/2026.3/cl_typo_suggestions.png)

在字符串文本和注释中，只有光标处的这个特定单词的拼写会改变。 对于代码标识符，例如变量、函数、类 和其他符号，检查还建议通过 [重命名](rename-refactorings.html)重构更改所有出现的地方。

Procedure: 将单词保存到字典

如果检测到的错别字实际上是一个有效单词，您可以将其添加到用户定义的词典中，以扩展内置词典。

1. 将文本光标放在由   拼写  检查突出显示的单词处。

2. 按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 或点击文本光标左侧的 ![黄色灯泡图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) 以显示 [可用操作](null)。

3. 选择   保存到字典  将单词添加到用户字典中，并且将来不再报告它。

![接受拼写错误的单词](https://resources.jetbrains.com/help/img/idea/2026.3/cl_typo_accept.png)

如果您误加了这个词，请按 `Ctrl+Z` (Windows), `⌘ Z` (macOS), `⌘ Z` (IntelliJ IDEA Classic (macOS)), `⌘ Z` (macOS System Shortcuts), `Ctrl+Z` (XWin), `Ctrl+Z` (GNOME), `Ctrl+Z` (KDE), `Ctrl+Shift+Minus` (Emacs), `Ctrl+Z` (Sublime Text), `⌘ Z` (Sublime Text (macOS)), `⌘ Z` (Xcode), `Ctrl+Z` (Visual Studio), `⌘ Z` (Visual Studio (macOS)), `Ctrl+Z` (ReSharper), `⌘ Z` (ReSharper (macOS)), `Ctrl+Z` (QtCreator), `⌘ Z` (QtCreator (macOS)), `Ctrl+Z` (NetBeans), `Ctrl+Z` (Eclipse), `⌘ Z` (Eclipse (macOS)) 将其从词典中移除。

默认情况下，CLion 会将单词保存到全局应用程序级词典中。 如果拼写仅对该特定项目正确或需要与该项目的团队共享，您可以选择将单词保存到项目级词典中。 欲了解更多信息，请参阅 [选择默认词典保存单词](#select-default-dictionary)。

> **Tip:**
> 按 `F2` (Windows), `F2` (macOS), `F2` (IntelliJ IDEA Classic (macOS)), `⌃ Comma` (macOS System Shortcuts), `F2` (XWin), `F2` (GNOME), `F2` (KDE), `F2` (Emacs), `F2` (Sublime Text), `F2` (Sublime Text (macOS)), `⌘ Quote` (Xcode), `Alt+Page Down` (Visual Studio), `⌥ Page ↓` (Visual Studio (macOS)), `F12` (ReSharper), `⌥ Page ↓` (ReSharper (macOS)), `F6` (QtCreator), `F6` (QtCreator (macOS)), `F2` (NetBeans), `F2` (Eclipse), `⌘ .` (Eclipse (macOS)) 和 `Shift+F2` (Windows), `⇧ F2` (macOS), `⇧ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ Comma` (macOS System Shortcuts), `Shift+F2` (XWin), `Shift+F2` (GNOME), `Shift+F2` (KDE), `Shift+F2` (Emacs), `Shift+F2` (Sublime Text), `Shift+F2` (Sublime Text (macOS)), `⌘ ⇧ Quote` (Xcode), `Alt+Page Up` (Visual Studio), `⌥ Page ↑` (Visual Studio (macOS)), `Shift+F12` (ReSharper), `⇧ F12` (ReSharper (macOS)), `Shift+F6` (QtCreator), `⇧ F6` (QtCreator (macOS)), `Shift+F2` (NetBeans), `Shift+F1` (Eclipse), `⌘ ⇧ .` (Eclipse (macOS)) 以逐步检查当前文件中的所有问题，包括拼写错误。

Procedure: 查找所有拼写错误

您可以 [运行](running-inspections.html#run-one-inspection)   拼写  检查在您的整个项目或一组文件上。

1. 按 `Ctrl+Alt+Shift+I` (Windows), `⌘ ⌥ ⇧ I` (macOS), `⌘ ⌥ ⇧ I` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ I` (macOS System Shortcuts), `Ctrl+Alt+Shift+I` (XWin), `Ctrl+Alt+Shift+I` (GNOME), `Ctrl+Alt+Shift+I` (KDE), `Ctrl+Alt+Shift+I` (Emacs), `Ctrl+Alt+Shift+I` (Sublime Text), `⌘ ⌥ ⇧ I` (Sublime Text (macOS)), `⌘ ⌥ ⇧ I` (Xcode), `Ctrl+Alt+Shift+I` (Visual Studio), `⌘ ⌥ ⇧ I` (Visual Studio (macOS)), `Ctrl+Alt+Shift+I` (ReSharper), `⌘ ⌥ ⇧ I` (ReSharper (macOS)), `Ctrl+Alt+Shift+I` (QtCreator), `⌘ ⌥ ⇧ I` (QtCreator (macOS)), `Ctrl+Alt+Shift+I` (NetBeans), `Ctrl+Alt+Shift+I` (Eclipse), `⌘ ⌥ ⇧ I` (Eclipse (macOS)) 或进入主菜单中的  `代码 | 分析代码 | 按名称运行检查…` 。

2. 在   输入检查名称  弹出窗口中，查找并选择   拼写  检查。

3. 在   运行“Typo”  对话框中，选择您要运行检查的作用域，以及其他选项，如文件掩码过滤器。 然后点击   确定  。

CLion 将在所选作用域内的所有文件上运行   拼写   检查，并在 [问题工具窗口](problems-tool-window.html) 的单独选项卡中显示所有发现的拼写错误。

Procedure: 配置拼写检查

默认情况下，   拼写   检查会在所有 [作用域](configuring-scopes-and-file-colors.html)内检查代码标识符、字符串文本和注释。

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器｜检查` 。

2. 展开   校对  节点并在中央窗格中点击   拼写  。

3. 在右侧窗格中配置   拼写  检查：

![Typo 检查设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_typo_inspection.png)

严重性
: 请指定 [严重级别](configuring-inspection-severities.html)和应用此级别的 [作用域](configuring-scopes-and-file-colors.html)。
:
:
:
: 例如，如果您希望拼写错误更明显，请选择   错误   或   警告   以将拼写错误突出显示，类似于代码中的语法错误或警告。

选项
: 请指定要检查的内容类型：
:
:
:
: * 处理代码 ：检查代码标识符。
:
: * 处理文字 ：检查字符串字面量中的文本。
:
: * 处理注释 ：检查注释内的文本。

## 禁用拼写检查

Procedure: 禁用 Typo 检查

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器｜检查` 。

2. 展开   校对  节点。

3. 清除   拼写   检查旁边的复选框。

![禁用拼写检查检查](https://resources.jetbrains.com/help/img/idea/2026.3/cl_spellcheck_inspection_disable.png)

Procedure: 为新项目禁用拼写错误检查

1. 在主菜单中，进入  `文件 | 新建项目设置 | 新建项目设置` .

2. 转到  `编辑器｜检查`

3. 展开   校对  节点。

4. 清除   拼写   检查旁边的复选框。

![禁用拼写检查检查](https://resources.jetbrains.com/help/img/idea/2026.3/cl_spellcheck_inspection_disable.png)

这将影响到您保存设置后首次创建或打开的项目。

Procedure: 在提交消息中禁用拼写检查

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 自然语言 | 语法和风格` 。

2. 在   作用域   选项卡上，清除   提交消息   复选框，该复选框位于   签入   下。

![禁用提交中的拼写检查](https://resources.jetbrains.com/help/img/idea/2026.3/commit_spellcheck_disable.png)

## 字典

CLion 包括所有  捆绑  词典，适用于所有 [已配置语言](proofreading.html#add-natural-language)。 您不能直接更改它们，但您可以通过其他方式扩展拼写检查器：

* 将单词保存到内置的全局或项目词典中。

* 添加扩展名为 `.dic` 的纯文本文件，这些文件包含单词列表。

* 添加 [Hunspell](https://hunspell.github.io/)词典，每个词典由两个文件组成： `词典` 文件包含带有适用修改规则的单词列表，而 `AFF` 文件列出受特定修改规则约束的前缀和后缀。 例如， `en_GB.dic` 和 `en_GB.aff` 。

Procedure: 配置拼写检查词典

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 自然语言 | 拼写` 。

2. ![拼写设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_spelling_settings.png)

配置自定义词典列表：

* 要将一个新的自定义词典添加到列表中，请点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 并指定所需文件的位置。

* 要编辑 CLion 中自定义词典的内容，请选择它并点击 ![“编辑”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg) 或按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 相应的文件将在一个新的编辑器标签中打开。

* 若要从列表中删除自定义字典，请选择它并点击 !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) 或按 `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))。

Procedure: 选择默认词典保存单词

默认情况下，CLion 会将单词保存到全局应用程序级词典中。 如果拼写仅对该特定项目正确或需要与该项目的团队共享，您可以选择将单词保存到项目级词典中。

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 自然语言 | 拼写` 。

2. 如果您每次 [保存一个高亮词汇](#accept-word)时都想手动选择词典，请清除   使用单个字典来保存单词  选项旁边的复选框。

3. 如果您想在项目级别保存高亮词语，请保留该复选框的选中状态并选择该选项旁边的   项目级  。

在这种情况下，IDE 会将单词保存在  `.idea/dictionaries` 下的 XML 文件中，您可以通过 VCS 与团队共享。 您的团队成员将能够访问并修改词典并共享他们的更改。

Procedure: 手动添加已接受的单词

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 自然语言 | 拼写` 。

2. 将单词添加到   已接受单词  列表。 CLion 总是将手动接受的单词添加到  项目级 词典中。

您无法添加已经存在于某个词典中的单词以及混合大小写的单词，例如  `CamelCase` 和  `snake_case` 。

已接受单词   列表还显示了您通过 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 菜单 [保存](#accept-word)到任意内置字典中的单词。

它不会显示其他用户添加到共享项目级词典中的单词以及来自其他自定义词典的单词，但拼写检查器仍会忽略这些单词。

### 共享词典

CLion 将内置项目级词典存储在 项目 目录的  `d.xml`  文件中，位于  `.idea`  子目录，与其他与项目相关的文件一起。

当您通过 VCS 与您的项目团队共享此文件时，使用 CLion 的其他团队成员将能够访问字典以共享忽略词列表。

## See also

