运行检查
PyCharm 分析编辑器中打开的文件中的代码 并在您输入时高亮显示有问题的代码。 此外,您可以在选定的文件范围内 手动运行必要的检查或一组检查。 在这种情况下,您将获得一个有关文件中检测到的所有问题的综合报告。
当前文件的即时分析
IDE 会持续检查您的代码并查找问题。 编辑器右上角的小组件显示当前文件中检测到的每个 严重性的问题数量:
点击小部件以在 文件 选项卡中的 问题工具窗口中打开问题列表。 您还可以通过选择 或按 Alt+6 来访问 问题 工具窗口。
对于每个问题,您可以通过按 Alt+Enter 或点击 查看建议的快速修复。 要跳转到编辑器中的相应行,请按 F4 或在工具窗口中双击该问题。
点击 即可在工具窗口中查看和修复问题。
滚动条中的颜色条还标记了检测到的代码问题,并帮助您快速访问相应的行,而无需滚动文件。 将鼠标悬停在条纹上的标记上,以在工具提示中查看检测到的问题。 点击标记以跳转到对应的行。

导航至检测到的问题
您可以通过点击挂件中的
或按 F2 或 Shift+F2 相应地在文件中的一个高亮问题与另一个之间跳转。 默认情况下,IDE 会根据问题的 严重性导航您:错误>警告>弱警告>服务器问题>拼写错误。
您可以配置 PyCharm 引导您逐一解决问题,无论其严重程度如何。 将鼠标悬停在编辑器右上角的小部件上,点击 ,选择 “下一个错误”操作(F2)进行 ,并启用 所有问题。
手动运行检查
某些检查需要全局代码分析,所以它们在编辑器中被禁用。 这些检查列出了 并选择 仅显示批处理模式检查。
如果您想获得代码中所有问题的完整报告,请手动运行检查。 在这种情况下,IDE 会运行 您 的 inspection profile 中启用的所有检查,并在专用的工具窗口中显示结果。 完成分析所需的时间取决于启用的检查数量和分析范围的大小。
运行所有检查
在主菜单中,转到
。请选择您要分析的 文件范围。
点击
图标以配置新的范围。
请选择您要应用的 inspection profile。
要创建新配置文件或修改现有配置文件之一,请点击 配置…。
点击 分析 以开始分析。

指定检测范围对话框
项目 | 描述 |
---|---|
整个项目 | 检查整个项目。 |
模块 <name> | 检查当前在 项目 工具窗口 Alt+1 中选择的模块。 |
文件<名称> | 检查当前在 项目 工具窗口中选择或在编辑器中打开的文件。 |
选定的文件 | 检查当前在 项目 工具窗口中选择的文件。 |
未提交的文件 | 该作用域仅适用于版本控制下的项目。 仅检查尚未提交到版本控制系统的文件。 |
目录 | 检查当前在 项目 工具窗口中选择的目录。 |
自定义范围 | 检查自定义文件范围。 从列表中选择一个预定义范围,或点击 |
检查注入代码 | 检查嵌入在您的代码中的 其它语言的代码片段。 |
检查配置文件: | 请选择一个您要用于检查代码的 profile。 如果所需的配置文件不在列表中,请点击 配置 并创建一个新配置文件。 |
运行单个检查
运行单个检验在您想要跟踪特定问题的情况下很有用。 如果您在文件中发现警告,您可以检查整个项目或必要的文件范围,以确保代码库中没有更多此类警告。
按 Ctrl+Alt+Shift+I 或进入主菜单中的
。在弹出窗口中输入检查名称。 请使用 CamelHumps 匹配骆驼拼写法单词和单词首字母的大写空格。 建议列表会显示与您的搜索请求匹配的检查。
如果您不确定选择的是正确的检查,您可以查看其描述。 要执行此操作,请在弹出窗口中选择一个 inspection 并按 Ctrl+Q。
双击所需的检查。
在打开的对话框中,选择您想要分析的文件范围。
文件掩码(K) 选项有助于减少将要检查的文件数量。
请选择复选框并指定字符和通配符模式,以匹配您想要分析的文件名称。 使用逗号分隔多个文件掩码。
某些检查可能会有其他选项,系统会提示您进行配置。
这些设置仅适用于此次运行,不会影响当前配置文件中此检查的配置。
IDE 会在专用工具窗口中向您显示检查结果。 在那里您可以检查并修复检测到的问题。
在提交时分析代码
如果您的项目在 Git 或 Mercurial 版本控制下,您可以配置 IDE 在提交之前分析修改后的文件。
按 Alt+0 打开 提交 工具窗口,然后点击 显示提交选项
。
在 提交检查 区域,选择 分析代码(A) 复选框。
点击 选择配置文件 ,并选择所需的 检查配置文件 ,IDE 将从中运行检查。
点击 提交(I)。
PyCharm 通过运行所选配置文件中的检查来分析修改文件中的代码。
如果检测到任何错误或警告,您将看到通知。
在通知中,点击 检查代码分析(R) 以查看在 消息 工具窗口中检测到的问题列表。 点击 忽略 提交您的更改,而无需修复检测到的问题。
使用 Qodana 运行代码检查
默认情况下,该插件在 PyCharm 中捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。 有关更多信息,请参见 打开插件设置。
您可以使用 Qodana 本地或远程检查您的代码。 Qodana 的主要用例是在 CI/CD 服务器上远程执行资源密集型代码分析。 但是,您也可以在 IDE 中运行相同的分析,以确保获得相同的结果,并能够在源代码中定位检测到的问题。
在主菜单中,转到
。请选择您希望在哪里运行检查:本地或在您的 CI/CD 服务器上。
要在服务器上运行检查,您需要先在 CI 上设置 Qodana。
Qodana 配置文件已打开。 在此文件中,您可以指定 Qodana 检查配置文件,启用或禁用特定检查,并指定在分析之前应安装的插件列表。
点击 运行。
分析完成后,报告将在 问题 工具窗口的 服务器端分析 选项卡中显示。 您可以在本地处理结果或将其发送到 Qodana Cloud。

所有本地运行的 Qodana 分析报告都已保存,可从主菜单访问:
。 当前打开的报告旁有一个复选标记,您可以点击它来关闭报告。有关 Qodana 的更多信息,请参阅其 文档。
离线运行检查
除了从 IDE 运行代码检查之外,您还可以从命令行启动检查,而无需实际运行 PyCharm。 检查结果将存储在 XML 文件中。 有关更多信息,请参见 从命令行运行代码检查。
更改范围顺序
默认情况下,所有启用的代码检查会分析您项目中的所有文件。 根据您的需求,您可以在不同设置下,在多个文件范围内运行相同的检查。
如果一个文件包含在多个范围中,并且您在这些范围中启用了检查,PyCharm 将根据列表中的顺序处理它们。 列表顶部的范围具有最高优先级,将首先进行分析。
在 设置 对话框(Ctrl+Alt+S )中,选择 。
从列表中选择任意检查。
请从 在所有作用域中 列表中选择 编辑作用域顺序。
选择必要的范围,并使用
和
在列表中上下移动。
如果需要,创建一个新的 scope。 要执行此操作,请点击
(编辑作用域… ),指定范围设置,并选择要包含在其中的文件和文件夹。