PyCharm 2025.3 Help

拼写检查

PyCharm 在标识符名称、字符串字面量、注释、 Markdown 文件以及提交消息中查找拼写错误。 为此,PyCharm 提供了一个专用的 拼写错误 检查,默认启用。

Typo 快速修复

修复拼写错误的单词

  1. 将插入符号置于 拼写错误 检查高亮显示的单词上。

  2. Alt+Enter ,或点击插入符号左侧的 黄色灯泡图标 ,显示 可用操作

  3. 选择一种建议的修复方式。

在字符串字面量和注释中,仅更改插入符号处该特定单词的拼写。 对于代码标识符(例如变量、函数、类 及其他符号),该检查还会建议通过 重命名 重构更改所有出现位置。

将单词保存到词典

如果检测到的拼写错误实际上是有效单词,您可以将其添加到用户定义的词典,以扩展内置词典。

  1. 将插入符号置于 拼写错误 检查高亮显示的单词上。

  2. Alt+Enter ,或点击插入符号左侧的 黄色灯泡图标 ,显示 可用操作

  3. 选择 保存到字典 将该单词添加到用户词典,并且今后不再报告。

    如果误添加了该单词,请按 Ctrl+Z 将其从词典中移除。

默认情况下,PyCharm 会将单词保存到全局应用级词典。 如果某个拼写仅适用于特定项目,或需要与该项目的团队共享,您可以选择将单词保存到项目级词典。 有关详细信息,请参阅 选择保存单词的默认词典

查找所有拼写错误

您可以在整个项目或一组文件上 运行拼写错误 检查。

  1. Ctrl+Alt+Shift+I ,或在主菜单中转到 代码 | 分析代码 | 通过名称运行检查(R)…

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

  3. 运行 '拼写错误' 对话框中,选择要运行该检查的范围,以及其他选项(例如文件掩码过滤器)。 然后点击 确定(O)

PyCharm 将在所选范围内的所有文件上运行 拼写错误 检查,并在 问题工具窗口 的单独选项卡中显示所有发现的拼写错误。

配置 Typo 检查

默认情况下, 拼写错误 检查会检查所有 范围 中的代码标识符、字符串字面量和注释。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 检查

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

  3. 在右侧窗格中,配置 拼写错误 检查:

    严重性(V)

    指定 严重性级别 ,并选择应用此级别的 范围

    例如,如果您希望拼写错误更加醒目,请选择 错误警告 ,以类似于代码中的语法错误或警告那样高亮显示拼写错误。

    选项

    指定要检查的内容类型:

    • 处理代码 :检查代码标识符。

    • 处理字面量 :检查字符串字面量中的文本。

    • 处理注释 :检查注释中的文本。

抑制 Typo 检查

与其他任何检查一样,您可以针对特定文件和代码元素抑制 拼写错误 检查。

  1. 将插入符号置于 拼写错误 检查高亮显示的单词上。

  2. 点击 意图操作按钮 或按 Alt+Enter ,显示可用意图操作。

  3. 在其中一个建议的修复上,按右箭头键,或点击 更多操作菜单 并选择 对类禁止 或其他相关的抑制操作。

    如何抑制 Typo 检查

根据语言和代码元素的不同,这会添加特殊注解或注释,指示编辑器在相应范围内抑制相关检查。 例如,对于 Python ,针对某个类抑制 拼写错误 检查会在类声明之前添加以下注解:

# noinspection SpellCheckingInspection

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

有关详细信息,请参阅 抑制检查

禁用拼写检查

禁用 Typo 检查

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 检查

  2. 展开 校对 节点。

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

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

  1. Ctrl+Alt+S 打开设置,然后选择 版本控制 | 提交

  2. 提交消息检查 中,清除 拼写 复选框。

为新项目禁用拼写检查

  1. 在主菜单中,转到 新建项目设置 | 新项目设置

  2. 清除 上文所述的复选框。 这将影响您在保存设置后首次创建或打开的项目。

词典

PyCharm 包含适用于所有 已配置语言捆绑 词典。 您无法直接更改它们,但可以通过其他方式扩展拼写检查器:

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

  • 添加带有 .dic 扩展名且包含单词列表的纯文本文件。

  • 添加 Hunspell 词典,每个词典由两个文件组成:包含带有适用修改规则的单词列表的 DIC 文件,以及列出受特定修改规则约束的前缀和后缀的 AFF 文件。 例如, en_GB.dic en_GB.aff

配置拼写检查器词典

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 自然语言 | 拼写

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

    • 要向列表添加新的自定义词典,请点击 添加按钮 或按 Alt+Insert ,并指定所需文件的位置。

    • 要在 PyCharm 中编辑自定义词典的内容,请选择它,然后点击 编辑按钮 或按 Enter。 相应的文件将在新的编辑器选项卡中打开。

    • 要从列表中移除自定义词典,请选择它,然后点击 移除按钮 或按 Alt+Delete

选择保存单词的默认词典

默认情况下,PyCharm 会将单词保存到全局应用级词典。 如果某个拼写仅适用于特定项目,或需要与该项目的团队共享,您可以选择将单词保存到项目级词典。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 自然语言 | 拼写

  2. 如果您希望每次 保存高亮显示的单词时手动选择词典,请清除 使用单个词典保存单词 选项旁边的复选框。

  3. 如果您希望在项目级保存高亮显示的单词,请保留该复选框选中状态,并在该选项旁选择 项目级别

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

手动添加已接受的单词

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 自然语言 | 拼写

  2. 将单词添加到 接受的单词 列表。 PyCharm 始终将手动接受的单词添加到 项目级 词典。

    您无法添加已存在于任一词典中的单词,以及大小写混合的单词,例如 CamelCasesnake_case

接受的单词 列表还会显示您使用 Alt+Enter 菜单 保存到任一内置词典的单词。

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

共享词典

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

当您通过 VCS 与项目团队共享该文件时,使用 PyCharm 的其他团队成员将能够访问该词典,从而共享忽略的单词列表。

最后修改日期: 2025年 12月 2日