# Pytest

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/clion/llms.txt).

创建：  `运行 | 编辑配置 |`  ![添加新配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  `| Python 测试 | pytest`

> **Note:**
> 如果使用 [pytest-cov](https://pypi.org/project/pytest-cov/) 插件，可能会干扰调试器。 为避免此情况，请在对话框的   附加参数   字段中添加  `--no-cov -s` 。

使用此对话框为 [pytests](http://pytest.org) 创建运行/调试配置。

## 工具栏

运行/调试配置的树状视图具有一个工具栏，可帮助您管理 项目 中可用的配置，并调整默认配置模板。

|  项  |  快捷方式  |  描述  |
| --- | --- | --- |
|  ![添加按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  创建运行/调试配置。  |
|  !["移除"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  删除选定的运行/调试配置。 请注意，您不能删除默认配置。  |
|  ![复制](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.copy.svg)  |  `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  创建选定运行/调试配置的副本。 请注意，您正在创建默认配置的副本。  |
|  ![保存配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.save.svg)  |  |  仅当您选择一个 [临时配置](null)时才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。  |
|  ![移动到新文件夹／创建新文件夹](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.actions.newFolder.svg)  |  |     移入新建文件夹／新建文件夹。 您可以通过 [将它们放入文件夹](run-debug-configuration.html#config-folders)来对运行/调试配置进行分组。       要创建文件夹，请选择某个类别中的配置，点击 ![文件夹](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.nodes.folder.svg)，并指定文件夹名称。 如果只有一个类别处于焦点状态，则会创建一个空文件夹。       然后，为了将配置移动到文件夹中、文件夹之间或者文件夹外，请使用拖拽或 ![上移](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![下移](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.moveDown.svg) 按钮。       要删除分组，请选择一个文件夹，然后点击 ![删除配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)。     |
|  ![排序配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/test_car.py` 。 您可以输入路径或点击 ![浏览](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.menu-open.svg) 按钮在项目结构中定位文件。    * 项目中模块的名称，例如 `my_tests` 。 您可以输入模块名称，通过名称搜索目标模块，或在项目结构中定位它。    * 模块、脚本、类和方法的自定义组合，例如 `my_tests.test_car.TestCar.test_brake` ，其中： * `my_tests` ：包名称 * `test_car` ：模块名称 * `TestCar` ： `test_car` 中的类实例 * `test_brake` ： `TestCar` 类中的方法    |
|  附加参数  |     在此文本字段中，指定要按原样传递给测试的附加框架特定参数，例如：       ``` --some-argument=some-value  ```     > **Warning:** > 不推荐使用此选项，仅应由希望启动 CLion 不支持的内容的专家使用。    |
|  关键字  |  用于匹配测试名称的表达式。 请参阅 [docs.pytest.org](https://docs.pytest.org/en/latest/example/markers.html#using-k-expr-to-select-tests-based-on-their-name) 上的示例。  |
|  环境变量  |  点击浏览按钮或按 `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⇧ ⏎` (Xcode), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⇧ ⏎` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `⌘ ⏎` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS)) 指定所需的环境变量集合，并在“环境变量”对话框中进行设置。 要创建新变量，请点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)，然后输入所需的名称和值。  |
|   Docker 容器设置    > **Warning:** > 仅当为项目选择了 [基于 Docker 的远程解释器](docker.html) 时，此字段才会出现。     > **Note:** > 关于某些选项（  `--net` 、  `--link`  等）的设置对应关系，请注意，这些选项来自 [Docker 命令行参数](https://docs.docker.com/engine/reference/commandline/run/)。      点击 ![“浏览”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.ellipsis.svg) 打开对话框并指定以下设置：     |
|  选项  |      * 禁用网络 ：选中此复选框以禁用网络。 这对应于 `--net="none"` ，这意味着在容器内无法访问外部网络资源。    * 网络模式 ：对应于选项 `--net` 的其他值。 * `bridge` 是默认值。 将为容器分配一个 IP 地址，该地址位于桥接网络上，流量将通过此桥接路由到容器。 默认情况下，容器可以通过其 IP 地址通信。 若要通过名称通信，它们必须彼此链接。 * `host` ：在容器中使用主机的网络堆栈。 * `container:<name\|id>` ：使用另一个容器的网络堆栈，该容器通过其 名称 或 ID 指定。 有关更多信息，请参阅 [网络设置](https://docs.docker.com/engine/reference/run/#network-settings)文档。    * 链接 ：使用此部分将要创建的容器与其他容器链接。 这适用于 `Network mode = bridge` 并对应于 `--link` 选项。    * 发布所有端口 ：将所有容器端口暴露给主机。 这对应于 `--publish-all` 选项。    * 端口绑定 ：指定 [端口绑定](https://docs.docker.com/engine/reference/run/#expose-incoming-ports) 的列表。 与使用 `-p` 选项 `docker run` 类似。    * 额外主机 ：对应于 `--add-host` 选项。 有关更多信息，请参阅 [管理 /etc/hosts](https://docs.docker.com/engine/reference/run/#managing-etc-hosts)。    * 卷绑定 ：使用此字段指定特殊文件夹（ 卷 ）与运行 Docker 守护进程的计算机文件夹之间的绑定。 这对应于 `-v` 选项。 有关更多信息，请参阅 [管理容器中的数据](https://docs.docker.com/userguide/dockervolumes/)。    * 环境变量 ：使用此字段指定环境变量及其值的列表。 对应于 `-e` 选项。 有关更多信息，请参阅 [ENV（环境变量）](https://docs.docker.com/engine/reference/run/#env-environment-variables)。      点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.moveDown.svg) 展开表格。 点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)、 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)或 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.edit.svg)以组成列表。     |

## 附加选项

点击   修改选项  ，然后选择您要添加到对话框的选项。

### 操作系统

|  项  |  描述  |
| --- | --- |
|     允许多个实例     |     允许并行运行多个此运行配置实例。       默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，CLion建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。     |

### Python

|  项  |  描述  |
| --- | --- |
|  解释器选项  |  在此字段中，指定要传递给解释器的 [命令行选项](https://docs.python.org/3/using/cmdline.html#command-line)。 如果需要，请点击 ![展开字段](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.expandComponent.svg)，并在编辑器中键入字符串。  |
|  将内容根添加到 PYTHONPATH  |  选中此复选框以将项目的所有 [内容根](null) 添加到环境变量 PYTHONPATH。  |
|  将源代码根添加到 PYTHONPATH  |  选中此复选框以将项目的所有 [源根](null) 添加到环境变量 PYTHONPATH。  |

### 调试

|  项  |  描述  |
| --- | --- |
|  仅调试我的代码  |  启用该选项后，调试器只关注用户编写的代码，并跳过外部库。  |

### 日志

以下选项与记录此配置的执行相关。 欲了解更多信息，请参阅 [](null)。

|  项  |  描述  |
| --- | --- |
|     指定要在控制台中显示的日志     |     指定在运行应用程序时显示哪些日志文件。       点击 ![添加按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 以添加新的日志。 在   编辑日志文件别名  对话框中，配置以下内容：        * 别名 ：显示日志的选项卡的名称。    * 日志文件位置 ：请指定日志文件的路径或 [Ant pattern](https://ant.apache.org/manual/dirtasks.html)。 如果多个滚动日志文件匹配该模式，CLion 将显示最新的一个。    * 显示所有可由模式匹配的文件 ：显示所有符合模式的日志。      对于表格中的日志，您可以配置以下选项：        * 是否激活 ：显示指定的日志文件。    * 跳过内容 ：不要显示以前运行的旧日志消息。    |
|     将控制台输出保存到文件     |  将控制台输出保存到指定位置。 请手动输入路径或点击浏览按钮，并在打开的 [对话框中](select-path-dialog.html)指向所需位置。  |
|     当消息打印到 stdout 时显示控制台     |  当应用程序写入标准输出流时激活控制台。  |
|     当消息打印到 stderr 时显示控制台     |  当应用程序写入标准错误流时激活控制台。  |

### 启动前

|  项  |  描述  |
| --- | --- |
|     启动时打开运行/调试工具窗口     |     默认情况下，此选项被选中，在您启动运行/调试配置时， [Run](run-tool-window.html) 或 [Debug](debug-tool-window.html) 工具窗口会打开。       否则，工具窗口将被隐藏。 但是，当配置正在运行时，您可以通过按 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS)) 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS)) 自行打开相应的工具窗口。     |
|     启动时聚焦运行/调试工具窗口     |     选择此选项后，启动运行/调试配置时会自动将焦点移动到 [Run](run-tool-window.html) 或 [Debug](debug-tool-window.html) 工具窗口。     |
|     启动前显示运行/调试配置设置     |     选择此选项可在实际启动运行/调试配置前显示运行/调试配置设置。     |
|     添加启动前任务     |     选择此选项以添加下列可用任务之一：        * 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。 如果它在 CLion 中尚未定义，请添加其定义。 如需更多信息，请参阅 [外部工具](configuring-third-party-tools.html)和 [外部工具](settings-tools-external-tools.html)。    * 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 [复合运行/调试配置](run-debug-multiple.html#compound-configs)。    * 运行 File Watchers​ ：选择此选项以让 CLion 应用所有当前活动的 [文件监视器](using-file-watchers.html)。    * 运行 Grunt 任务 ：选择此选项来运行 Grunt 任务。 在打开的 Grunt 任务 对话框中，指定定义所需任务的 `Gruntfile.js` ，选择要执行的任务，并指定传递给 Grunt 工具的参数。 指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。    * 运行 Gulp 任务 ：选择此选项以运行 Gulp task。 在打开的 Gulp 任务 对话框中，指定定义所需任务的 `Gulpfile.js` ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。 指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。    * 运行 npm 脚本 ：选择此选项来执行 npm 脚本。 在 NPM Script 对话框中，指定 [npm run/debug configuration settings](null)。    * 编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为: * 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。 * 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。    * 生成 CoffeeScript 源地图 ：选择此选项以生成 [CoffeeScript](coffeescript.html) 源代码的源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。    |

## See also

### 流程

[运行/调试配置](run-debug-configuration.html)

### 语言和框架特定指南

### 外部链接

[pytest feature overview](http://pytest.org)

