PyCharm 2025.3 Help

语法

启用 Natural Languages 插件

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

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

  2. 打开 已安装 选项卡,找到 Natural Languages 插件,并选中插件名称旁的复选框。

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. 如果您的 IDE 已连接到 Writing Assistance Cloud ,您可以按域配置规则。

    领域 列表中,选择您希望配置规则的上下文,例如提交消息或代码注释。 然后在 常规 部分,启用您希望应用于所选上下文的规则。

    某些本地规则与基于云的规则可能会重叠。 在这种情况下,启用基于云的规则也会启用其关联的本地规则。

  5. 使用搜索字段通过关键字(例如 articlecomma )筛选规则列表。

    按域配置写作风格

自动修复简单问题

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

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

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

例外

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

用于添加例外的意图操作

查看所有已添加的例外

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

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

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