运行/调试配置： Python

创建：运行(U) | 编辑配置(E) | | Python

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

使用此对话框为 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\"}"

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

允许多个实例(U)

如果您希望允许同时运行多个该配置的实例，请选择此选项。如果禁用该选项，尝试重新运行该配置将终止活动会话。

环境

项目

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

环境变量

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

默认情况下，此字段包含变量 PYTHONUNBUFFERED ，其值为 1。要填充列表，请点击浏览按钮，或按 Shift+Enter 并在环境变量对话框中指定所需的环境变量集。

要创建新变量，请点击，并键入所需的名称和值。

您可能希望使用存储在文本文件中的一系列记录来填充此列表，例如：

                        Variable1 = Value1
                        Variable2 = Value2

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

".env" 文件的路径

此字段显示包含环境变量的 .env 文件的路径。如果有多个文件，则使用分号分隔这些路径。

若要管理 .env 文件列表，请点击选择 ".env" 文件。在打开的环境文件对话框中，使用添加和移除添加或移除文件。

您还可以使用和更改加载 .env 文件的顺序。

Python 解释器

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

解释器选项

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

工作目录

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

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

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

将内容根添加到 PYTHONPATH

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

将源根添加到 PYTHONPATH

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

执行

使用 'uv run' 运行

启用使用 uv 运行脚本或模块。

对于由 uv 管理的项目，此复选框默认选中。

在输出控制台中模拟终端

