GoLand 2025.2 Help

通过 SSH 使用 Node.js

开始之前

  1. 请确保在 设置 | 插件 页的 已安装 选项卡上启用了必要插件: JavaScript 和 TypeScriptJavaScript 调试器 以及 FTP/SFTP/WebDAV 连接。 如需了解更多信息,请参见 插件管理

  2. 请在 设置 | 插件 页的 Marketplace 选项卡上安装 Node.jsNode.js Remote Interpreter 插件,如 从 JetBrains Marketplace 安装插件 中所述。

  3. 请按照 创建 SSH 配置 中的说明,在目标远程主机上配置访问 SSH 服务,并确保该服务已运行。

  4. 请确保您的项目源文件位于目标远程主机上。 可以通过以下两种方式完成:

    • 按照 上传和下载文件 中所述,将您的项目源文件上传至目标远程主机。

    • 在本地计算机上启用网络共享,并在远程主机的目标目录中挂载项目文件夹。

      共享文件和文件夹的方式取决于您所使用的操作系统。 如需了解更多信息,请参阅您所用操作系统的说明文档。

在通过 SSH 访问的远程主机上配置 Node.js 解释器

通过 SSH 配置 Node.js 解释器是在 配置Node.js 远程解释器 对话框中完成的。 您可以通过 Node.js 页的 设置 对话框,或者在 创建或编辑 Node.js 运行 / 调试配置 时打开该对话框。

推荐方式是在 设置 对话框中配置远程 Node.js 解释器。 在这种情况下,您可以将解释器及其关联的包管理器设置为项目默认值。

在 Node.js 运行 / 调试配置中直接配置的远程 Node.js 解释器仅可用于该运行 / 调试配置。

  1. 打开 设置 对话框(Ctrl+Alt+S ),并转到 语言和框架 | Node.js

  2. 点击 浏览按钮 按钮,位于 Node 解释器(I) 字段旁边。

    添加解释器 - 浏览按钮
  3. 在列出所有已配置解释器的 Node.js 解释器 对话框中,点击工具栏上的 添加按钮 并从上下文菜单中选择 添加远程

    通过 SSH 配置 Node.js 解释器:添加远程主机
  4. 在打开的 配置 Node.js 远程解释器对话框 中,选择 SSH

  5. 选择要使用的 SSH 配置。

    通过 SSH 配置远程 Node.js 解释器:选择 SSH 配置

    或者,点击 浏览按钮 并根据 创建 SSH 配置 中的说明创建新的 SSH 配置。

  6. 点击 确定 返回 Node.js 解释器 对话框,新解释器会添加到列表中。

    “远程解释器”对话框:通过 SSH 添加的新 Node.js 解释器已列出
  7. 若要将新配置的解释器设置为项目默认值,请在列表中选择它并点击 确定 返回 Node.js 对话框。

    每次从 Node 解释器 列表中选择 Project 别名,例如创建运行 / 调试配置时,GoLand 会自动使用此解释器。

    若要使用与新解释器关联的包管理器来管理项目依赖项,请将其设置为项目默认包管理器。 为此,请在 软件包管理器(M) 字段中指定包管理器的位置。

    npm 可执行文件的默认位置是 /usr/local/lib/node_modules/npm

    通过 SSH 配置 Node.js 解释器:设置为项目默认解释器

创建 Node.js 运行 / 调试配置

  1. 转至 运行 | 编辑配置。 在打开的 编辑配置 对话框中,点击工具栏上的 添加新配置按钮 并在上下文菜单中选择 Node.js。 将打开 Run/Debug Configuration 对话框。

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

    Node.js 运行 / 调试配置:已指定 JavaScript 文件
  3. 如有需要,根据 运行和调试 Node.js 应用 中所述指定一些可选设置。

  4. Node 解释器(I) 列表中选择可通过 SSH 访问的相关远程 Node.js 解释器。

    创建 Node.js 运行配置:选择远程 Node.js 解释器 via SSH

    或者,单击 浏览按钮 (位于 Node 解释器(I) 字段旁)并按照上述方式配置远程 Node.js 解释器 as described above

  5. 将本地文件夹映射到远程主机上的文件夹。

    1. 单击位于 浏览按钮 旁的 路径映射 字段,或按下 Shift+Enter

    2. 在打开的 编辑项目路径映射对话框 中,单击工具栏中的 添加按钮

      创建 Node.js 运行配置:添加映射
    3. 指定本地文件夹及对应远程主机上的文件夹路径。 例如,您可以将项目文件夹映射到 /home/opc

      创建 Node.js 运行配置:已添加映射
    4. 单击 确定(O) 后,您将返回到 运行/调试配置 对话框,在 路径映射 字段中会显示新的映射项。

      创建 Node.js 运行配置:显示已添加映射

运行应用程序

  • 在工具栏的 运行/调试配置 小部件列表中,选择新建的 Node.js 配置,然后单击其旁边的 运行按钮

  • 或者,创建一个 Node.js 运行/调试配置 as described above ,或修改现有配置,然后在对话框中单击 运行

调试应用程序

  1. 在 Node.js 代码中根据需要设置 断点

  2. 创建一个 Node.js 配置 as described above ,在工具栏的 选择运行/调试配置 列表中选择该配置,并单击该列表旁的 调试按钮

  3. 操作方式与 在本地启动调试器并运行 Node.js 应用时相同。

最后修改日期: 2025年 9月 26日