PhpStorm 2026.3 Help

配置远程 Node.js 运行时

在 PhpStorm 中,当您希望在安装于远程主机或虚拟环境中的 Node.js 上开发、测试、代码检查、运行和调试应用程序时,您需要配置远程 Node.js 运行时。

远程 Node.js 运行时在 配置 Node.js 远程运行时 对话框中进行配置。 您可以从 设置 对话框的 JavaScript 运行时 页面打开此对话框,或在稍后为在远程环境中运行或调试应用程序而创建或编辑 Node.js 运行/调试配置时打开。

建议的方式是在 设置 对话框中配置远程 Node.js 运行时。 在这种情况下,您可以将该运行时及其关联的包管理器设置为项目默认。

直接在 Node.js 运行/调试配置中配置的远程 Node.js 运行时只能与该运行/调试配置一起使用。

在远程环境中安装 Node.js

在未配置 Node.js 运行时的远程环境中打开需要 Node.js 的文件时,PhpStorm 会建议下载该运行时。 选择所需的运行时版本及其安装位置。

在远程环境中安装 Node.js

通过 SSH 连接可访问的主机上的远程 Node.js 运行时

开始之前

  1. 按照 从 JetBrains Marketplace 安装插件中的说明,在 设置 | 插件 页面上安装并启用 Node.js 远程解释器 插件。

  2. 请确保在设置中启用了 FTP/SFTP/WebDAV Connectivity 插件。 按 Ctrl+Alt+S 打开设置,然后选择 插件。 在搜索栏中,输入 FTP/SFTP/WebDAV Connectivity。 有关插件的更多信息,请参阅 插件管理。

  3. 按照 创建 SSH 配置中的描述,在目标远程主机上配置访问 SSH 服务器,并确保该服务器正在运行。

通过 SSH 的 Node.js 运行时在 配置 Node.js 远程运行时 对话框中进行配置。 您可以从 JavaScript 运行时 页面(位于 设置 对话框中)打开此对话框,或者在稍后,当您 创建或编辑 Node.js 运行/调试配置 以运行或调试您的应用程序时。

建议的方式是在 设置 对话框中配置远程 Node.js 运行时。 在这种情况下,您可以将该运行时及其关联的包管理器设置为项目默认。

直接在 Node.js 运行/调试配置中配置的远程 Node.js 运行时只能与该运行/调试配置一起使用。

在设置对话框中通过 SSH 配置远程 Node.js 运行时

  1. 打开 设置 对话框(Ctrl+Alt+S ),然后转到 语言与框架 | JavaScript 运行时。

  2. 点击 "浏览" 按钮 字段旁的 Node.js 运行时。

    添加运行时 - 浏览按钮
  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. 要将新配置的运行时设置为项目默认,请在列表中选择它并点击 确定 以返回到 JavaScript 运行时 对话框。

    每次您从 Node.js 运行时 列表中选择 项目 别名时,PhpStorm都会自动使用此解释器,例如在创建运行/调试配置时。

    若要使用与新运行时关联的包管理器来管理项目依赖项,请将该包管理器设为项目默认。 要做到这一点,请在 包管理器 字段中指定包管理器的位置。

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

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

在运行/调试配置中通过 SSH 配置远程 Node.js 运行时

  1. 转到 运行 | 编辑配置。 在弹出的 编辑配置 对话框中,点击工具栏上的 添加新配置按钮 并从上下文菜单中选择 Node.js。 将打开 运行/调试配置:Node.js 对话框。

  2. 请点击 "浏览" 按钮 旁的 Node.js 运行时 字段。

    Node.js 运行/调试配置:已指定文件

    将打开 Node.js 运行时 对话框。

  3. 点击 "添加"按钮 工具栏中的按钮,并从上下文菜单中选择 添加远程。

    通过 SSH 的 Node.js:运行/调试配置、配置运行时、选择 添加远程
  4. 通过 SSH 配置远程 Node.js 运行时, 如上所述。

Docker 容器中的远程 Node.js 运行时

开始之前

  1. 按照 从 JetBrains Marketplace 安装插件中的说明,在 设置 | 插件 页面上安装并启用 Node.js 远程解释器 插件。

  2. 确保 Node.js 和 Docker 所需插件已在 设置 | 插件 页面上启用。 有关更多信息,请参阅 管理插件。

  3. 下载、安装并配置 Docker ,如 Docker 中所述.

