WebStorm 2025.2 Help

配置 Node.js 远程解释器对话框

在 WebStorm 2023.3 及更高版本中支持以下 Node.js 版本:

  • Node.js 20 —— 当前的长期支持 (LTS) 版本

  • Node.js 21 —— 当前版本

请参阅 支持的 Node.js 版本 了解详情。

单击 添加 添加按钮 后将打开该对话框,路径为 Node.js 解释器 对话框中选择 远程... 下拉菜单中的相应项。 此菜单项仅在您从 运行/调试配置:Node.js 打开 Node.js 解释器 对话框时可用。

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

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

项目

描述

SSH

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

请参阅 创建 SSH 配置 了解详情。

Docker

仅在启用了 Node.jsNode.js Remote InterpreterDocker Integration 插件后才可用,详见 从插件仓库安装插件

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

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

  2. 镜像名称 字段中,指定要使用的基础 Docker 镜像。 从列表中选择一个已下载或自定义的镜像,或手动输入镜像名称,例如 node:argonmhart/alpine-node。 稍后启动运行配置时,Docker 将在您的计算机上查找指定的镜像。 如果查找失败,将从 Docker Registry 页面 中的仓库下载该镜像。 建议使用 官方 Node.js Docker 镜像

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

  4. 单击 确定 后,WebStorm 将关闭 配置 Node.js 远程解释器 对话框,并返回到 Node.js 解释器 对话框,新解释器配置已添加至列表。 单击 确定 返回到运行配置。

Docker Compose

该选项仅在启用了 Node.jsNode.js Remote InterpreterDocker Integration 插件后可用,相关说明详见 从插件仓库安装插件

选择此选项以使用定义在 Docker Compose 文件 docker-compose.yml 中的 Node.js 解释器配置。 请注意,该文件的 command 字段中必须包含 nodenpm ,例如 command: node ./src/app.js。 详见 Docker 官方网站

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

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

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

  4. 可选地,在 环境变量 字段中定义环境变量。 有关详细信息,请参阅 Docker Compose 运行配置设置。

Vagrant

仅当启用 Vagrant 插件时,此选项才可用。 Vagrant 插件与 WebStorm 一起捆绑提供,并默认启用。 如果插件被禁用,请在 已安装 选项卡的 设置 | 插件 页面中启用它,如 管理插件 中所述。

选择此选项以使用您的 Vagrant 凭据配置对安装在 Vagrant 实例中的 Node.js 解释器的访问。 从技术上讲,它是放置目标环境的 VagrantFile 配置文件的文件夹。 根据此设置,WebStorm 会检测到 Vagrant 主机 ,并在 Vagrant 主机 URL 只读字段中显示为链接。

要使用解释器配置,您需要 路径映射 ,以设置项目文件夹、服务器上的目标文件夹以及用于访问服务器上数据的 URL 之间的对应关系。 WebStorm 会从 VagrantFile 配置文件中评估路径映射。

Node.js 解释器路径

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

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

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

要指定其他文件夹,请单击 打开 并在打开的对话框中选择相关文件夹。 请注意,Node.js 主目录必须可编辑。

单击 确定 时,WebStorm 会检查指定文件夹中是否确实包含 Node.js 可执行文件。

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

    找不到 PHP 可执行文件
  • 如果找到 Node.js 可执行文件,系统将返回至 Node.js 解释器 对话框,并显示安装文件夹及检测到的 Node.js 解释器版本。

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