PyCharm 2026.3 Help

语法

启用 Natural Languages 插件

此功能依赖于 Natural Languages 插件,默认情况下在 PyCharm 中已捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 找到 自然语言 插件并点击 启用。

PyCharm 会检查文本文件中的语法,例如项目的 README.md 。 您还可以 进行配置 ,以检查源代码中的各种文本元素:字符串字面量、注释,甚至提交消息。 它会突出显示与词形、标点、整体结构及风格相关的错误。

默认情况下, PyCharm 内置对英语的支持,并建议为其检测到的其他语言添加支持。 有关支持的语言及其添加方式的更多信息,请参阅 自然语言。

PyCharm 使用 语法 检查来执行语法检查。 按 Ctrl+Alt+S 打开设置并选择 编辑器 | 检查。 语法 检查位于 校对 下。 默认将其设置为最低严重性级别(细微下划线),并应用于所有范围。

修复语法错误

  1. 将插入符号置于由 语法 检查突出显示的单词上。

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

  3. 从建议列表中选择合适的修复。

用于修复错误的意图操作

除了应用修复之外,您还可以 禁用该规则 (触发检查),或将检测到的短语添加为 例外。

语法检查范围

您可以选择要检查语法问题的文件类型和代码部分。 例如,您可以在 Markdown 文件以及 Python 文件中的字符串和注释中启用语法检查,同时在 YAML 和 JSON 文件中禁用语法检查。

常规代码注释和文档注释会分开处理,因此您可以分别为其启用或禁用检查。

配置语法检查位置

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 编辑器 | 自然语言 | 语法和风格。

  2. 在 作用域 选项卡上,选择要检查语法的代码部分以及要启用语法检查的文件类型。

    选项

    描述

    字符串字面量

    检查字符串字面量中的语法。

    注释

    在常规行注释和块注释中检查语法。

    文档注释

    检查内嵌代码文档中的语法。

    提交消息

    在 已配置的 VCS 的提交消息中检查语法。 启用该选项后, PyCharm 会将相应的检查工具添加到 .idea/vcs.xml 配置文件中。

语法规则

PyCharm 会根据为某种语言定义的一组规则检查语法。 例如,在英语中,既有关于如何正确使用冠词、逗号和过去时形式的规则,也有创意写作与朴素写作的风格提示、常见拼写错误及易混淆词、恰当的搭配等等。

其中大多数规则默认启用,可检测明确的错误。 不过,其中有些只是建议,您可能不同意或并不在意。 在这种情况下,您可以在 意图操作 或在设置中禁用特定规则。

用于禁用规则的意图操作

配置规则集

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 编辑器 | 自然语言 | 语法和风格。

  2. 在 规则 选项卡上,选择您希望用于检查文本的规则。

  3. 在对话框底部的 其他规则 部分,启用您要使用的规则。

  4. 使用搜索字段通过关键字(例如 article 或 comma )筛选规则列表。

    按域配置写作风格

自动修复简单问题

有些错误足够简单,可以自动修复。 例如,您可以指定首选的破折号样式,并确保 IDE 会将您使用的任何破折号或连字符转换为适合您的正确样式。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 编辑器 | 自然语言。

  2. 请选择 在您键入时自动修复简单问题(例如,将连字符转换为破折号)。

自动下载语言更新

可以配置 IDE,以便在打开项目时自动更新语言包。 此选项默认禁用。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 编辑器 | 自然语言。

  2. 选择 自动下载语言更新 复选框。

例外

例外是您希望始终视为正确的单词和短语。 如果某条规则在您不希望高亮显示的短语中触发了错误,您无需禁用该规则,因为这样它在该规则有效的其他位置将不会被触发。 在这种情况下,您可以使用 Alt+Enter 菜单将该短语添加为例外。

用于添加例外的意图操作

查看所有已添加的例外

  1. 按 Ctrl+Alt+S ,或在菜单中选择 文件 | 设置 (Windows 和 Linux)或 %instance% | 偏好设置 (macOS),然后在左侧选择 编辑器 | 自然语言 | 语法和风格。

  2. 在 例外 选项卡上,您可以查看添加为例外的单词和短语列表。 选择该例外并点击 “移除”按钮 以将其移除。

2026年 11月 3日