运行/调试配置：uv run

要打开此对话框，请从主菜单中选择运行 | 编辑配置，然后单击添加新配置，并选择 uv run 模板。

配置选项卡

项目	描述
脚本路径/模块名称	点击列表以选择要运行的目标类型。然后，在相应字段中指定要执行的 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\"}" 在此字段中，您可以添加宏以在运行运行/调试配置时传递各种项目或上下文相关的值。点击 + 并从列表中选择一个可用的宏。有关详细信息，请参阅将宏添加到运行/调试配置。
环境变量	此字段显示环境变量列表。如果列表包含多个变量，它们使用分号分隔。默认情况下，该字段包含变量 `PYTHONUNBUFFERED` ，其值为 1。要填写列表，请单击浏览按钮或按 `Shift+Enter` ，并在环境变量对话框中指定所需的环境变量集。要创建新变量，请单击，然后输入所需的名称和值。您可能希望用存储为文本文件中一系列记录的变量来填充列表，例如： Variable1 = Value1 Variable2 = Value2 从文本文件中复制变量列表，然后在环境变量对话框中单击粘贴（）。这些变量将被添加到表格中。点击确定完成任务。您可以随时在环境变量对话框中选择所有变量，点击复制，然后将它们粘贴到文本文件中。
运行前警告包同步	如果不希望在运行脚本前收到有关包依赖项同步的警告，请清除此复选框。
Python 解释器	从列表中选择一个 uv 解释器。
uv 参数	在此字段中指定要传递给 `uv` 的参数。如有必要，点击，并在编辑器中输入字符串。

日志

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

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

项目	描述
是否激活	在此列中选择复选框，以便在运行工具窗口或调试工具窗口的相应选项卡中显示日志条目。
日志文件条目	此列中的只读字段列出了要显示的日志文件。列表可以包含：特定文件的完整路径。用于替代完整路径或模式的别名。这些别名还显示在选项卡的标题中，以展示相应的日志文件。如果日志条目模式定义了多个文件，则选项卡标题会显示文件名而不是日志条目别名。
跳过内容	选中此复选框以跳过所选日志的先前内容。
将控制台输出保存到文件	选中此复选框可将控制台输出保存到指定位置。请手动输入路径，或点击浏览按钮并指向打开的对话框中的目标位置。
当消息打印到标准输出流时显示控制台	选中此复选框以激活输出控制台，并在关联进程写入 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 。

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

项目	快捷方式	描述
	`Alt+Insert`	创建运行/调试配置。
	`Alt+Delete`	删除选定的运行/调试配置。请注意，您无法删除默认配置。
	`Ctrl+D`	创建选定运行/调试配置的副本。请注意，您正在创建默认配置的副本。
		仅当您选择一个临时配置时才会显示该按钮。点击此按钮以将临时配置保存为永久配置。
		移入新建文件夹／新建文件夹。您可以通过将它们放入文件夹来对运行/调试配置进行分组。要创建文件夹，请选择某个类别中的配置，点击，并指定文件夹名称。如果只有一个类别处于焦点状态，则会创建一个空文件夹。然后，为了将配置移动到文件夹中、文件夹之间或者文件夹外，请使用拖拽或和按钮。要删除分组，请选择一个文件夹，然后点击。
		点击此按钮以按字母顺序排序配置。

启动前

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

项目	快捷方式	描述
	`Alt+Insert`	点击此图标以添加以下可用任务之一：启动Web 浏览器：选择此选项即可启动浏览器。在打开的对话框中，选择浏览器的类型并提供起始 URL。还需指定是否希望使用 JavaScript 调试器启动浏览器。运行外部工具：选择运行外部应用程序。在打开的对话框中，选择您要运行的一个或多个应用程序。如果在 PyCharm 中尚未定义，请添加其定义。如需更多信息，请参阅外部工具和外部工具。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。如果您想并行运行多个配置，请使用 compound run/debug configuration。运行File Watcher ：选择此选项以让 PyCharm 应用所有当前活动的文件监视器。运行远程外部工具：添加一个 remote SSH external tool。运行Grunt 任务：选择此选项来运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、要传递给它的参数，以及 grunt-cli 包的路径。运行gulp 任务：选择此选项以运行 Gulp task。在打开的 Gulp 任务对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。指定 Node.js 解释器的位置、传递给解释器的参数以及到 gulp 包的路径。运行npm 脚本：选择此选项来执行 npm 脚本。在 NPM Script 对话框中，指定 npm run/debug configuration settings。编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选择或清除此检查错误复选框，以配置编译器在检测到错误时的行为: 如果选中了检查错误复选框，编译器会显示所有错误，并且运行配置将不会启动。如果清除了检查错误复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。断开数据源：如果您希望在运行/调试配置运行之前中断与数据源的连接，请选择此选项。
	`Alt+Delete`	点击此图标可将所选任务从列表中移除。
	`Enter`	点击此图标可编辑选定的任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标以在列表中将所选任务上移或下移一行。任务将按照它们在列表中出现的顺序执行。
显示此页面		选中此复选框以在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。否则，如果复选框未选中，工具窗口将被隐藏。但是，在配置运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。

最后修改日期： 2025年 9月 26日