运行/调试配置对话框

运行 | 编辑配置 | 添加新配置 | Python

当您第一次运行应用程序时,PyCharm 会自动创建临时运行/调试配置。您可以对其进行修改以指定或更改默认参数并将其保存为永久运行/调试配置。

先决条件

在开始之前,请确保已安装 Python 和相关框架。

有关详细信息,请参阅各自的下载和安装页面:

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

配置选项卡

物品

描述

脚本路径/模块名称

单击列表以选择要运行的目标类型。然后,在相应的字段中,指定 Python 脚本的路径或要执行的模块名称。

参数

在此字段中,指定要传递给 Python 脚本的参数。

指定脚本参数时,请遵循以下规则:

  • 使用空格分隔各个脚本参数。

  • 包含空格的脚本参数应使用双引号分隔,例如,some" "param"some param"

  • 如果脚本参数包含双引号,请使用反斜杠转义双引号,例如:

    -s"main.snap_source_dirs=[\"pcomponents/src/main/python\"]" -s"http.cc_port=8189" -s"backdoor.port=9189" -s"main.metadata={\"location\": \"B\", \"language\": \"python\"}"

    .

在此字段中,您可以添加宏以在运行运行/调试配置时传递各种项目或上下文特定的值。单击+并从列表中选择一个可用的宏。有关更多详细信息,请参阅将宏添加到运行/调试配置

环境

项目

单击此列表以选择在同一 PyCharm 窗口中打开的项目之一,应使用此运行/调试配置。如果只有一个打开的项目,则不显示该字段。

环境变量

此字段显示环境变量列表。如果列表包含多个变量,则它们用分号分隔。

默认情况下,该字段包含PYTHONUNBUFFERED设置为 1 的变量。要填写列表,请单击浏览按钮,或在“环境变量”对话框中按Shift+Enter并指定所需的环境变量集。

要创建新变量,请单击添加按钮,然后键入所需的名称和值。

您可能希望使用在文本文件中存储为一系列记录的变量填充列表,例如:

变量 1 = 值 1 变量 2 = 值 2

只需从文本文件中复制变量列表,然后单击环境变量对话框中的粘贴( 粘贴) 。变量将被添加到表中。单击确定以完成任务。您可以随时在“环境变量”对话框中选择所有变量,单击“复制”,然后将它们粘贴到文本文件中。复制

Python 解释器

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

口译员选项

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

工作目录

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

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

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

将内容根添加到 PYTHONPATH

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

将源根目录添加到 PYTHONPATH

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

执行

在输出控制台中模拟终端

允许使用模拟终端模式在输出控制台中运行您的脚本或模块。此模式对于无法使用标准输出控制台实现的任务很有帮助,例如,当您的脚本执行插入符号返回操作 ( print(i, flush=True , end='\r') 时。

请注意,在输出控制台中模拟终端与运行终端不同,终端是用于运行系统 shell 命令的单独工具窗口。

使用 Python 控制台运行

允许使用 Python 控制台运行脚本或模块。

重定向输入

允许将数据从文本文件重定向到标准输入。如果您的脚本需要一些输入并且您希望自动提交值而不是在运行控制台中键入它们,请使用此选项。要启用重定向,请选中复选框并指定目标文本文件的路径。

Docker 容器设置

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

选项

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

  • 端口绑定:指定端口绑定列表。类似于使用-p带有 的选项docker run

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

  • 环境变量:使用此字段指定环境变量列表及其值。这对应于-e选项。有关详细信息,请参阅页面ENV(环境变量)

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

单击图标动作向下移动以展开表格。单击图标一般添加图标一般删除图标动作编辑组成列表。

Docker撰写

命令和选项

您可以使用 Docker Compose 命令行界面的以下命令:

命令

支持的选项

up — 为服务构建、创建、启动和附加到容器。

--build, --abort-on-container-exit, --timeout TIMEOUT, --exit-code-from SERVICE, --scale SERVICE=NUM...,SERVICE...

run — 针对服务运行一次性命令。请参阅参考文档。

--name NAME, --entrypoint CMD, -l, --label KEY=VAL, -u, --user="", --rm, -p, --publish=[], --service-ports, --use-aliases, -v, --volume=[].

exec — 在您的服务中运行任意命令。

--privileged, -u, --user USER, --index=index.

命令预览

您可以展开此字段以预览完整的命令字符串。

示例:如果您在命令和选项字段中输入以下组合:

up --build exec --user jetbrains

预览输出应如下所示:

docker-compose -f C:\PyCharm-2019.2\Demos\djangodocker-master\docker-compose.yml -f <覆盖配置文件> up --build exec --user jetbrains

日志选项卡

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

物品

描述

活跃

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

日志文件条目

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

  • 特定文件的完整路径。

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

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

跳过内容

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

将控制台输出保存到文件

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

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

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

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

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

添加按钮

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

编辑按钮

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

删除按钮

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

浏览按钮

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

常用设置

当您编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:

姓名

为运行/调试配置指定一个名称,以便在编辑或运行配置时快速识别它,例如,从运行弹出窗口Alt+Shift+F10中。

允许并行运行

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

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

存储为项目文件

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

默认情况下,它被禁用,并且 PyCharm 将运行配置设置存储在.idea/workspace.xml中。

工具栏

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

物品

捷径

描述

添加按钮

Alt+Insert

创建运行/调试配置。

删除按钮

Alt+Delete

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

复制

Ctrl+D

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

保存配置

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

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

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

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

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

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

排序配置

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

发射前

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

物品

捷径

描述

添加按钮

Alt+Insert

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

  • 运行外部工具:选择运行外部应用程序。在打开的对话框中,选择一个或多个要运行的应用程序。如果尚未在 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 运行/调试配置设置

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

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

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

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

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

删除按钮

Alt+Delete

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

编辑

Enter

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

方法向上/方法向下

Alt+Up/Alt+Down

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

显示此页面

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

激活工具窗口

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

否则,如果清除该复选框,则隐藏工具窗口。但是,在配置运行时,您可以通过按Alt+4或自行为其打开相应的工具窗口Alt+5

最后修改:2022 年 1 月 14 日