运行/调试配置:Node.js
创建:
在 IntelliJ IDEA 2023.3 及以后版本中,支持以下 Node.js 版本:
Node.js 20 - 活跃长期支持 (LTS) 版本
Node.js 21——当前版本
了解更多 支持的 Node.js 版本。
在此对话框中,为在您的计算机上启动调试器与 Node.js 应用程序一起创建配置。
开始之前
下载并安装 Node.js。
在 设置 | 插件 页面、 Marketplace 选项卡上安装 Node.js 插件,如 从 JetBrains Marketplace 安装插件 中所述。
配置选项卡
条目 | 描述 |
|---|---|
Node 解释器 | 在此字段中,指定要使用的 Node.js interpreter。 这可以是一个 本地或 远程的 Node.js 解释器或 适用于 Linux 的 Windows 子系统上的 Node.js。 从列表中选择一个解释器或点击 |
Node 形参 | 在此字段中,键入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 最常见的选项有:
有关完整列表,请参阅 Node.js command-line options。 |
工作目录 | 在此字段中,指定应用程序的 工作目录。 默认情况下,该字段显示 项目根文件夹。 |
JavaScript 文件 | 在此字段中,指定启动应用程序的主文件路径(例如, bin/www 对于 Express 应用程序)。 如果您要调试 CoffeeScript,请指定带有 source maps 的生成 JavaScript 文件的路径。 该文件可以通过外部生成或使用 File Watchers 编译生成。 如需了解更多信息,请参阅 Debugging CoffeeScript。 |
应用程序形参 | 在此字段中,输入通过 process.argv数组在启动时传递给应用程序的 Node.js 特定参数。 |
环境变量 | 在此字段中,指定 Node.js 可执行文件的 环境变量 (如果适用)。 点击 浏览
变量的定义显示在 环境变量 只读字段中,使用分号作为分隔符,例如:
|
Docker 容器设置 | 此只读字段显示端口和卷绑定。 请点击 ![]() |
Docker Compose | 在此区域中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置或点击 请检查 命令预览。 |
浏览器 / 实时编辑 选项卡
在此选项卡中,配置浏览器的行为并启用调试应用程序的客户端代码。 此功能通过 JavaScript调试 运行配置提供,因此从技术上讲,IntelliJ IDEA 为服务器端代码和客户端代码创建了单独的运行配置,但您可以在一个专用的 Node.js运行配置中指定所有设置。
条目 | 描述 |
|---|---|
打开浏览器 | 在此区域的字段中,指定一个项目 HTML 文件,以根据项目根目录创建一个正确的网址,以便在内置 Web 服务器上启动。 例如,如果您选择 project_root/inner_folder/index.html ,生成的 URL 将是 http://localhost:63342/project_root/inner_folder/index.html 。 如果您选择 启动后 复选框,应用程序启动后浏览器将自动打开此页面。 或者,您可以通过在您选择的浏览器中手动打开具有此 URL 地址的页面来查看相同的结果。 |
在启动后 | 选中此复选框以自动打开浏览器。 从列表中选择要使用的浏览器:
|
使用 JavaScript 调试器 | 选中此复选框以启用在选定浏览器中调试客户端代码。 |
V8 分析标签
在此选项卡中,启用 V8 CPU 和内存分析器。
条目 | 描述 |
|---|---|
记录 CPU 分析信息 | 选中此复选框以在应用程序启动时开始记录 CPU 分析数据。 下方区域的控件将启用。 请指定以下内容:
|
允许采集堆快照 | 如果您要进行内存分析,请选择此复选框。 |
日志标签
在此选项卡中,启用显示由 morgan 等日志记录工具生成的信息,并在 控制台 选项卡的 运行 工具窗口中显示。 有关详细信息,请参阅 运行 Node.js 应用程序时管理日志。
通用设置
当您编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:
条目 | 描述 |
|---|---|
名称(N) | 在编辑或运行时,指定运行配置的名称以便快速识别。 |
允许多个实例(U) | 允许并行运行此运行配置的多个实例。 默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置,IntelliJ IDEA 建议停止正在运行的实例并启动另一个。 当一个运行配置消耗大量资源且没有充分理由运行多个实例时,这会很有帮助。 |
存储为项目文件(S) | 将运行配置设置的文件保存下来,与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是,如果您不想共享 .idea 目录,您可以将配置保存到项目内的任何其他目录。 默认情况下,它是禁用的,并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。 |
工具栏
运行/调试配置的树状视图包含一个工具栏,可帮助您管理 项目 中可用的配置以及调整默认配置模板。
条目 | 快捷键 | 描述 |
|---|---|---|
Alt+Insert | 创建运行/调试配置。 | |
Alt+Delete | 删除所选的运行/调试配置。 请注意,您不能删除默认配置。 | |
Ctrl+D | 创建所选运行/调试配置的副本。 请注意,您正在创建默认配置的副本。 | |
只有当您选择了 temporary configuration时,按钮才会显示。 点击此按钮将临时配置保存为永久配置。 | ||
移动到新文件夹/创建新文件夹。 您可以通过 将它们放入文件夹来分组运行/调试配置。 要创建文件夹,请选择类别中的配置,点击 然后,若要将配置移动到文件夹中、文件夹之间或从文件夹中移出,请使用拖放或 要取消分组,请选择一个文件夹并点击 | ||
点击此按钮以按字母顺序排列配置。 |
启动前
在此区域,您可以指定在启动所选的运行/调试配置之前需要执行的任务。 任务将按其在列表中出现的顺序执行。
条目 | 快捷键 | 描述 |
|---|---|---|
Alt+Insert | 点击此图标以添加以下可用任务之一:
| |
Alt+Delete | 点击此图标以从列表中删除所选任务。 | |
Enter | 点击此图标以编辑所选任务。 在打开的对话框中进行必要的更改。 | |
Alt+Up Alt+Down | 点击这些图标可以将所选任务在列表中上下移动一行。 任务按照它们在列表中出现的顺序执行。 | |
显示此页面 | 选中此复选框,以在实际启动运行/调试配置之前显示运行/调试配置设置。 | |
激活工具窗口 | 默认情况下,将选中此复选框,启动运行/调试配置时将打开 Run 或 Debug 工具窗口。 否则,如果复选框被清除,工具窗口将被隐藏。 但是,当配置运行时,您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。 |