Docker 中的 Node.js 运行时在 配置 Node.js 远程运行时 对话框中进行配置。 您可以从 JavaScript 运行时 页面中的 设置 对话框打开此对话框,或者在稍后当您为了在 Docker 中运行或调试您的应用程序而 创建或编辑 Node.js 运行/调试配置 时打开。

建议的方式是在 设置 对话框中配置远程 Node.js 运行时。 在这种情况下,您可以将该运行时及其关联的包管理器设置为项目默认。 因此,您不仅可以使用在 Docker 中配置的 Node.js 运行时运行和调试应用,还可以管理项目依赖项、运行测试并执行代码检查。

直接在 Node.js 运行/调试配置中配置的远程 Node.js 运行时只能与该运行/调试配置一起使用。

在设置对话框中配置 Node.js 运行时

  1. 转到 运行 | 编辑配置。 在弹出的 编辑配置 对话框中,点击工具栏上的 添加新配置按钮 并从上下文菜单中选择 Node.js。

    在打开的 运行/调试配置:Node.js对话框中,点击 "浏览" 按钮 附近的 Node.js 运行时 字段。

  2. 在包含所有当前已配置运行时列表的 Node.js 运行时 对话框中,点击工具栏中的 "添加"按钮 ,然后在上下文菜单中选择 添加远程.

  3. 在打开的 配置 Node.js 远程运行时对话框 中,选择 Docker 选项。

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

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

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

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

在 Node.js 运行/调试配置中配置 Node.js 运行时

  1. 转到 运行 | 编辑配置。 在弹出的 编辑配置 对话框中,点击工具栏上的 添加新配置按钮 并从上下文菜单中选择 Node.js。 将打开 运行/调试配置:Node.js 对话框。

  2. 请点击 "浏览" 按钮 旁的 Node.js 运行时 字段。 将打开 Node.js 运行时 对话框。

  3. 点击 "添加"按钮 工具栏中的按钮,并从上下文菜单中选择 添加远程。

    在 Docker 中的 Node.js:运行/调试配置,配置运行时,选择 添加远程
  4. 配置远程 Node.js 运行时, 如上所述。

在带有 Docker Compose 定义的 Docker 容器中使用远程 Node.js 运行时

借助 Docker Compose ,您可以将 Node.js 服务器和您的应用程序代码作为单独的服务运行。 每个服务都可以通过添加更多的容器来扩展规模(如果需要的话)。 这使您能够在类似于生产环境的动态环境中进行高效的开发和测试。

开始之前

  1. 按照 从 JetBrains Marketplace 安装插件中的说明,在 设置 | 插件 页面上安装并启用 Node.js 远程解释器 插件。

  2. 确保 Node.js 和 Docker 所需插件已在 设置 | 插件 页面上启用。 有关更多信息,请参阅 管理插件。

  3. 下载、安装并配置 Docker ,如 Docker 中所述.

多容器 Docker 应用程序中的 Node.js 运行时在 配置 Node.js 远程运行时 对话框中进行配置。 您可以从 设置 对话框的 JavaScript 运行时 页面打开此对话框,或在稍后为在 Vagrant 环境中运行或调试应用程序而 创建或编辑 Node.js 运行/调试配置 时打开。

建议的方式是在 设置 对话框中配置远程 Node.js 运行时。 在这种情况下,您可以将该运行时及其关联的包管理器设置为项目默认。 因此,您不仅可以使用在 Docker 中配置的 Node.js 运行时运行和调试应用,还可以管理项目依赖项、运行测试并执行代码检查。 请参阅 npm、pnpm 和 yarn 与 Docker、 测试您的应用程序 和 使用 Docker 的 ESLint 下文。

