PyCharm 2025.2 Help

运行测试

通常,PyCharm 以与其他应用程序相同的方式运行和调试测试,通过运行 您创建的 运行/调试配置。 在执行此操作时,它会将指定的测试类或方法传递给测试运行器。

在许多情况下,您可以从上下文菜单启动测试会话。 为此,某些上下文菜单中提供了 运行调试 命令。 例如,这些命令可用于 项目工具窗口 中的测试类、目录或包。 它们也可用于您当前在编辑器中处理的测试类或方法。

如果您运行的测试没有永久的运行/调试配置,则会创建一个临时配置。 然后,您可以使用 运行/调试配置 对话框保存此类配置,以便稍后重用。

测试在后台运行,因此您可以同时执行多个测试。

每个运行配置在 运行工具窗口测试结果选项卡 )中都有自己的选项卡。 一个选项卡可以汇总多个测试。

另请注意,上下文菜单中显示的命令是上下文相关的,即显示的测试命令取决于测试运行器和调用此命令的位置。

从结构运行测试

  • 结构 工具窗口中,右键点击一个测试并选择 运行 '方法 name'Ctrl+Shift+F10)。

    从工具窗口运行代码

PyCharm 使用此测试创建一个临时运行配置。 要重新使用此配置,请 保存它并根据需要进行编辑。

保存临时测试配置

在 PyCharm 运行完您的测试后,它会在 运行 工具窗口中显示结果,并在该运行配置的选项卡上显示。 有关分析测试结果的详细信息,请参阅 探索测试结果

提交后运行测试

当您想检查更改是否会破坏代码时,可以通过运行测试作为提交检查来实现。

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

  2. 高级提交检查 菜单下, Run Tests 选项旁,点击 选择配置 并选择您要运行的配置。

    提交前检查菜单

在您设置好测试配置后,每次提交时都会运行指定的测试。

非模态提交对话框运行测试

运行或调试测试

要开始运行或调试测试,您可以使用主工具栏或 项目 工具窗口或编辑器中的上下文菜单:

  • 使用主工具栏:

    1. 从主工具栏的列表中选择所需的运行/调试配置。

      Alt+Shift+F10 查看可用运行配置列表或 Alt+Shift+F9 查看调试配置列表。

    2. 点击列表右侧的 运行 运行调试 调试。 或者,从主菜单中选择 运行 | 运行 Shift+F10运行│调试 Shift+F9

  • 使用上下文菜单:

    • 项目 工具窗口中右键点击测试文件或测试类,或在编辑器中打开它并右键点击背景。 从上下文菜单中选择 运行 <类名>/运行 <filename>调试...

    • 对于测试方法,在编辑器中打开类并在方法中的任意位置右键点击。 上下文菜单会建议命令 运行 / 调试 <方法名>

运行目录中的所有测试

  1. 在项目工具窗口中,选择包含要执行测试的目录。

  2. 从上下文菜单中选择相应的运行命令。

    如果目录包含属于不同 测试框架 的测试,请选择要使用的配置。

    例如,选择 运行 pytest 位于 <directory name>

    运行目录中的所有测试
  3. 在测试运行器中 查看结果

    从一个目录运行所有 pytest 测试

并行运行测试

默认情况下,所有测试逐一执行。 您可以更改 pytest 测试框架的此行为,并并行执行测试。

启用测试多进程以优化 pytest 测试的执行。

明确指定测试执行的 CPU 数量:

  1. 按照 安装、卸载和升级软件包 中的说明安装 pytest-xdist 包。

  2. 将 pytest 指定为项目测试框架。 请参阅 测试框架 了解更多详细信息。

  3. 从主工具栏的运行/调试配置列表中选择 编辑配置...。 在 运行/调试配置 对话框中,展开 Pytest 测试 组,并选择 pytest 位于 <directory name>

    当您第一次运行目录中的所有测试时,PyCharm 会创建此配置。 如果您尚未执行测试,请点击 "添加"按钮 图标并指定 运行/调试配置参数

  4. 运行/调试配置 对话框中,在 附加参数 字段中指定运行测试的 CPU 数量: -n <number of CPUs> 并保存更改。

    编辑一组 pytest 测试的运行/调试配置
  5. 现在再次运行目录中的所有测试,并在 运行 工具窗口中检查输出。 在所示示例中,总执行时间为 20s 26ms,而顺序运行相同测试时为 35s 11ms。 测试报告提供了有关运行测试所用 CPU 和执行时间的信息。

    并行运行测试

或者,您可以在 pytest.ini 文件中指定运行测试的 CPU 数量。 例如,

[pytest] addopts = -n3

终止测试执行

如果您可以停止正在运行的测试,则所有正在运行的测试会立即停止。 运行 工具窗口中的测试图标反映了测试的状态(通过、失败、中止)。

  • 运行 工具窗口中,点击 停止 按钮 停止按钮

  • 或者按 Ctrl+F2

最后修改日期: 2025年 9月 26日