Pycharm
 
2023.3
快捷方式：Windows
获取 PyCharm
  1. 参考
  2. 运行/调试配置对话框
  3. Python 测试
  4. 运行/调试配置：Doctests

运行/调试配置：Doctests

最后修改时间：2023 年 9 月 1 日

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

在文档字符串中：

  • PyCharm 可以识别 Python 代码，提供语法突出显示、代码完成和解析以及 Python 检查。

  • 可以打开或关闭识别 Python 代码的能力。

  • 如果作为单独的文件出现，PyCharm 允许打开带有.rstdoctests扩展名的 reStructuredText 文件。此类文件标有图标，并具有语法突出显示功能。具有重组文本的文件

配置选项卡

物品

描述

测试

单击单选按钮之一来定义测试范围（文件夹中的所有测试、脚本中的所有测试、测试类、单个测试方法或函数。）

接下来，指定测试的位置。此部分中的字段是否启用取决于测试部分中选择的测试类型。

  • 文件夹中的所有测试：对于此测试范围，指定以下参数：

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

    模式：键入文件名应与要考虑测试的文件匹配的一个或多个模式。使用逗号作为分隔符。模式应该是 Python 正则表达式。

  • 脚本中的测试：对于此范围，指定包含要执行的测试的脚本的名称。

  • 测试类：对于此范围，指定脚本和测试类的名称。

  • 测试方法：对于此范围，指定脚本的名称、测试类和测试方法。

  • 测试功能：对于此范围，指定脚本的名称和测试方法。

环境变量

单击浏览按钮，或按在“环境变量”对话框中指定所需的环境变量集。要创建新变量，请单击，然后键入所需的名称和值。ShiftEnter应用程序常规添加

Python解释器

从列表中选择预配置的Python 解释器之一。

笔记

当 PyCharm 停止支持任何过时的 Python 版本时，相应的 Python 解释器将被标记为不受支持。

不支持的 Python 解释器

口译员选项

在此字段中，指定要传递给解释器的命令行选项。如有必要，单击扩大领域，然后在编辑器中键入字符串。

工作目录

指定运行任务要使用的目录。

  • 当通过键盘快捷键或从脚本的上下文菜单中选择“运行”创建默认运行/调试配置时，工作目录就是包含可执行脚本的目录。该目录可能与项目目录不同。CtrlShiftF10

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

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

将内容根添加到 PYTHONPATH

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

将源根添加到 PYTHONPATH

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

Docker 容器设置

警告

仅当为项目选择基于 Docker 的远程解释器时，才会出现此字段。

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

选项

  • 发布所有端口：向主机公开所有容器端口。这对应于选项--publish-all。

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

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

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

  • 运行选项：使用此字段指定Docker 命令行选项。

单击应用程序操作向下移动以展开表格。单击应用程序常规添加、应用程序常规删除、 或应用程序操作编辑来组成列表。

日志选项卡

使用此选项卡可以指定在运行或调试时生成的哪些日志文件应显示在控制台中，即显示在“运行”或“调试”工具窗口的专用选项卡上。

物品

描述

活跃

选中此列中的复选框可使日志条目显示在“运行”工具窗口或“调试”工具窗口的相应选项卡中。

日志文件条目

此列中的只读字段列出了要显示的日志文件。该列表可以包含：

  • 特定文件的完整路径。

  • 用于替代完整路径或模式的别名。这些别名也会显示在显示相应日志文件的选项卡的标题中。

    如果日志条目模式定义了多个文件，则选项卡标题将显示文件的名称，而不是日志条目别名。

跳过内容

选中此复选框可跳过所选日志的先前内容。

将控制台输出保存到文件

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

当消息打印到标准输出流时显示控制台

选中此复选框可激活输出控制台，并在关联进程写入 Standard.out 时将其向前显示。

当消息打印到标准错误流时显示控制台

选中此复选框可激活输出控制台，并在关联进程写入 Standard.err 时将其向前显示。

添加按钮

单击此按钮可打开“编辑日志文件别名”对话框，您可以在其中选择新的日志条目并为其指定别名。

编辑按钮

单击此按钮可在“编辑日志文件别名”对话框中编辑所选日志文件条目的属性。

删除按钮

单击此按钮可从列表中删除选定的日志条目。

浏览按钮

单击此按钮可编辑所选日志文件条目。仅当选择条目时该按钮才可用。

常用设置

当您编辑运行配置（但不是运行配置模板）时，您可以指定以下选项：

物品

描述

姓名

指定运行配置的名称，以便在编辑或运行时快速识别它。

允许多个实例

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

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

存储为项目文件

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

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

工具栏

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

物品

捷径

描述

添加按钮

AltInsert

创建运行/调试配置。

删除按钮

AltDelete

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

复制

Ctrl0D

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

保存配置

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

移入新文件夹/创建新文件夹

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

要创建文件夹，请选择类别中的配置，单击文件夹，然后指定文件夹名称。如果仅关注某个类别，则会创建一个空文件夹。

然后，要将配置移入文件夹、文件夹之间或移出文件夹，请使用拖动 或提升和下移按钮。

要删除分组，请选择一个文件夹并单击删除配置。

对配置进行排序

单击此按钮可按字母顺序对配置进行排序。

发布前

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

物品

捷径

描述

添加按钮

AltInsert

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

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

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

  • 启动 Web 浏览器：选择此选项可启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。另外，指定是否希望使用 JavaScript 调试器启动浏览器。

  • 运行文件观察程序：选择此选项可以让 PyC​​harm 应用所有当前活动的文件观察程序。

  • 运行 Grunt 任务：选择此选项可运行 Grunt 任务。

    在打开的Grunt 任务对话框中，指定定义所需任务的Gruntfile.js，选择要执行的任务，并指定要传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、要传递给它的参数以及grunt-cli包的路径。

  • 运行 gulp 任务：选择此选项可运行 Gulp 任务。

    在打开的Gulp 任务对话框中，指定定义所需任务的Gulpfile.js，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、要传递给它的参数以及gulp包的路径。

  • 运行 npm 脚本：选择此选项来执行 npm 脚本。

    在打开的NPM 脚本对话框中，指定npm run/debug 配置设置。

  • 启动 React Native Bundler：选择此选项可自动运行捆绑器，作为运行或调试会话的一部分。默认情况下，这是通过 完成的react-native start。

    如果您的应用程序使用Expo，您需要通过 npm 任务运行开发服务器start。为此，请单击添加，然后在“配置 React Native”对话框中选择npm script并从列表中选择启动。

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

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

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

  • 生成 CoffeeScript 源映射：选择此选项可为您的CoffeeScript源生成源映射。在打开的对话框中，指定 CoffeeScript 源文件的位置。

  • 运行远程外部工具：添加远程 SSH 外部工具。

删除按钮

AltDelete

单击此图标可从列表中删除选定的任务。

编辑

Enter

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

方法向上

方法向下

Alt0↑

Alt0↓

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

显示此页

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

激活工具窗口

默认情况下，此复选框处于选中状态，并且当您启动运行/调试配置时，将打开“运行”或“调试”工具窗口。

否则，如果清除该复选框，工具窗口将被隐藏。但在配置运行时，您可以通过按或自行打开相应的工具窗口。Alt04Alt05

也可以看看

外部链接