直接在 Node.js 运行/调试配置中配置的远程 Node.js 运行时只能与该运行/调试配置一起使用。

  1. 打开 设置 对话框(Ctrl+Alt+S ),然后转到 语言与框架 | JavaScript 运行时。

  2. 点击 "浏览" 按钮 字段旁的 Node.js 运行时。

    添加运行时 - 浏览按钮
  3. 在包含所有当前已配置运行时列表的 Node.js 运行时 对话框中,点击工具栏中的 "添加"按钮 ,然后在上下文菜单中选择 添加远程.

    在 Docker 容器中配置 Node.js 运行时:添加远程
  4. 在打开的 配置 Node.js 远程运行时对话框 中,选择 Docker Compose。

  5. 从 服务器 列表中,选择要使用的 Docker 配置。

    通过 Docker Compose 配置 Node.js 运行时:选择 Docker 服务器

    或者,点击字段旁边的 新建 按照 启用 Docker 支持 中的描述配置 Docker 服务器。

  6. 在 配置文件 字段中,指定要使用的 docker-compose 配置文件。 点击 浏览 ,并在打开的 Docker Compose 配置文件 对话框中创建配置文件列表。

    通过 Docker Compose 配置 Node.js 运行时:配置文件
  7. 从 服务 列表中选择要使用的服务:

    通过 Docker Compose 配置 Node.js 运行时:选择服务
  8. 点击 确定 返回到 Node.js 运行时 对话框,其中已将新运行时添加到列表。 要将新配置的运行时设置为项目默认,请在列表中选择它并点击 确定 返回到 JavaScript 运行时 对话框。

    远程运行时对话框:已将在 Docker 中的新 Node.js 运行时添加到列表中

每次您从 Node.js 运行时 列表中选择 项目 别名时,PhpStorm都会自动使用此解释器,例如在创建运行/调试配置时。

若要使用与新运行时关联的包管理器来管理项目依赖项,请将该包管理器设为项目默认。 要做到这一点,请在 包管理器 字段中指定包管理器的位置。 详细了解,请参阅 在项目中指定默认的 Node.js 运行时和包管理器。

在项目中指定默认的 Node.js 运行时和包管理器

每次您在 Node.js 运行时 列表中选择 项目 别名时,PhpStorm 都会自动使用项目默认解释器,例如在创建运行/调试配置时。

默认的项目包管理器会自动用于管理依赖项,例如,当您从 <package manager> install 文件运行 package.json 或安装第三方工具(例如 ESLint、Prettier 等)时。

  1. 打开 设置 对话框(Ctrl+Alt+S ),然后转到 语言与框架 | JavaScript 运行时。

  2. 确保在 首选运行时 列表中选中 Node.js。

    选择首选运行时
  3. 从 Node.js 运行时 列表中选择要在当前项目中默认使用的配置。

    选择默认 Node.js 配置
  4. 从 包管理器 列表中选择与要使用的软件包管理器相关联的别名。 PhpStorm 会自动检测其位置。

    设置:已将新配置的远程 Node.js 运行时选为默认

    或者,手动指定所需包管理器的位置。

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

    • 默认情况下,pnpm 的位置取决于安装方法:

      1. 通过 /usr/local/lib/node_modules/pnpm 安装。

      2. /usr/local/pnpm-global/<version>/node_modules/pnpm 适用于通过 curl 安装(curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm)。

      进一步了解请访问 pnpm official website。

    • yarn 的默认位置是 /opt/yarn-<version>5 ,例如, /opt/yarn-v1.22.5 。

在 Node.js 运行/调试配置中使用 Docker Compose 定义配置 Node.js 运行时

  1. 转到 运行 | 编辑配置。 在弹出的 编辑配置 对话框中,点击工具栏上的 添加新配置按钮 并从上下文菜单中选择 Node.js。 将打开 运行/调试配置:Node.js 对话框。

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

    Node.js 运行/调试配置:指定的 JavaScript 文件
  3. 如有必要,请按照 运行和调试 Node.js 应用程序中描述的方式指定一些可选设置。

  4. 从 Node.js 运行时 列表中,选择通过 Docker Compose 的相应远程 Node.js 运行时。

    使用 Docker Compose 运行/调试 Node.js:选择解释器

    或者,单击 "浏览" 按钮 ,位于 Node.js 运行时 字段旁边。 并按照 如上所述 配置远程 Node.js 运行时。

    在 Docker 中的 Node.js:运行/调试配置,配置运行时,选择 添加远程
  5. 在 Docker Compose 区域中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置或点击 “展开”按钮 并指定自定义设置,例如,自定义 Docker Compose 标志,像 --rm 或 --service-ports。 了解更多信息请访问 Docker 官方网站。

    请检查 命令预览。

    Docker Compose 区域预览

Vagrant 实例中的 Node.js 运行时