启用在输出控制台中以模拟终端模式运行脚本或模块。此模式对于无法通过标准输出控制台实现的任务很有用，例如脚本执行回车操作（print(i, flush=True , end='\r' ）时。

使用 Python 控制台运行

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

从以下位置重定向输入

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

Docker 容器设置

点击以打开对话框并指定以下设置：

选项

发布所有端口：将容器的所有端口暴露给主机。这对应于选项 --publish-all。
端口绑定：指定端口绑定列表。类似于将 -p 选项与 docker run 配合使用。
卷绑定：使用此字段指定特殊文件夹（卷）与运行 Docker 守护进程的计算机上的文件夹之间的绑定。这对应于 -v 选项。有关详细信息，请参阅在容器中管理数据。
环境变量：使用此字段指定环境变量及其值的列表。这对应于 -e 选项。有关详细信息，请参阅 ENV（环境变量）。
运行选项：使用此字段指定 Docker 命令行选项。

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

Docker Compose

命令和选项

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

命令	支持的选项
up ：为某个服务构建、创建、启动并附加到该服务的容器。	`--abort-on-container-exit` `--build` `--exit-code-from SERVICE` `--scale SERVICE=NUM...` `--timeout TIMEOUT`
run ：针对某个服务运行一次性命令。	`--entrypoint CMD` `-l, --label KEY=VAL` `--name NAME` `-p, --publish=[]` `--rm` `--service-ports` `--use-aliases` `-u, --user=""` `-v, --volume=[]`
exec ：在服务中运行任意命令。	`--index=index` `--privileged` `-u, --user USER`

命令预览

使用此字段预览完整的命令字符串。

例如， up --build exec --user jetbrains 组合在命令和选项字段中会在预览中生成以下输出：

                docker compose
                -f C:\PyCharm-2019.2\Demos\djangodocker-master\docker-compose.yml
                <override configuration file>
                up --build exec --user jetbrains
            
     

日志

使用这些设置指定在运行或调试期间生成的哪些日志文件应显示在控制台中，即在运行或调试工具窗口的专用选项卡上。

有关如何启用日志字段的信息，请参阅设置日志选项。

项目	说明
是否启用	选中此列中的复选框，可在运行工具窗口或调试工具窗口的相应选项卡中显示日志条目。
日志文件条目	此列中的只读字段列出要显示的日志文件。列表可以包含：特定文件的完整路径。用于替代完整路径或模式的别名。这些别名也会显示在相应日志文件所在选项卡的标题中。如果日志条目模式定义了多个文件，则选项卡标题会显示文件名，而不是日志条目别名。
跳过内容	选中此复选框可跳过所选日志的先前内容。
将控制台输出保存到文件	选中此复选框可将控制台输出保存到指定位置。手动键入路径，或点击浏览按钮，并在打开的对话框中指向所需位置。
当消息打印到标准输出流时显示控制台	选中此复选框可在关联进程写入 Standard.out 时激活输出控制台并将其置于前端。
当消息打印到标准错误流时显示控制台	选中此复选框可在关联进程写入 Standard.err 时激活输出控制台并将其置于前端。
	点击此按钮以打开编辑日志文件别名对话框，您可以在其中选择新的日志条目并为其指定别名。
	点击此按钮在编辑日志文件别名对话框中编辑所选日志文件条目的属性。
	点击此按钮可从列表中移除所选日志条目。
	点击此按钮以编辑所选日志文件条目。该按钮仅在选择条目时可用。

通用设置

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

项目	说明
名称(N)	为运行配置指定名称，以便在编辑或运行时能够快速识别。
允许多个实例(U)	允许并行运行此运行配置的多个实例。默认情况下，它处于禁用状态，当您在另一个实例仍在运行时启动此配置，PyCharm 会建议停止正在运行的实例并启动另一个。当运行配置占用大量资源且没有充分理由运行多个实例时，这将非常有用。
存储为项目文件(S)	将包含运行配置设置的文件保存下来，以便与团队中的其他成员共享。默认位置为 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将该配置保存到项目内的任何其他目录中。默认情况下，它处于禁用状态，PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

项目

说明

名称(N)

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

允许多个实例(U)

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

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

存储为项目文件(S)

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

默认情况下，它处于禁用状态，PyCharm 会将运行配置设置存储在 .idea/workspace.xml 中。

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

项目	Shortcut	说明
	`Alt+Insert`	创建运行/调试配置。
	`Alt+Delete`	删除所选运行/调试配置。请注意，无法删除默认配置。
	`Ctrl+D`	创建所选运行/调试配置的副本。请注意，您创建的是默认配置的副本。
		仅在选择临时配置时才显示此按钮。点击此按钮将临时配置保存为永久配置。
		移动到新文件夹 / 创建新文件夹。您可以通过将其放入文件夹来对运行/调试配置进行分组。要创建文件夹，请在某个类别中选择配置，点击，并指定文件夹名称。如果仅聚焦于类别，则会创建一个空文件夹。然后，要将配置移动到文件夹中、在文件夹之间移动或移出文件夹，请拖动，或使用和按钮。要移除分组，请选择一个文件夹并点击。
		点击此按钮按字母顺序对配置进行排序。

启动前

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

项目	Shortcut	说明
	`Alt+Insert`	点击此图标以添加以下可用任务之一：启动Web 浏览器：选择此选项以启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。此外，指定是否希望使用 JavaScript 调试器启动浏览器。运行外部工具：选择运行外部应用程序。在打开的对话框中，选择要运行的一个或多个应用程序。如果它尚未在 PyCharm 中定义，请添加其定义。有关详细信息，请参阅外部工具和外部工具。运行另一个配置：选择执行另一个运行/调试配置，并在启动当前配置之前等待其完成。如果要并行运行多个配置，请使用复合运行/调试配置。运行File Watcher ：选择此选项以让 PyCharm 应用所有当前处于活动状态的 File Watchers。运行远程外部工具：添加一个远程 SSH 外部工具。运行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 编译设置对话框中，选中或清除检查错误复选框，以配置在检测到任何错误时编译器的行为：如果选中检查错误复选框，编译器将显示所有错误，并且运行配置不会启动。如果清除检查错误复选框，编译器会显示所有检测到的错误，但仍会启动运行配置。断开数据源：如果希望在运行运行/调试配置之前中断与数据源的连接，请选择此选项。
	`Alt+Delete`	点击此图标可从列表中移除所选任务。
	`Enter`	点击此图标以编辑所选任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标以将所选任务在列表中上移或下移一行。任务将按照它们在列表中的顺序执行。
显示此页面		选中此复选框以在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，此复选框处于选中状态，当您启动运行/调试配置时，将打开运行或调试工具窗口。否则，如果清除该复选框，则会隐藏工具窗口。不过，在配置运行时，您可以按 `Alt+4` 或 `Alt+5` 自行打开其对应的工具窗口。

最后修改日期： 2025年 12月 2日