WebStorm 2025.3 Help

配置 Node.js 远程运行时对话框

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

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

  • Node.js 24 - 当前版本

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

当您在 Node.js 运行时 对话框中点击 添加 "添加"按钮 ,并从下拉菜单中选择 远程... 时,将打开该对话框。

使用此对话框配置对远程主机或在 Vagrant 实例中设置的开发环境中安装的 Node.js 的访问权限。

在 Docker 上配置远程 Node.js 解释器

条目

描述

SSH

选择此选项以配置对通过 SSH 凭据可访问的远程主机或环境中的 Node.js 解释器的访问。 选择相应的 SSH 配置,并检查远程主机或环境中默认 Node.js 解释器的路径。

了解更多信息,请参阅 创建 SSH 配置

Docker

仅当启用了 Node.jsNode.js 远程解释器Docker 集成 插件时,此选项才可用,如 从存储库安装插件 中所述。

选择此选项以使用 Docker 容器中的 Node.js 解释器。

  1. 服务器 字段中,指定要使用的 Docker 配置。 有关更多信息,请参阅 配置 Docker 守护程序连接设置。 从列表中选择一个配置,或点击 新建… 并在打开的 Docker 页面上创建一个新配置。

  2. 镜像名称 字段中,指定要使用的基础 Docker 镜像。 从列表中选择一个先前下载的或自定义的图像,或者手动输入图像名称,例如, node:argonmhart/alpine-node。 当您稍后启动运行配置时,Docker 将在您的机器上搜索指定的镜像。 如果搜索失败,将从 Docker 注册表页面 的存储库中下载镜像。 建议您使用 官方 Node.js Docker 镜像

  3. Node.js 运行时路径 字段显示指定镜像中的默认 Node.js 解释器的位置。

  4. 当您点击 OK 时,WebStorm 会关闭 配置 Node.js 远程解释器 对话框,并将您带到 Node.js 运行时 对话框,在其中会将新的运行时配置添加到列表中。 点击 确定 返回运行配置。

Docker Compose

仅当启用了 Node.jsNode.js 远程解释器Docker 集成 插件时,此选项才可用,如 从存储库安装插件 中所述。

选择此选项以使用在 Docker Compose 文件 docker-compose.yml 中定义的 Node.js 解释器配置。 请注意,此文件必须在 command 字段中包含 nodenpm ,例如, command: node ./src/app.js。 如需更多信息,请参阅 Docker official website

  1. 服务器 字段中,指定要使用的 Docker 配置。 有关更多信息,请参阅 配置 Docker 守护程序连接设置。 从列表中选择一个配置,或点击 新建… 并在打开的 Docker 页面上创建一个新配置。

  2. 配置文件 字段中,指定定义应用程序服务的 docker-compose.yml 文件

  3. 服务 列表中选择您要运行的服务。

  4. 可选地,您可以在 环境变量 字段中定义环境变量。 有关更多信息,请参阅 Docker Compose run configuration设置。

Vagrant

仅当启用了 Vagrant 插件时,此选项才可用。 Vagrant 插件与 WebStorm 捆绑在一起,并默认激活。 如果插件被禁用,请按照 管理插件中描述的方式,在 已安装 选项卡的 设置 | 插件 页面上启用它。

选择此选项以配置对 Vagrant 实例 中 Node.js 解释器的访问,使用您的 Vagrant 凭据。 从技术上讲,这是用于所需环境的 VagrantFile 配置文件所在的文件夹。 基于此设置,WebStorm 检测到 Vagrant host 并将其作为链接显示在 Vagrant 主机 URL 只读字段中。

要使用运行时配置,您需要 路径映射 ,以设置项目文件夹、用于复制项目文件的服务器文件夹以及访问服务器上复制数据所用 URL 地址之间的对应关系。 WebStorm 从 VagrantFile 配置文件中评估路径映射。

Node.js 运行时路径

在此字段中,根据所选远程开发环境的配置,指定 Node.js可执行文件的位置。

  • 对于 Vagrant 实例,WebStorm 默认建议 /usr/bin/node 位置。

  • 对于 Docker 容器,WebStorm 默认建议 node 位置。

若要指定不同的文件夹,请点击 打开 并在打开的对话框中选择相关文件夹。 请注意,Node.js 主目录必须处于可编辑状态。

当您点击 OK 时,WebStorm 会检查 Node.js 可执行文件是否确实存储在指定的文件夹中。

  • 如果没有找到 Node.js 可执行文件,WebStorm 会显示一条错误消息,询问您是否继续搜索或仍然保存解释器配置。

    未找到 PHP 执行文件
  • 如果找到 Node.js 可执行文件,您将返回 Node.js 运行时 对话框,其中显示了安装文件夹和检测到的 Node.js 解释器版本。

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