PyCharm 使用运行/调试配置来运行、调试和测试您的代码。每个配置都是一组命名的启动属性,它们定义要执行的内容以及应该使用的参数和环境。
使用不同的启动属性,您可以定义 PyCharm 用来执行脚本的不同方式。例如,您可以使用不同的 Python 解释器执行相同的代码,提供各种环境变量集,并从替代文件中获取输入值。
有两种类型的运行/调试配置:
临时的——每次运行或调试函数或测试时创建。
永久- 从模板显式创建或通过保存临时配置创建。永久配置保留为项目的一部分,直到您将其删除。
因此,每当您运行/调试或测试代码时,PyCharm 要么使用现有的永久运行/调试配置,要么创建一个新的临时配置。
永久配置的图标是不透明的,而临时配置的图标是半透明的。
临时配置的最大数量为5个。添加新配置时,旧配置会自动删除。如有必要,您可以在
。PyCharm 提供以下方法来创建永久运行/调试配置:
从模板创建或复制现有配置。
在运行/调试配置切换器中选择一个临时配置,然后单击保存配置。
保存临时配置后,它将成为永久配置,并记录在<project directory>/.idea/目录中的单独 XML 文件中。例如,MyProject/.idea/Car.xml。
或者,在运行/调试配置对话框中选择一个临时配置,然后单击工具栏上的 。
PyCharm为不同的语言、工具和框架提供运行/调试配置模板。可用模板列表因已安装和启用的插件而异。
从主菜单中,选择
。或者,按Alt+Shift+F10,然后按0。在“运行/调试配置”对话框中,单击工具栏上的 或按Alt+Insert。该列表显示运行/调试配置模板。
选择所需的模板。如果您不确定要选择哪个模板,请参阅运行/调试配置对话框以获取有关特定模板的更多信息。
在名称字段中指定运行/调试配置名称。此名称将显示在可用的运行/调试配置列表中。
如果您希望允许配置的多个实例同时运行,请选择允许并行运行。如果禁用此选项,尝试重新运行配置将终止活动会话。
设置运行/调试配置参数。
在启动前部分中,定义是否要在启动应用程序之前执行任何特定操作,例如,在启动运行/调试配置之前执行一些工具或脚本。
有关特定发布前活动的信息,请参阅发布前
应用更改并关闭对话框。
如果您在团队中工作,您可能希望共享您的运行/调试配置,以便您的队友可以使用相同的配置运行应用程序,或者使他们能够远程附加到您正在运行的进程。
出于这些目的,PyCharm 提供了一种将运行/调试配置存储为项目文件并通过 VCS 共享它们的机制。当您想将配置作为文件发送给其他人时,也可以使用相同的机制。这可以节省大量时间,因为运行/调试配置有时会变得复杂,并且手动保持它们同步会很乏味且容易出错。
从主菜单中,选择
。或者,按Alt+Shift+F10,然后按0。选择您要共享的运行/调试配置,启用“存储为项目文件”选项,并指定将存储配置文件的位置。
如果需要与 PyCharm 2019.3 及更早版本兼容,请将文件存储在默认位置。
(可选)如果将.idea目录添加到 VCS 忽略的文件中,则.idea/runConfigurations子文件夹也将被忽略。如果您在项目中使用 Git,则可以仅共享.idea/runConfigurations并通过修改.gitignore将.idea忽略,如下所示:
所有运行/调试配置都基于模板,这些模板实现了启动逻辑,定义了参数列表及其默认值。可用模板列表在安装中预定义,只能通过插件扩展。但是,您可以编辑每个模板中的默认参数值,以简化新运行/调试配置的设置。
从主菜单中,选择
。或者,按Alt+Shift+F10,然后按0。在运行/调试配置对话框的左侧窗格中,单击编辑配置模板。
在打开的“运行/调试配置模板”对话框中,选择一种配置类型。
指定所需的默认参数,然后单击“确定”保存模板。
假设您想同时启动多个运行/调试配置。例如,您可能想要运行多个不同类型的配置或一组测试配置。您可以使用复合运行/调试配置来配置此行为。
从主菜单中,选择
。或者,按Alt+Shift+F10,然后按0。在Run/Debug Configurations对话框中,单击或按Alt+Insert,然后选择Compound。
在名称字段中指定运行/调试配置名称。此名称将显示在可用的运行/调试配置列表中。
选择存储为项目文件以使此运行/调试配置可供其他团队成员使用。
要将新的运行/调试配置包含到复合配置中,请单击添加并从列表中选择所需的配置。
应用更改。
当有许多相同类型的运行/调试配置时,您可以将它们分组到文件夹中,以便它们在视觉上更容易区分。
分组后,运行/调试配置将出现在相应文件夹下的列表中。
从主菜单中,选择
。或者,按Alt+Shift+F10,然后按0。在“运行/调试配置”对话框中,选择一种配置类型并单击工具栏上的 。将为所选类型创建一个新的空文件夹。
在右侧的文本字段中指定文件夹名称或接受默认名称。
选择所需的运行/调试配置并将它们移动到目标文件夹下。
应用更改。如果文件夹为空,则不会保存。
当您不再需要某个文件夹时,可以将其删除Delete。分组在此文件夹下的运行/调试配置将移动到相应运行/调试配置类型的根目录下。
您可以在服务工具窗口中管理多个运行/调试配置。例如,您可以启动、暂停和停止多个应用程序,跟踪它们的状态,并检查特定于应用程序的详细信息。
选择
主菜单中的 Alt+8或按。在Services工具窗口中,单击Add service,然后选择Run Configuration Type。
从列表中选择一种运行/调试配置类型,以将这种类型的所有配置添加到窗口中。
请注意,工具窗口将仅显示您为其创建了一个或多个配置的配置类型。
物品 | 描述 | ||||||||
---|---|---|---|---|---|---|---|---|---|
脚本路径/模块名称 | 单击列表以选择要运行的目标类型。然后,在相应的字段中,指定 Python 脚本的路径或要执行的模块名称。 | ||||||||
参数 | 在此字段中,指定要传递给 Python 脚本的参数。 指定脚本参数时,请遵循以下规则:
在此字段中,您可以添加宏以在运行运行/调试配置时传递各种项目或上下文特定的值。单击+并从列表中选择一个可用的宏。有关更多详细信息,请参阅将宏添加到运行/调试配置。 | ||||||||
环境 | |||||||||
项目 | 单击此列表以选择在同一 PyCharm 窗口中打开的项目之一,应使用此运行/调试配置。如果只有一个打开的项目,则不显示该字段。 | ||||||||
环境变量 | 此字段显示环境变量列表。如果列表包含多个变量,则它们用分号分隔。 默认情况下,该字段包含 要创建新变量,请单击 您可能希望使用在文本文件中存储为一系列记录的变量填充列表,例如:
变量 1 = 值 1 变量 2 = 值 2
只需从文本文件中复制变量列表,然后单击环境变量对话框中的粘贴( | ||||||||
Python 解释器 | 从列表中选择一个预配置的Python 解释器。 | ||||||||
口译员选项 | 在此字段中,指定要传递给解释器的命令行选项。如有必要,单击 | ||||||||
工作目录 | 指定正在运行的任务要使用的目录。
| ||||||||
将内容根添加到 PYTHONPATH | 选中此复选框可将项目的所有内容根添加到环境变量 PYTHONPATH; | ||||||||
将源根目录添加到 PYTHONPATH | 选中此复选框可将项目的所有源根添加到环境变量 PYTHONPATH; | ||||||||
执行 | |||||||||
在输出控制台中模拟终端 | 允许使用模拟终端模式在输出控制台中运行您的脚本或模块。此模式对于无法使用标准输出控制台实现的任务很有帮助,例如,当您的脚本执行插入符号返回操作 ( 请注意,在输出控制台中模拟终端与运行终端不同,终端是用于运行系统 shell 命令的单独工具窗口。 | ||||||||
使用 Python 控制台运行 | 允许使用 Python 控制台运行脚本或模块。 | ||||||||
重定向输入 | 允许将数据从文本文件重定向到标准输入。如果您的脚本需要一些输入并且您希望自动提交值而不是在运行控制台中键入它们,请使用此选项。要启用重定向,请选中复选框并指定目标文本文件的路径。 | ||||||||
Docker 容器设置 单击 | |||||||||
选项 |
单击 | ||||||||
Docker撰写 | |||||||||
命令和选项 | 您可以使用 Docker Compose 命令行界面的以下命令:
| ||||||||
命令预览 | 您可以展开此字段以预览完整的命令字符串。 示例:如果您在命令和选项字段中输入以下组合:
预览输出应如下所示:
docker-compose -f C:\PyCharm-2019.2\Demos\djangodocker-master\docker-compose.yml -f <覆盖配置文件> up --build exec --user jetbrains
|