PyCharm 2026.2 Help

运行/调试配置: Node.js

创建: 运行 | 编辑配置 | 添加新配置| Node.js

在 PyCharm 2023.3 及更高版本中,支持以下 Node.js 版本:

  • Node.js 22 — Active LTS 版本

  • Node.js 24 — 当前版本

在 支持的 Node.js 版本 了解更多信息。

在此对话框中,创建用于在您的计算机上与 Node.js 应用一同启动调试器的配置。

在开始之前

  1. 下载并安装 Node.js。

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

配置选项卡

项目

描述

Node 运行时

在该字段中,指定要使用的 Node.js 运行时。 这可以是 本地 或 远程 Node.js 运行时,或 Windows Subsystem for Linux 上的 Node.js。 从列表中选择一个运行时,或点击 "浏览" 按钮 并在打开的对话框中配置新的运行时。

Node.js 参数

在此字段中,输入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 最常见的选项包括:

  • 使用 --require coffeescript/register 可在运行期间即时将 CoffeeScript 文件编译为 JavaScript。

    此模式要求 register.js 文件(其属于 coffeescript 包的一部分)位于您的项目中。 因此,请确保按照 安装 CoffeeScript 编译器 中的说明在本地安装 coffeescript 包。

  • 使用 --inspect 或 --inspect-brk 参数以支持 Chrome 调试协议。

有关完整列表,请参阅 Node.js 命令行选项。

工作目录

在此字段中,指定应用的 工作目录。 默认情况下,此字段显示 项目根文件夹。

JavaScript 文件

在此字段中,指定启动应用的主文件路径(例如, bin/www (适用于 Express 应用))。

如果要调试 CoffeeScript,请指定带有源映射的生成 JavaScript 文件的路径。 该文件可以通过外部生成,或通过使用 File Watchers 编译生成。 有关更多信息,请参阅 调试 CoffeeScript。

应用参数

在此字段中,输入通过 process.argv 数组在启动时传递给应用的 Node.js 特定参数。

环境变量

在此字段中,为 Node.js 可执行文件指定自定义 环境变量。

变量定义会显示在 环境变量 字段中,并以分号(; )作为分隔符,例如:

  • NODE_PATH

    用于在解析模块时搜索的其他目录列表。 在列表中分隔目录时,macOS 或 Linux 上使用冒号(: ),Windows 上使用分号(;)。

  • NODE_MODULE_CONTEXTS

    设置为 1 以在各自的全局上下文中加载模块。

  • NODE_DISABLE_COLORS

    设置为 1 以在 REPL 中禁用颜色。

环境变量

或者,点击字段右侧的 浏览 编辑环境变量的图标 ,并在打开的 环境变量 对话框中配置变量列表:

  • 使用 、 、 和 按钮管理自定义变量列表。

  • 该对话框还会显示可用的系统环境变量列表。 如果不想为当前配置使用系统环境变量,请取消选中 包含系统环境变量 复选框。

  • 准备就绪后,点击 确定。

Docker 容器设置

此只读字段显示端口和卷绑定。 点击 展开按钮 以打开命令预览。

在 Docker 中使用 Node.js:运行/调试配置,Docker 容器设置

Docker Compose

在此区域中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置,或点击 展开按钮 并指定自定义设置,例如自定义 Docker Compose 标志,如 --rm 或 --service-ports。 详细了解请参阅 Docker 官方网站。

检查 命令预览。

浏览器 / Live Edit 选项卡

在此选项卡中,配置浏览器的行为,并启用对应用程序客户端代码的调试。 此功能通过 JavaScript 调试 运行配置提供。因此,从技术上讲,PyCharm 会为服务器端和客户端代码分别创建运行配置,但您在一个专用的 Node.js 运行配置中指定所有设置。

项目

描述

打开浏览器

