PyCharm 2025.3 Help

更改检查严重性

检查严重级别表示检测到的代码问题对您的项目造成影响的严重程度。 在 PyCharm 中,提供了一组预定义的严重级别:

错误图标错误

语法错误

警告图标警告

可能产生错误或需要改进的代码片段

弱警告图标弱警告

可以改进或优化的代码片段(冗余代码、重复的代码片段等)

服务器问题图标服务器问题

来自外部构建服务器的问题,例如来自 TeamCity

拼写错误图标语法错误

语法错误。 此严重级别来自捆绑的 自然语言 插件。 有关详细信息,请参阅 语法

拼写错误图标拼写错误

拼写错误和错别字。 有关详细信息,请参阅 拼写检查

考虑因素

可以改进的代码片段。 此严重级别不会在 错误标记栏 上标记,且没有默认的高亮显示样式,但您可以从现有样式列表中选择一种,或配置您自己的样式。

无高亮显示(修复可用)

无代码高亮显示,但您可以按下 Alt+Enter 调用修复。

对于每个严重级别,您都可以在编辑器中配置其高亮显示样式。

严重级别用于指示问题,对代码执行没有任何影响:如果您将拼写错误的严重级别从 拼写错误 更改为 错误 ,这不会影响应用程序的执行。

在所有范围中更改检查严重性

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

  2. 选择要修改的配置文件,然后从列表中选择一个检查。 请确保其已启用。

  3. 严重性(V) 列表中,选择一个新的严重级别。 您也可以右键点击该检查,并从上下文菜单中选择严重级别。

    如果列表中没有所需的严重级别,请点击 编辑严重性创建一个新的

  4. 编辑器中的高亮显示 列表中,选择要用于在编辑器中高亮显示代码片段的样式。

    选择 编辑高亮显示修改现有样式

    为检查选择严重级别
  5. 应用更改并关闭对话框。

    现在,已修改的检查将在所选配置文件中具有新的严重级别。

在特定范围中更改检查严重性

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

  2. 选择要修改的配置文件,然后从列表中选择一个检查。 请确保其已启用。

  3. 作用域 列表中,选择要更改严重级别的范围。

    PyCharm 会显示两个范围的严重性:所选范围和 其他所有位置

    若要再添加一个范围,请点击 添加按钮。 如果您想创建新范围,请在范围列表中选择 编辑作用域顺序 ,并点击 编辑图标

  4. 严重性 列表中选择所需的严重级别。

    如果列表中没有所需的严重级别,请点击 编辑严重性创建一个新的

    按范围更改检查严重性
  5. 此外,在 编辑器中的高亮显示 列表中,选择要用于在编辑器中高亮显示代码片段的样式。

    选择 编辑高亮显示修改现有样式

如果您在多个范围中启用了某个检查,且这些范围中的文件匹配, IDE 将按照列表中的顺序处理这些范围。 有关详细信息,请参阅 更改范围顺序

配置错误高亮显示

  1. Ctrl+Alt+S 打开 IDE 设置,并选择 编辑器 | 配色方案 | 常规

    您也可以在检查设置中配置高亮显示:转到 编辑器 | 检查 ,点击任一已启用的检查,并在 编辑器中的高亮显示 列表中选择 编辑高亮显示

  2. 错误和警告 列表中,选择要修改的样式。

  3. 使用右侧的选项配置新的高亮显示规则。 要在应用之前预览更改,请使用对话框底部的预览部分。

    更改错误高亮显示

创建新的严重级别

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

  2. 选择要在其中创建新严重级别的配置文件。

  3. 点击任一检查,并在严重级别列表中选择 编辑严重性

  4. 严重性编辑器 对话框中,点击 添加按钮 ,并为新的严重级别命名。

  5. 使用 上移下移 按钮配置格式并设置优先级——您在列表中将严重级别放得越高,其优先级就越高。

  6. 完成后,点击 确定

    创建新的严重级别

使用范围管理 Python 版本兼容性

您可以使用兼容性检查来管理在同一窗口中打开的不同项目所需的 Python 版本。

  1. Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 作用域

  2. 点击 添加按钮 ,并为其中一个项目创建一个新范围。 然后为在同一窗口中打开的另一个项目再创建一个范围。

    创建项目专用范围

    点击 应用(A) 以使用新创建的范围。

  3. 切换到 编辑器 | 检查 设置,并在检查搜索列表中开始键入"不兼容"。 选择 Python 兼容性检查。

    在 Python 兼容性检查中使用基于项目的范围
  4. 严重性(V) 设置的范围列表中,选择新创建的基于项目的范围。 检查所选范围所需的 Python 版本。 点击 确定 以保存更改。

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