使用 Vagrant ,您可以快速引导您的 Node.js 应用程序来运行、调试和分析它的性能,从 PhpStorm 开始。

开始之前

  1. 按照 从 JetBrains Marketplace 安装插件中的说明,在 设置 | 插件 页面上安装并启用 Node.js 远程解释器 插件。

  2. 请确保已在您的计算机上下载、安装并配置好 Vagrant 和 Oracle's VirtualBox。 更多信息,请参见 Vagrant。

  3. 请确保以下可执行文件的父文件夹已添加到系统 PATH变量:

    • vagrant.bat 或 vagrant 从 您的 Vagrant 安装。 这应该由 Vagrant 安装程序自动完成。

    • VBoxManage.exe 或 VBoxManage 来自 您 的 Oracle 的 VirtualBox 安装。

Vagrant 环境中的 Node.js 运行时在 配置 Node.js 远程运行时 对话框中进行配置。 您可以从 设置 对话框的 JavaScript 运行时 页面打开此对话框,或在稍后为在 Vagrant 环境中运行或调试应用程序而 创建或编辑 Node.js 运行/调试配置 时打开。

建议的方式是在 设置 对话框中配置远程 Node.js 运行时。 在这种情况下,您可以将该运行时及其关联的包管理器设置为项目默认。

直接在 Node.js 运行/调试配置中配置的远程 Node.js 运行时只能与该运行/调试配置一起使用。

在设置对话框中配置 Node.js 运行时

  1. 打开 设置 对话框(Ctrl+Alt+S ),然后转到 语言与框架 | JavaScript 运行时。

  2. 点击 "浏览" 按钮 字段旁的 Node.js 运行时。

    添加运行时 - 浏览按钮
  3. 在包含所有当前已配置运行时列表的 Node.js 运行时 对话框中,点击工具栏中的 "添加"按钮 ,然后在上下文菜单中选择 添加远程.

    在 Vagrant 实例中配置 Node.js 远程运行时:添加远程
  4. 在打开的 配置 Node.js 远程运行时对话框 中,选择 Vagrant。

  5. 请指定 Vagrant 实例文件夹 ,该变量指向您将要使用的环境。

    从技术上讲,这是用于所需环境的 VagrantFile 配置文件所在的文件夹。 基于此设置,PhpStorm 检测到 Vagrant host 并将其作为链接显示在 Vagrant 主机 URL 只读字段中。

    默认情况下,该字段显示当前项目文件夹。

  6. 在 Node.js 运行时路径 字段中,指定 Node.js 可执行文件的位置。

    在 Vagrant 环境中配置远程 Node.js 运行时:指定实例文件夹和 Node 可执行文件的位置

    要定位 Node.js 可执行文件,请打开命令行 shell 或嵌入的 终端 (Alt+F12 ),并输入:

    vagrant ssh whereis node exit
    在 Vagrant 环境中定位 Node.js 可执行文件
  7. 点击 确定 返回到 Node.js 运行时 对话框,其中已将新运行时添加到列表。

  8. 要将新配置的运行时设置为项目默认,请在列表中选择它并点击 确定 以返回到 JavaScript 运行时 对话框。

    远程运行时对话框:已将在 Vagrant 环境中的新 Node.js 运行时添加到列表中

    每次您从 Node.js 运行时 列表中选择 项目 别名时,PhpStorm都会自动使用此解释器,例如在创建运行/调试配置时。

  9. 指定要使用的软件包管理器路径。

    配置远程 Node.js 运行时:已指定包管理器

    要定位软件包管理器,请打开命令行 shell 或嵌入的 终端 (Alt+F12 ),并输入:

    vagrant ssh whereis <package manager> exit
    在 Vagrant 环境中定位软件包管理器

在 Node.js 运行/调试配置中配置 Node.js 运行时

  1. 转到 运行 | 编辑配置。 在弹出的 编辑配置 对话框中,点击工具栏上的 添加新配置按钮 并从上下文菜单中选择 Node.js。 将打开 运行/调试配置:Node.js 对话框。

  2. 请点击 "浏览" 按钮 旁的 Node.js 运行时 字段。 将打开 Node.js 运行时 对话框。

  3. 点击 "添加"按钮 工具栏中的按钮,并从上下文菜单中选择 添加远程。

  4. 在 Vagrant 环境中配置远程 Node.js 运行时, 如上所述。

2026年 11月 9日