PyCharm 2025.3 Help

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

自 PyCharm 2023.3 起支持以下 Node.js 版本:

  • Node.js 22 —— 活跃的长期支持(LTS)版本

  • Node.js 24 —— 当前版本

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

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

使用此对话框配置对远程主机上的 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 官方镜像 存储库中的 Docker Registry 页面 下载该镜像。

  3. Node.js 运行时路径 字段显示来自指定镜像的默认 Node.js 运行时的位置。

  4. 当您点击 确定 时,PyCharm 会关闭 配置 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 官方网站

  1. 服务器 字段中,指定要使用的 Docker 配置。 有关详细信息,请参阅 使用 Docker:流程概览。 从列表中选择一个配置,或点击 “浏览”按钮 ,并在打开的 Docker 页面 上创建新配置。

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

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

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

Node.js 运行时路径

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

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

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

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

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

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