PyCharm 2025.3 Help

运行测试

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

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

如果您运行的测试尚无永久的运行/调试配置,将会创建一个临时配置。 随后,如果您希望稍后复用此配置,可以使用 运行/调试配置 对话框将其保存。

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

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

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

从 结构 工具窗口运行测试

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

    从工具窗口运行代码

PyCharm 会为该测试创建一个临时运行配置。 要重新使用此配置,请 将其保存 ,并在必要时进行编辑。

保存临时测试配置

在 PyCharm 完成运行测试后,会在 运行 工具窗口中该运行配置的选项卡上显示结果。 有关分析测试结果的更多信息,请参阅 查看测试结果

提交后运行测试

在推送之前,如果您想检查更改不会破坏代码,可以将测试作为提交前检查来运行。

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

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

    提交前检查菜单

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

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

运行或调试测试

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

  • 使用主工具栏:

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

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

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

  • 使用上下文菜单:

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

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

运行目录中的所有测试

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

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

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

    例如,选择 在 <目录名> 中运行 pytest'

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

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

并行运行测试

默认情况下,所有测试都会逐个执行。 对于 pytest 测试框架,您可以更改此行为,并行执行测试。

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

要显式指定用于执行测试的 CPU 数量:

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

  2. 将 pytest 指定为项目的测试框架。 有关更多详情,请参阅 测试框架

  3. 在主工具栏的运行/调试配置列表中选择 编辑配置...。 在 运行/调试配置 对话框中,展开 pytest 测试 组,然后选择 在 <目录名> 中运行 pytest

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

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

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

    并行运行测试

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

[pytest] addopts = -n3

终止测试执行

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

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

  • 或者,按 Ctrl+F2

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