PyCharm 2026.2 Help

获取结果并修复问题

如果某项检查在您的代码中检测到问题,您可以在编辑器中快速应用修复。 将插入符号置于高亮的代码处,然后按下 Alt+Enter。

PyCharm 会在某些检查的快速修复旁显示交互式预览。 您可以按下 Ctrl+Q 隐藏或显示此预览。

在问题工具窗口中应用修复

如果您手动调用了检查,分析完成后会自动打开 问题 工具窗口,您可以在其中查看结果。 检测到的所有问题都会列在工具窗口左侧。 点击某个问题,可在右侧显示检查详细信息。

  • 要修复问题,请点击工具栏或上下文菜单中的 意图操作按钮 图标。 您也可以按下 Alt+Enter ,并在弹出菜单中选择合适的修复。

  • 如果某个问题在文件中出现多次,您可以一次性修复其所有出现。 选择问题描述,点击工具栏中的 意图操作按钮 图标,选择相应的修复,然后在列表中选择 修复文件中所有 "<问题描述>"。

问题工具窗口

清理代码

您可以通过运行 代码清理 来简化修复代码问题的过程。 这样,您无需逐一检查每个问题,即可将快速修复批量应用于所选范围。

在清理期间, IDE 会应用所选 检查配置文件 中的代码清理检查所提供的修复。 要查看这些检查的列表,请按下 Ctrl+Alt+S 打开 设置 对话框,转到 编辑器 | 检查 ,点击 筛选检查按钮 ,并启用 仅显示清理检查项 选项。

批量应用快速修复(代码清理)

  1. 在主菜单中,转到 代码 | 代码清理。

  2. 在 指定代码清理范围 对话框中,选择要应用配置文件的范围。

  3. 在 检查配置文件 列表中选择检查配置文件,或点击 配置… 创建新配置文件。

    您也可以点击 配置… 查看所有代码清理检查及其设置。

  4. 点击 分析 启动清理。

    指定代码清理范围对话框

PyCharm 将执行代码分析,并对检测到的问题应用所选检查配置文件中的快速修复。

或者,您可以将插入符号置于源代码中对应快速修复的错误处,点击左侧出现的红色灯泡 快速修复图标 (建议的快速修复),然后在菜单中选择 代码清理。

运行静默清理

您还可以在静默模式下运行代码清理,而不显示 指定代码清理范围 对话框。 在这种情况下, IDE 将运行设置中当前配置的 配置文件 中的清理检查。

  1. 在 项目 工具窗口 (Alt+1) 中选择要清理代码的节点。

    否则,清理将在编辑器中当前打开的文件中运行。

  2. 在主菜单中,转到 代码|分析代码|静默代码清理。

在提交时清理代码

如果您的项目受 版本控制 管理,您可以在将更改提交到存储库时清理代码。

  1. 按 Alt+0 打开 提交 工具窗口,然后点击 显示提交选项 设置按钮。

  2. 在 提交检查 区域,选中 清理 复选框。

  3. 点击 配置 ,并选择 IDE 将从中运行检查的所需 检查配置文件。

  4. 单击 提交。

在保存时自动清理代码

您可以将 IDE 配置为在更改已 保存 时自动清理已修改文件中的代码。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 工具 | 保存时的操作。

  2. 启用 运行代码清理 选项。

    此外,您可以点击 配置检查… ,指定 IDE 将从中运行代码清理检查的 检查配置文件。

导出结果

运行检查后,结果会显示在 问题 工具窗口的专用选项卡中。 您可以将其导出为可用的格式之一。

  1. 在 问题 工具窗口(视图 | 工具窗口 | 问题 或 Alt+6 )中,切换到包含您要导出的检查结果的选项卡,然后点击 Export 按钮。

    检查结果工具窗口中的导出按钮
  2. 选择要保存报告的格式: HTML、 SARIF (按照 SARIF 规范格式化的 JSON 文件),或 XML。

    如果启用了 Qodana 插件,则可使用 SARIF 格式。

  3. 指定目标目录,然后点击 保存。

2026年 7月 14日