PyCharm 2026.1 Help

运行/调试配置：附加到 Node.js/Chrome

创建： 运行(U)｜ 编辑配置(E)｜ 添加新配置| 附加到 Node.js/Chrome

在此对话框中，创建用于调试已在运行的 Node.js 应用的配置。 通过这种方式，您可以在不重新启动 Node.js 服务器的情况下重新启动调试会话。

您还可以使用此配置调试 NW.js 应用的后台和其他 main 进程，请参阅 运行/调试配置：NW.js。

使用此配置，您还可以 调试 Chrome 扩展程序。

在开始之前

  1. 下载并安装 Node.js。

  2. 在 设置 | 插件 页面上的 插件市场 选项卡中安装 Node.js 插件，具体请参见 从 JetBrains Marketplace 安装插件。

附加到 Node.js/Chrome 的特定配置设置

项目

描述

主持人

在此字段中，指定应用运行所在的主机。

端口

在此字段中，指定在启动 Node.js 进程时传递给 --inspect、 --inspect-brk 或 --debug 的要连接的端口。 在内置的 终端 或控制正在运行的应用的 运行 工具窗口中，从 调试器正在监听... 信息消息复制此端口号。

从运行工具窗口或终端开始调试：信息消息

自动重新连接

选中此复选框，以便 PyCharm 内置调试器在应用代码更改后重新附加到正在运行的 Node.js 进程。 这使您能够调试使用 nodemon 实用程序 的 Node.js 应用程序，该实用程序会在代码更新时自动重新加载您的 Node.js 进程。 详细信息请参阅 调试使用 nodemon 的应用。

本地文件的远程 URL

在此区域中，为项目文件夹指定远程路径。 如果正在运行的应用的根文件夹与您的 PyCharm 项目根文件夹的名称不同，这将很有帮助。 在下面的示例中，PyCharm 项目根文件夹 /Users/WsProjects/express 映射到服务器上的 /usr/src/app 。

指定本地文件的远程 URL

通用设置

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

项目

描述

名称(N)

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

存储为项目文件(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 run/debug configuration settings。

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

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

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

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

“移除”按钮

Alt+Delete

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

编辑

Enter

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

上移方法

下移方法

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

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

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

聚焦工具窗口

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

2026年 3月 24日
配置 Node.js 远程运行时对话框运行/调试配置： NodeUnit