运行/调试配置:Python
最后修改时间:2023 年 10 月 16 日创建:运行| 编辑配置| | Python
当您第一次运行应用程序时,PyCharm 会自动创建临时运行/调试配置。您可以修改它以指定或更改默认参数并将其保存为永久运行/调试配置。
使用此对话框可以为Python 脚本创建运行/调试配置。
配置选项卡
物品 | 描述 | ||||||||
---|---|---|---|---|---|---|---|---|---|
脚本路径/模块名称 | 单击列表可选择要运行的目标类型。然后,在相应的字段中指定Python脚本的路径或要执行的模块名称。 您可以在此字段中使用路径变量。 | ||||||||
参数 | 在此字段中,指定要传递给 Python 脚本的参数。 指定脚本参数时,请遵循以下规则:
在此字段中,您可以添加宏以在运行运行/调试配置时传递各种项目或上下文特定的值。单击+并从列表中选择可用的宏之一。有关更多详细信息,请参阅添加宏以运行/调试配置。 | ||||||||
允许多个实例 | 如果您希望允许配置的多个实例同时运行,请选择此选项。如果禁用此选项,尝试重新运行配置将终止活动会话。 | ||||||||
环境 | |||||||||
项目 | 单击此列表以选择在同一 PyCharm 窗口中打开的项目之一,应在其中使用此运行/调试配置。如果只有一个打开的项目,则不显示此字段。 | ||||||||
环境变量 | 该字段显示环境变量列表。如果列表包含多个变量,则它们用分号分隔。 默认情况下,该字段包含设置为 1 的变量。 要创建新变量,请单击,然后键入所需的名称和值。 您可能希望使用作为一系列记录存储在文本文件中的变量来填充列表,例如:
只需从文本文件中复制变量列表,然后单击“环境变量”对话框中的“粘贴” ( ) 。变量将添加到表中。单击“确定”完成任务。您可以随时选择“环境变量”对话框中的所有变量,单击“复制”,然后将它们粘贴到文本文件中。 | ||||||||
“.env”文件的路径 | 此字段显示带有环境变量的.env文件的路径。如果有多个文件,则它们的路径用分号分隔。 要管理.env文件列表,请单击 选择“.env”文件。在打开的“环境文件”对话框中,使用 “添加”和 “删除”来添加和删除文件。 您还可以使用和更改.env文件的加载顺序。 | ||||||||
Python解释器 | 从列表中选择预配置的Python 解释器之一。
| ||||||||
口译员选项 | 在此字段中,指定要传递给解释器的命令行选项。如有必要,单击,然后在编辑器中键入字符串。 | ||||||||
工作目录 | 指定运行任务要使用的目录。
您可以在此字段中使用路径变量。 | ||||||||
将内容根添加到 PYTHONPATH | 选中此复选框可将项目的所有内容根添加到环境变量 PYTHONPATH 中; | ||||||||
将源根添加到 PYTHONPATH | 选中此复选框可将项目的所有源根目录添加到环境变量 PYTHONPATH 中; | ||||||||
执行 | |||||||||
在输出控制台中模拟终端 | 允许使用模拟终端模式在输出控制台中运行脚本或模块。此模式对于无法使用标准输出控制台实现的任务很有帮助,例如,当您的脚本执行插入符号返回操作 ( 请注意,在输出控制台中模拟终端与运行终端不同,后者是用于运行系统 shell 命令的单独工具窗口。 | ||||||||
使用 Python 控制台运行 | 允许使用 Python 控制台运行脚本或模块。 | ||||||||
重定向输入来自 | 允许将数据从文本文件重定向到标准输入。如果您的脚本需要一些输入并且您希望自动提交这些值而不是在“运行”控制台中键入这些值,请使用此选项。要启用重定向,请选中该复选框并指定目标文本文件的路径。 | ||||||||
Docker 容器设置
单击以打开对话框并指定以下设置: | |||||||||
选项 |
单击以展开表格。单击、、 或来组成列表。 | ||||||||
Docker 组合
| |||||||||
命令和选项 | 您可以使用 Docker Compose 命令行界面的以下命令:
| ||||||||
命令预览 | 使用此字段可以预览完整的命令字符串。 例如,命令和选项
|
日志选项卡
使用此选项卡可以指定在运行或调试时生成的哪些日志文件应显示在控制台中,即显示在“运行”或“调试”工具窗口的专用选项卡上。
物品 | 描述 |
---|---|
活跃 | |
日志文件条目 | 此列中的只读字段列出了要显示的日志文件。该列表可以包含:
|
跳过内容 | 选中此复选框可跳过所选日志的先前内容。 |
将控制台输出保存到文件 | 选中此复选框可将控制台输出保存到指定位置。手动键入路径,或单击浏览按钮并指向打开的对话框中的所需位置。 |
当消息打印到标准输出流时显示控制台 | 选中此复选框可激活输出控制台,并在关联进程写入 Standard.out 时将其向前显示。 |
当消息打印到标准错误流时显示控制台 | 选中此复选框可激活输出控制台,并在关联进程写入 Standard.err 时将其向前显示。 |
单击此按钮可打开“编辑日志文件别名”对话框,您可以在其中选择新的日志条目并为其指定别名。 | |
单击此按钮可在“编辑日志文件别名”对话框中编辑所选日志文件条目的属性。 | |
单击此按钮可从列表中删除选定的日志条目。 | |
单击此按钮可编辑所选日志文件条目。仅当选择条目时该按钮才可用。 |
常用设置
当您编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:
物品 | 描述 |
---|---|
姓名 | 指定运行配置的名称,以便在编辑或运行时快速识别它。 |
允许多个实例 | 允许并行运行此运行配置的多个实例。 默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置时,PyCharm 建议停止正在运行的实例并启动另一个实例。当运行配置消耗大量资源并且没有充分理由运行多个实例时,这非常有用。 |
存储为项目文件 | 保存带有运行配置设置的文件,以便与其他团队成员共享。默认位置是.idea/runConfigurations。但是,如果您不想共享.idea目录,则可以将配置保存到项目内的任何其他目录。 默认情况下,它是禁用的,PyCharm 将运行配置设置存储在.idea/workspace.xml中。 |
工具栏
运行/调试配置的树视图有一个工具栏,可帮助您管理项目中可用的配置以及调整默认配置模板。
物品 | 捷径 | 描述 |
---|---|---|
AltInsert | 创建运行/调试配置。 | |
AltDelete | 删除选定的运行/调试配置。请注意,您无法删除默认配置。 | |
Ctrl0D | 创建所选运行/调试配置的副本。请注意,您创建默认配置的副本。 | |
仅当您选择临时配置时才会显示该按钮。单击此按钮可将临时配置保存为永久配置。 | ||
移入新文件夹/创建新文件夹。您可以通过将运行/调试配置放入文件夹中来对它们进行分组。 要创建文件夹,请选择类别中的配置,单击,然后指定文件夹名称。如果仅关注某个类别,则会创建一个空文件夹。 然后,要将配置移入文件夹、文件夹之间或移出文件夹,请使用拖动 或和按钮。 要删除分组,请选择一个文件夹并单击。 | ||
单击此按钮可按字母顺序对配置进行排序。 |
发布前
在此区域中,您可以指定在启动所选运行/调试配置之前要执行的任务。任务按照它们在列表中出现的顺序执行。
物品 | 捷径 | 描述 |
---|---|---|
AltInsert | 单击此图标可添加以下可用任务之一:
| |
AltDelete | 单击此图标可从列表中删除选定的任务。 | |
Enter | 单击此图标可编辑选定的任务。在打开的对话框中进行必要的更改。 | |
Alt0↑ Alt0↓ | 单击这些图标可将所选任务在列表中上移或下移一行。任务按照它们在列表中出现的顺序执行。 | |
显示此页 | 选择此复选框可在实际启动运行/调试配置之前显示运行/调试配置设置。 | |
激活工具窗口 | 默认情况下,此复选框处于选中状态,并且当您启动运行/调试配置时,将打开“运行”或“调试”工具窗口。 否则,如果清除该复选框,工具窗口将被隐藏。但在配置运行时,您可以通过按或自行打开相应的工具窗口。Alt04Alt05 |
感谢您的反馈意见!