在该区域的字段中,指定一个项目 HTML 文件,以根据项目根目录生成指向该文件的正确 URL,并在内置 Web 服务器上启动。 例如,如果您选择 project_root/inner_folder/index.html ,生成的 URL 将为 http://localhost:63342/project_root/inner_folder/index.html 。 如果选中 启动后 复选框,应用程序启动后浏览器将自动打开此页面。 或者,您也可以在所选浏览器中手动打开该 URL 地址的页面,以查看相同结果。

启动后

选中此复选框以自动打开浏览器。 在列表中,选择要使用的浏览器:

  • 要使用系统默认浏览器,请选择 默认。

  • 要使用自定义浏览器,请从列表中选择它。 请注意,仅在 Google Chrome 和其他 基于 Chromium 的浏览器 中支持调试 JavaScript 客户端代码。

  • 要配置浏览器,请点击 "浏览" 按钮 ,并在打开的 Web 浏览器和预览 对话框中调整设置。 有关更多信息,请参阅 配置浏览器。

使用 JavaScript 调试器

选中此复选框以在所选浏览器中启用对客户端代码的调试。

V8 分析选项卡

在此选项卡中,启用 V8 CPU 和内存分析。

项目

描述

记录 CPU 分析信息

选中此复选框可在应用启动时开始记录 CPU 分析数据。 下方区域中的控件将变为可用。 指定以下内容:

  • 日志文件夹: 在此字段中,指定用于存储记录日志的文件夹。 分析数据存储在日志文件 isolate-<session number> 中。

  • 为所有隔离体(V8 实例)使用单个日志文件: 选中此复选框以为所有 V8 实例仅创建一个日志文件(以及相应的一份分析结果视图)。 清除此复选框可为每个实例创建单独的文件。 Node.js 可以创建额外的 V8 实例,例如用于调试进程。

允许获取堆快照

如果要运行内存分析,请选中此复选框。

日志选项卡

在此选项卡中,启用在 运行 工具窗口的 控制台 选项卡中显示由 morgan 等日志工具生成的信息。 有关详细信息,请参阅 运行 Node.js 应用时管理日志。

通用设置

当您编辑运行配置(而不是运行配置模板)时,可以指定以下选项:

项目

描述

名称

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

允许多个实例。

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

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

存储为项目文件

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

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

工具栏

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

项目

快捷方式

描述

添加按钮

Alt+Insert

创建运行/调试配置。

“移除”按钮

Alt+Delete

删除选定的运行/调试配置。 请注意,您无法删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。 请注意,您将创建默认配置的副本。

保存配置

仅当您选择了 临时配置时,才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。

移入新文件夹/创建新文件夹

移入新文件夹/创建新文件夹。 您可以通过 将其放入文件夹对运行/调试配置进行分组。

要创建文件夹,请在某个分类中选择配置,点击 文件夹 ,并指定文件夹名称。 如果仅选中了某个类别,则会创建一个空文件夹。

随后,要将某个配置移入文件夹、在文件夹之间移动或移出文件夹,请使用拖动操作,或使用 上移 和 下移 按钮。

要取消分组,请选择一个文件夹并点击 删除配置。

对配置排序

点击此按钮按字母顺序排序配置。

启动前

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

项目

快捷方式

描述

添加按钮

Alt+Insert

点击该图标以添加以下可用任务之一:

  • 启动 Web 浏览器​ :选择此选项可启动浏览器。 在打开的对话框中,选择浏览器类型,并提供启动 URL。 此外,指定是否使用 JavaScript 调试器启动浏览器。

  • 运行外部工具 :选择此项以运行外部应用程序。 在打开的对话框中,选择您要运行的一个或多个应用。 如果它尚未在 PyCharm 中定义,请添加相应定义。 详细信息请参阅 外部工具 和 外部工具。

  • 运行另一个配置 :选择执行另一个运行/调试配置,并在启动当前配置之前等待其结束。 如果您想并行运行多个配置,请使用 复合运行/调试配置。

  • 运行 File Watchers :选择此选项以让 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年 7月 14日