运行/调试配置：Python DAP

使用 Python DAP 配置来启动调试服务器。

项目	描述
脚本路径	指定要执行的 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 解释器	从列表中选择一个解释器。
工作目录	在此字段中，指定应用程序的工作目录。默认情况下，此字段显示 PyCharm 项目根目录的路径。

常规设置

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

项目	描述
名称(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 中定义，请添加其定义。有关详细信息，请参阅外部工具和外部工具。运行另一个配置：选择执行另一个运行/调试配置，并在其完成后再启动当前配置。如果您想并行运行多个配置，请使用复合运行/调试配置。运行File Watcher ：选择此选项以让 PyCharm 应用当前所有处于活动状态的文件监视器。运行远程外部工具：添加一个远程 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日