CLion 2026.1 Help

Doctests

创建： 运行 | 编辑配置 | 添加新配置| Python 测试 | Doctests（文档测试）

使用此对话框为 Doctests创建运行/调试配置。

工具栏

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

项

快捷方式

描述

添加按钮

Alt+Insert

创建运行/调试配置。

"移除"按钮

Alt+Delete

删除选定的运行/调试配置。 请注意，您不能删除默认配置。

复制

Ctrl+D

创建选定运行/调试配置的副本。 请注意，您正在创建默认配置的副本。

保存配置

仅当您选择一个 临时配置时才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。

移动到新文件夹／创建新文件夹

移入新建文件夹／新建文件夹。 您可以通过 将它们放入文件夹来对运行/调试配置进行分组。

要创建文件夹，请选择某个类别中的配置，点击 文件夹 ，并指定文件夹名称。 如果只有一个类别处于焦点状态，则会创建一个空文件夹。

然后，为了将配置移动到文件夹中、文件夹之间或者文件夹外，请使用拖拽或 上移 和 下移 按钮。

要删除分组，请选择一个文件夹，然后点击 删除配置。

排序配置

点击此按钮以按字母顺序排序配置。

常用选项

项

描述

名称

为运行配置指定一个名称，以便在编辑或运行时能快速识别。

允许多个实例

允许并行运行多个此运行配置实例。

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

存储为项目文件

将运行配置设置保存到文件中，以便与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。

默认情况下，它是禁用的，并且 CLion 将运行配置设置存储在 .idea/workspace.xml 。

配置选项

项

描述

Doctests

测试

点击一个单选按钮以定义测试作用域（文件夹中的所有测试、脚本中的所有测试、测试类、单个测试方法或函数）。

接下来，指定测试的位置。 此部分中的字段根据 测试 部分中选择的测试类型启用。

  • 文件夹中的全部 ：对于此测试作用域，请指定以下参数：

    文件夹 ：输入包含要执行的测试的目录路径，或点击浏览按钮并在 选择路径 对话框中选择所需的目录。

    模式 ：输入文件名应匹配的一个或多个模式，以将这些文件视为测试。 使用逗号作为分隔符。 模式应为 Python 正则表达式。

  • 脚本 ：对于此作用域，指定包含要执行测试的脚本名称。

  • 类 ：对于此作用域，指定脚本名称和测试类。

  • 方法 ：对于此作用域，指定脚本名称、测试类和测试方法。

  • 函数 ：对于此作用域，指定脚本名称和测试方法。

环境

环境变量

点击浏览按钮或按 Shift+Enter 指定所需的环境变量集合，并在“环境变量”对话框中进行设置。 要创建新变量，请点击 ，然后输入所需的名称和值。

Python 解释器

选择一个预配置的 Python 解释器。

解释器选项

在此字段中，指定要传递给解释器的 命令行选项。 如果需要，请点击 展开字段 ，并在编辑器中键入字符串。

工作目录

指定运行任务所需的目录。

  • 当通过键盘快捷键 Ctrl+Shift+F10 创建默认运行/调试配置，或从脚本的上下文菜单选择 运行 时，工作目录为包含可执行脚本的目录。 此目录可能与项目目录不同。

  • 当该字段留空时，将使用 CLion 安装的 bin 目录。

您可以在此字段中使用 路径变量。

将内容根添加到 PYTHONPATH

选中此复选框以将项目的所有 内容根 添加到环境变量 PYTHONPATH。

将源代码根添加到 PYTHONPATH

选中此复选框以将项目的所有 源根 添加到环境变量 PYTHONPATH。

Docker 容器设置

点击 “浏览”按钮 打开对话框并指定以下设置：

选项

  • 禁用网络 ：选中此复选框以禁用网络。 这对应于 --net="none" ，这意味着在容器内无法访问外部网络资源。

  • 网络模式 ：对应于选项 --net 的其他值。

    • bridge 是默认值。 将为容器分配一个 IP 地址，该地址位于桥接网络上，流量将通过此桥接路由到容器。

      默认情况下，容器可以通过其 IP 地址通信。 若要通过名称通信，它们必须彼此链接。

    • host ：在容器中使用主机的网络堆栈。

    • container:<name|id> ：使用另一个容器的网络堆栈，该容器通过其 名称 或 ID 指定。

    有关更多信息，请参阅 网络设置文档。

  • 链接 ：使用此部分将要创建的容器与其他容器链接。 这适用于 Network mode = bridge 并对应于 --link 选项。

  • 发布所有端口 ：将所有容器端口暴露给主机。 这对应于 --publish-all 选项。

  • 端口绑定 ：指定 端口绑定 的列表。 与使用 -p 选项 docker run 类似。

  • 额外主机 ：对应于 --add-host 选项。 有关更多信息，请参阅 管理 /etc/hosts。

  • 卷绑定 ：使用此字段指定特殊文件夹（卷 ）与运行 Docker 守护进程的计算机文件夹之间的绑定。 这对应于 -v 选项。 有关更多信息，请参阅 管理容器中的数据。

  • 环境变量 ：使用此字段指定环境变量及其值的列表。 对应于 -e 选项。 有关更多信息，请参阅 ENV（环境变量）。

点击 展开表格。 点击 、 或 以组成列表。

日志

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

项

描述

指定要在控制台中显示的日志

指定在运行应用程序时显示哪些日志文件。

点击 添加按钮 以添加新的日志。 在 编辑日志文件别名 对话框中，配置以下内容：

  • 别名 ：显示日志的选项卡的名称。

  • 日志文件位置 ：请指定日志文件的路径或 Ant pattern。 如果多个滚动日志文件匹配该模式，CLion 将显示最新的一个。

  • 显示所有可由模式匹配的文件 ：显示所有符合模式的日志。

对于表格中的日志，您可以配置以下选项：

  • 是否激活 ：显示指定的日志文件。

  • 跳过内容 ：不要显示以前运行的旧日志消息。

将控制台输出保存到文件

将控制台输出保存到指定位置。 请手动输入路径或点击浏览按钮，并在打开的 对话框中指向所需位置。

当消息打印到 stdout 时显示控制台

当应用程序写入标准输出流时激活控制台。

当消息打印到 stderr 时显示控制台

当应用程序写入标准错误流时激活控制台。

启动前

在此区域，您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按它们在列表中出现的顺序执行。

项

快捷方式

描述

添加按钮

Alt+Insert

点击此图标以添加下列可用任务之一：

  • 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。 如果它在 CLion 中尚未定义，请添加其定义。 如需更多信息，请参阅 外部工具 和 外部工具。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 复合运行/调试配置。

  • 运行 File Watchers​ ：选择此选项以让 CLion 应用所有当前活动的 文件监视器。

  • 运行 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。

  • 编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为:

    • 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。

    • 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。

  • 生成 CoffeeScript 源地图 ：选择此选项以生成 CoffeeScript 源代码的源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。

"移除"按钮

Alt+Delete

点击此图标可将所选任务从列表中移除。

编辑

Enter

点击此图标可编辑选定的任务。 在打开的对话框中进行必要的更改。

方法向上

方法 down

Alt+Up

Alt+Down

点击这些图标以在列表中将所选任务上移或下移一行。 任务将按照它们在列表中出现的顺序执行。

显示此页面

选择此复选框，以便在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。

否则，如果复选框未选中，工具窗口将被隐藏。 但是，当配置正在运行时，您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。

聚焦工具窗口

选中此复选框以在启动运行/调试配置时自动将焦点移至 Run 或 Debug 工具窗口。

2026年 3月 24日
Python 测试Nosetests