PyCharm 2026.1 Help

运行/调试配置对话框

使用此对话框创建、编辑、调整或移除 运行/调试配置 ，并配置默认模板，这些模板将应用于所有新建的运行/调试配置。

现有运行/调试配置按配置类型分组。 用于创建新配置的模板是 可编辑 的，可通过对话框左侧窗格中的 编辑配置模板… 链接访问。

通用设置

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

项目

描述

名称(N)

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

允许多个实例(U)

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

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

存储为项目文件(S)

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

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

启动前

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

项目

快捷方式

描述

添加按钮

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 run/debug configuration settings。

  • 编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除 检查错误 复选框，以在检测到任何错误时配置编译器的行为：

    • 如果选中 检查错误 复选框，编译器将显示所有错误，并且运行配置将不会启动。

    • 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。

  • 断开数据源 ：如果您希望在运行/调试配置之前断开与数据源的连接，请选择此选项。

“移除”按钮

Alt+Delete

点击该图标可从列表中移除所选任务。

编辑

Enter

点击该图标可编辑所选任务。 在打开的对话框中，进行必要的更改。

上移方法

下移方法

Alt+Up

Alt+Down

点击这些图标以将所选任务在列表中上移一行或下移一行。 任务按照其在列表中的顺序执行。

显示此页面

选中此复选框，以在实际启动运行/调试配置之前显示其设置。

激活工具窗口

默认情况下，该复选框处于选中状态，并且当您启动运行/调试配置时，会打开 运行 或 调试 工具窗口。

否则，如果清除此复选框，将隐藏工具窗口。 但是，当配置正在运行时，您可以按 Alt+4 或 Alt+5 自行为其打开相应的工具窗口。

聚焦工具窗口

选中此复选框可在启动运行/调试配置时，自动将焦点移动到 运行 或 调试 工具窗口。

日志

以下选项与记录此配置的执行相关。 有关更多信息，请参见 设置日志选项。

项目

描述

指定要在控制台中显示的日志

指定在运行应用程序时显示哪些日志文件。

点击 添加按钮 添加新日志。 在 编辑日志文件别名 对话框中，配置以下内容：

  • 别名(A) ：日志将显示的选项卡名称。

  • 日志文件位置(L) ：指定日志文件的路径或 Ant 模式。 如果多个滚动日志文件匹配该模式，PyCharm 将显示最新的一个。

  • 显示可由模式覆盖的所有文件(S) ：显示所有匹配该模式的日志。

对于表格中的日志，您可以配置以下选项：

  • 处于活动状态 ：显示指定的日志文件。

  • 跳过内容 ：不显示先前运行的旧日志消息。

将控制台输出保存到文件(S)

将控制台输出保存到指定位置。 手动输入路径，或点击浏览按钮，然后在 打开的对话框 中指向所需位置。

在消息打印到stdout 时显示控制台

当应用程序写入标准输出流时激活控制台。

在消息打印到stderr 时显示控制台

当应用程序写入标准错误流时激活控制台。

2026年 3月 24日
结构搜索与替换对话框编辑日志文件别名对话框