CLion 2025.3 Help

运行/调试配置:Node.js

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

在 CLion 2023.3 及以后版本中,支持以下 Node.js 版本:

  • Node.js 22 - 当前长期支持( LTS )版本

  • Node.js 24 - 当前版本

有关更多信息,请参阅 支持的 Node.js 版本

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

在开始之前

  1. 下载并安装 Node.js

  2. 按照 从 JetBrains Marketplace 安装插件中的说明,在 设置 | 插件 中安装 Node.js 插件。

配置选项卡

项目

描述

Node.js 运行时

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

Node 参数

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

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

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

  • 使用 --inspect--inspect-brk 参数以支持 Chrome Debugging Protocol

有关完整列表,请参阅 Node.js command-line options

工作目录

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

JavaScript 文件

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

如果您要调试 CoffeeScript,请指定带有 source maps 的生成 JavaScript 文件的路径。 该文件可以通过外部生成或使用 File Watchers 编译生成。 如需了解更多信息,请参阅 Debugging CoffeeScript

环境变量

在此字段中,指定 Node.js 可执行文件的 环境变量 (如果适用)。 点击字段右侧的 浏览 “浏览”按钮 ,并在打开的 环境变量 对话框中配置变量列表:

  • 要定义一个新变量,请点击 添加按钮 并指定变量名称和值。

  • 要放弃某个变量定义,请在列表中选择它,然后点击 "移除"按钮

  • 准备就绪后,点击 确定

变量定义将显示在 环境变量 只读字段中,并使用分号作为分隔符,例如:

  • NODE_PATH :将目录作为前缀添加到模块搜索路径的列表,各目录以 : 分隔。

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

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

Docker 容器设置

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

结合 Docker 使用 Node.js:运行/调试配置、Docker 容器设置

Docker Compose

在此区域中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置或点击 “展开”按钮 并指定自定义设置,比如,自定义 Docker Compose 标志,如 --rm--service-ports。 了解更多信息,请访问 Docker 官方网站

请检查 命令预览

浏览器 / 实时编辑 选项卡

在此选项卡中,配置浏览器的行为并启用调试应用程序的客户端代码。 此功能通过 JavaScript Debug 运行配置提供,因此从技术上讲,CLion 为服务器端和客户端代码创建了单独的运行配置,但您可以在一个专用的 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 浏览器和预览 对话框中调整设置。 更多信息,请参见 Web 浏览器

使用 JavaScript 调试器

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

V8 分析标签

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

项目

描述

记录 CPU 分析信息

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

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

  • 一个日志文件用于所有隔离区 (V8 实例): 选中此复选框以为所有 V8 实例创建一个日志文件(并相应地一个分析结果视图)。 取消选中该复选框以为每个实例创建一个单独的文件。 Node.js 可以创建一个额外的 V8 实例,例如,用于调试过程。

允许获取堆快照

如果您要进行内存分析,请选择此复选框。

通用设置

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

项目

描述

名称(N)

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

允许多个实例(U)

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

默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置时,CLion建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。

存储为项目文件(S)

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

默认情况下,它是禁用的,CLion 会将运行配置设置存储在 .idea/workspace.xml

工具栏

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

项目

快捷方式

描述

添加按钮

Alt+Insert

创建运行/调试配置。

"移除"按钮

Alt+Delete

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

复制

Ctrl+D

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

保存配置

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

移动到新文件夹/创建新文件夹

移动至新文件夹/创建新文件夹。 您可以通过 将它们放入文件夹来分组运行/调试配置。

要创建文件夹,请选择某个类别中的配置,点击 文件夹 ,并指定文件夹名称。 如果只有一个类别处于焦点状态,则会创建一个空文件夹。

然后,为了将配置移动到文件夹中、文件夹之间或者文件夹外,请使用拖拽或 上移下移 按钮。

要删除分组,请选择一个文件夹,然后点击 删除配置

排序配置

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

启动前

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

快捷方式

描述

添加按钮

Alt+Insert

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

  • 运行外部工具 :选择运行外部应用程序。 在打开的对话框中,选择您要运行的一个或多个应用程序。 如果它在 CLion 中尚未定义,请添加其定义。 如需更多信息,请参阅 外部工具外部工具

  • 运行另一个配置 :选择执行另一个运行/调试配置,并等待其完成后再开始当前配置。 如果您想并行运行多个配置,请使用 复合运行/调试配置

  • 运行File Watcher :选择此选项以让 CLion 应用所有当前活动的 文件监视器

  • 运行Grunt 任务 :选择此选项来运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中,指定定义所需任务的 Gruntfile.js ,选择要执行的任务,并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。

  • 运行 Gulp 任务 :选择此选项以运行 Gulp task。

    在打开的 Gulp 任务 对话框中,指定定义所需任务的 Gulpfile.js ,选择要执行的任务,并指定传递给 Gulp 工具的参数。

    指定 Node.js 运行时的位置、要传递给它的参数,以及 gulp 包的路径。

  • 运行 npm Script :选择此选项来执行一个 npm 脚本。

    在打开的 npm 脚本 对话框中,指定 npm 运行/调试配置设置

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

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

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

  • 生成CoffeeScript 源映射 :选择此选项以为您的 CoffeeScript 源文件生成源映射。 在打开的对话框中,指定您的 CoffeeScript 源文件所在的位置。

"移除"按钮

Alt+Delete

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

编辑

Enter

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

方法向上

方法下

Alt+Up

Alt+Down

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

显示此页面

选择此复选框,以便在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下,此复选框处于选中状态,并且在您启动 run/debug 配置时, RunDebug 工具窗口会打开。

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

最后修改日期: 2025年 12月 8日