# 拼写检查

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

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

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

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

![拼写错误快速修复](https://resources.jetbrains.com/help/img/idea/2026.3/ij_typo_change_to.png)

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)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (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. 选择一种建议的方式来修复拼写错误。

在字符串文本和注释中，只有光标处的这个特定单词的拼写会改变。 对于代码标识符，例如变量、函数、类 和其他符号，检查还建议通过 [重命名](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)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (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. 选择   保存到字典  将该单词添加到用户词典中，并且未来不再报告。

如果您误加了这个词，请按 `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)), `Ctrl+Z` (Visual Studio), `⌘ Z` (Visual Studio (macOS)), `Ctrl+Z` (NetBeans), `Ctrl+Z` (Eclipse), `⌘ Z` (Eclipse (macOS)) 将其从词典中移除。

默认情况下，IntelliJ IDEA 会将单词保存到全局应用程序级词典。 如果拼写仅对这个特定项目正确，或者需要与从事该项目的团队共享，您可以选择将单词保存到项目级词典中。 有关更多信息，请参见 [选择默认词典保存单词](#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)), `Alt+Page Down` (Visual Studio), `⌥ Page ↓` (Visual Studio (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)), `Alt+Page Up` (Visual Studio), `⌥ Page ↑` (Visual Studio (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)), `Ctrl+Alt+Shift+I` (Visual Studio), `⌘ ⌥ ⇧ I` (Visual Studio (macOS)), `Ctrl+Alt+Shift+I` (NetBeans), `Ctrl+Alt+Shift+I` (Eclipse), `⌘ ⌥ ⇧ I` (Eclipse (macOS)) 或在主菜单中转到  `代码 | 分析代码 | 按名称运行检查…` 。

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

3. 在   运行"Typo"   对话框中，选择要在其中运行检查的作用域以及其他选项，例如文件掩码筛选器。 然后点击   OK  。

IntelliJ IDEA 将在所选作用域中的所有文件上运行   拼写   检查，并在 [问题工具窗口](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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 检查` 。

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

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

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

选项
: 请指定要检查的内容类型：
:
:
:
: * 处理编码 ：检查代码标识符，例如类名、字段和方法名。
:
: * 处理字面量 ：检查字符串字面量中的文本。
:
: * 处理注释 ：检查注释内的文本。

要完全禁用   拼写   检查，请清除此旁边的复选框。

Procedure: 抑制 Typo 检查

像其他检查一样，您可以对特定文件和代码元素抑制   拼写   检查。

1. 将文本光标置于由   拼写   检查高亮显示的单词处。

2. 点击 ![意图操作按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg) 或按 `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)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 显示可用的意图操作。

3. 在建议的修复之一上，按右箭头键或点击 ![更多操作菜单](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moreVertical.svg)并选择   对类禁止  或其他相关的抑制操作。

![如何抑制 Typo 检查](https://resources.jetbrains.com/help/img/idea/2026.3/spellchecker_suppress.png)

根据语言和代码元素的不同，这会添加特殊的注释或评论，告诉编辑器在相应的范围内抑制相关检查。 例如，在 Java 的情况下，为类抑制   拼写  检查会在类声明之前添加以下注解：

```JAVA
@SuppressWarnings("SpellCheckingInspection")

```

这会抑制类范围内的所有拼写检查。

有关更多信息，请参见 [抑制检查](disabling-and-enabling-inspections.html#suppress-inspections)。

## 禁用拼写检查

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 检查` 。

2. 展开   校对  节点。

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

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

1. 在主菜单中，前往  `文件 | 新建项目设置 | 新建项目设置` 。

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

3. 展开   校对  节点。

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

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

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 自然语言 | 语法和风格` 。

2. 在   范围  选项卡上，清除   提交消息  复选框（位于   签入  下）。

## 字典

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

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

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

* 添加 [Hunspell](https://hunspell.github.io/) 词典，每个词典由两个文件组成：包含带有适用修改规则的单词列表的 `DIC` 文件，以及列出受特定修改规则约束的前缀和后缀的 `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 自然语言 | 拼写` 。

2. 配置自定义词典列表：

* 要将一个新的自定义词典添加到列表中，请点击 !["添加"按钮](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)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 并指定所需文件的位置。

* 要编辑 IntelliJ IDEA 中自定义词典的内容，请选择它并点击 ![编辑按钮](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)), `Enter` (Visual Studio), `⏎` (Visual Studio (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)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))。

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

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

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 自然语言 | 拼写` 。

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

您无法添加已经存在于某个词典中的单词以及混合大小写的单词，例如  `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)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) 菜单 [保存](#accept-word)到任意内置字典中的单词。

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

### 共享词典

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

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

## See also

### 概念

[代码检查](code-inspection.html) [更改检查严重性](configuring-inspection-severities.html) [重命名重构](rename-refactorings.html) [文件范围与文件颜色](configuring-scopes-and-file-colors.html)