运行/调试配置:Node.js
创建:
在 GoLand 2023.3 及更高版本中支持以下 Node.js 版本:
Node.js 20 - 当前长期支持(LTS)版本
Node.js 21 - 当前版本
了解更多信息,请参见 支持的 Node.js 版本。
在此对话框中创建配置,以便在本机启动调试器并同时运行 Node.js 应用程序。
开始之前
下载并安装 Node.js。
按照 从 JetBrains Marketplace 安装插件中的说明,在 设置 | 插件 页的 插件市场 选项卡中安装 Node.js 插件。
配置选项卡
项目 | 描述 |
|---|---|
Node 解释器 | 在此字段中,指定要使用的 Node.js 解释器。 该解释器可以是 本地 或 远程 Node.js 解释器,或者是 Windows Subsystem for Linux 上的 Node.js。 从列表中选择一个解释器,或点击 |
Node 参数 | 在此字段中输入要传递给 Node.js 可执行文件的 Node.js 专用命令行选项。 常见选项包括:
有关完整列表,请参阅 Node.js command-line options。 |
工作目录 | 在此字段中,指定应用程序的 工作目录。 默认情况下,该字段显示 项目根目录。 |
JavaScript 文件 | 在此字段中,指定启动应用程序的主文件路径(例如, bin/www ,适用于 Express 应用)。 如果准备调试 CoffeeScript,请指定包含 source map 的生成 JavaScript 文件路径。 该文件可以通过外部方式生成,也可以使用 File Watchers 编译生成。 有关详细信息,请参阅 调试 CoffeeScript。 |
应用程序参数 | 在此字段中输入 Node.js 特定参数,在启动时通过 process.argv 数组传递给应用程序。 |
环境变量 | 在此字段中,指定 Node.js 可执行文件的 环境变量 (如适用)。 单击字段右侧的 浏览
变量定义显示在 环境变量 只读字段中,以分号分隔,例如:
|
Docker 容器设置 | 该只读字段显示端口和卷绑定信息。 单击 ![]() |
Docker Compose | 在此区域中,指定要传递给 Docker Compose 的命令和选项。 使用默认设置,或单击 查看 命令预览。 |
浏览器 / 实时编辑选项卡
在此选项卡中配置浏览器行为,并启用调试应用程序的客户端代码。 此功能通过 JavaScript 调试 运行配置提供,因此,技术上 GoLand 会为服务器端与客户端代码创建单独的运行配置,但您可在一个专用 Node.js 运行配置中设置所有参数。
项 | 说明 |
|---|---|
打开浏览器 | 在此区域的字段中,指定项目的 HTML 文件,根据项目根目录为其创建正确的 URL,以通过内置 Web 服务器启动此文件。 例如,如果选择 project_root/inner_folder/index.html ,则生成的 URL 将为 http://localhost:63342/project_root/inner_folder/index.html 。 如果选中 启动后 复选框,应用程序启动后浏览器将自动打开此页面。 或者,您也可以手动在所选浏览器中输入此 URL 地址来查看相同页面。 |
启动后 | 选中此复选框以自动打开浏览器。 从列表中选择要使用的浏览器:
|
使用 JavaScript 调试器 | 选中此复选框以在所选浏览器中启用客户端代码调试。 |
V8 分析选项卡
项 | 说明 |
|---|---|
记录 CPU 分析信息 | 选中此复选框以在应用程序启动时开始记录 CPU 分析数据。 下方区域中的控件将变为可用。 请指定以下内容:
|
允许获取堆快照 | 若要运行内存分析,请选中此复选框。 |
日志选项卡
在此选项卡中,可启用在 控制台 选项卡的 运行 工具窗口中显示由 morgan 等日志工具生成的信息。 如需了解更多信息,请参阅 Managing logs when running a Node.js app。
通用设置
编辑运行配置(而非运行配置模板)时,您可以指定以下选项:
项目 | 描述 |
|---|---|
名称(N) | 为运行配置指定一个名称,以便在编辑或运行时快速识别。 |
允许多个实例(U) | 允许同时并行运行多个此运行配置的实例。 默认情况下,该选项处于禁用状态。当您在另一个实例仍在运行时启动此配置,GoLand 会建议停止正在运行的实例并启动另一个实例。 当运行配置占用大量资源且没有合理理由同时运行多个实例时,此设置十分有用。 |
存储为项目文件(S) | 保存包含运行配置设置的文件,以便与其他团队成员共享。 默认位置为 .idea/runConfigurations 。 但是,如果您不希望共享 .idea 目录,可以将配置保存到项目中的任何其他目录中。 默认情况下,该选项处于禁用状态,GoLand 会将运行配置设置存储在 .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 自行打开相应的工具窗口。 |
