PyCharm 2025.2 Help

配置远程 Node.js 解释器

在 PyCharm，您需要配置远程 Node.js 解释器，以便在安装在远程主机或虚拟环境中的 Node.js 上开发、测试、lint、运行和调试您的应用程序。

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

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

您直接在 Node.js 运行/调试配置中配置的远程 Node.js 解释器只能与此运行/调试配置一起使用。

通过 SSH 连接访问的主机上的远程 Node.js 解释器

在开始之前

  1. 按照 Node.js 和 Node.js Remote Interpreter 中的描述，在 设置 | 插件 页面、选项卡 Marketplace 中安装 从 JetBrains Marketplace 安装插件。

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

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

通过 SSH 配置 Node.js 解释器在 配置Node.js 远程解释器 对话框中。 您可以从 Node.js页面的 设置 对话框中打开此对话框，或者稍后在 创建或编辑 Node.js 运行/调试配置以运行或调试您的应用程序时打开。

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

您直接在 Node.js 运行/调试配置中配置的远程 Node.js 解释器只能与此运行/调试配置一起使用。

在设置对话框中通过 SSH 配置远程 Node.js 解释器

  1. 打开 设置 对话框（Ctrl+Alt+S ），然后转到 语言和框架 | Node.js。

  2. 点击 “浏览”按钮 字段旁的 Node 解释器(I)。

    添加解释器 - 浏览按钮

  3. 在 Node.js Interpreters 对话框中，当前配置的解释器列表，点击工具栏上的 添加按钮 并从上下文菜单中选择 添加远程。

    通过 SSH 配置 Node.js 解释器：添加远程

  4. 在打开的 配置 Node.js 远程解释器对话框中，选择 SSH。

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

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

    或者，点击 “浏览”按钮 并按照 创建 SSH 配置 中的描述创建一个新的 SSH 配置。

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

    远程解释器对话框：新的 Node.js 解释器通过 SSH 添加到列表中

  7. 要将新配置的解释器设置为项目默认解释器，请在列表中选择它并点击 确定 以返回 Node.js 对话框。

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

    要使用与新解释器关联的包管理器来管理您的项目依赖项，请在项目中将此包管理器设置为默认值。 要做到这一点，请在 软件包管理器(M) 字段中指定包管理器的位置。

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

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

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

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

  2. 请点击 “浏览”按钮 旁的 Node 解释器(I) 字段。

    Node.js 运行/调试配置：指定的 JavaScript 文件

    “ Node.js Interpreters ”对话框打开。

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

    通过 SSH 使用 Node.js：运行/调试配置，配置解释器，选择 Add Remote

  4. 通过 SSH 如上所述配置远程 Node.js 解释器。

在 Docker 容器中的远程 Node.js 解释器

在开始之前

  1. 按照 Node.js 和 Node.js Remote Interpreter 中的描述，在 设置 | 插件 页面、选项卡 Marketplace 中安装 从 JetBrains Marketplace 安装插件。

  2. 请确保在设置中启用了 Docker 插件。 按下 Ctrl+Alt+S 打开设置，然后选择 插件。 点击 已安装 选项卡。 在搜索字段中输入 Docker。 有关插件的更多信息，请参阅 插件管理。

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

Docker 中的 Node.js 解释器配置在 配置Node.js 远程解释器 对话框中。 您可以从 Node.js页面的 设置 对话框中打开此对话框，或者稍后在 创建或编辑 Node.js 运行/调试配置以在 Docker 中运行或调试您的应用程序时打开。

推荐的方式是在 设置 对话框中配置远程 Node.js 解释器。 在这种情况下，您可以将解释器和关联的包管理器设置为项目的默认值。 因此，您不仅可以用配置好的 Node.js 解释器在 Docker 中运行和调试您的应用程序，还可以管理您的项目依赖项、运行测试并对代码进行 lint。

您直接在 Node.js 运行/调试配置中配置的远程 Node.js 解释器只能与此运行/调试配置一起使用。

在“设置”对话框中配置 Node.js 解释器

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

    在打开的 运行/调试配置：Node.js对话框中，点击 “浏览”按钮 附近的 Node 解释器(I) 字段。

  2. 在 Node.js Interpreters 对话框中，当前配置的解释器列表，点击工具栏上的 添加按钮 并从上下文菜单中选择 添加远程。

  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. 当您点击 确定 时，PyCharm 会关闭 配置 Node.js 远程解释器 对话框，并将您带到 Node.js Interpreters 对话框，其中新的解释器配置被添加到列表中。 点击 确定 返回运行配置。

在 Node.js 运行/调试配置中配置 Node.js 解释器

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

  2. 请点击 “浏览”按钮 旁的 Node 解释器(I) 字段。 Node.js 解释器 对话框会打开。

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

    使用 Docker 的 Node.js：运行/调试配置、配置解释器、选择 添加 Remote

  4. 配置远程 Node.js 解释器 如上所述。

在 Docker 容器中使用带有 Docker Compose 定义的远程 Node.js 解释器

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

在开始之前

  1. 按照 Node.js 和 Node.js Remote Interpreter 中的描述，在 设置 | 插件 页面、选项卡 Marketplace 中安装 从 JetBrains Marketplace 安装插件。

  2. 请确保在设置中启用了 Docker 插件。 按下 Ctrl+Alt+S 打开设置，然后选择 插件。 点击 已安装 选项卡。 在搜索字段中输入 Docker。 有关插件的更多信息，请参阅 插件管理。

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

多容器 Docker 应用程序中的 Node.js 解释器是在 配置Node.js 远程解释器 对话框中配置的。 您可以从 Node.js页面的 设置 对话框中打开此对话框，或者稍后在 创建或编辑 Node.js 运行/调试配置以运行或调试您的应用程序时打开。

推荐的方式是在 设置 对话框中配置远程 Node.js 解释器。 在这种情况下，您可以将解释器和关联的包管理器设置为项目的默认值。 因此，您不仅可以用配置好的 Node.js 解释器在 Docker 中运行和调试您的应用程序，还可以管理您的项目依赖项、运行测试并对代码进行 lint。 请参阅 npm、pnpm 和 yarn 与 Docker、 测试您的应用程序 和 使用 Docker 的 ESLint 下文。

您直接在 Node.js 运行/调试配置中配置的远程 Node.js 解释器只能与此运行/调试配置一起使用。

  1. 打开 设置 对话框（Ctrl+Alt+S ），然后转到 语言和框架 ｜ Node.js。

  2. 点击 “浏览”按钮 字段旁的 Node 解释器(I)。

    添加解释器 - 浏览按钮

  3. 在 Node.js Interpreters 对话框中，当前配置的解释器列表，点击工具栏上的 添加按钮 并从上下文菜单中选择 添加远程。

    在 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 解释器 对话框，新的解释器将被添加到列表中。 要将新配置的解释器设置为项目默认解释器，请在列表中选择它并点击 确定 以返回 Node.js 对话框。

    远程解释器对话框：列表中添加了新的 Docker 中的 Node.js 解释器

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

要使用与新解释器关联的包管理器来管理您的项目依赖项，请在项目中将此包管理器设置为默认值。 要做到这一点，请在 软件包管理器(M) 字段中指定包管理器的位置。 从 在项目中指定默认的 Node.js 解释器和包管理器了解更多信息。

在项目中指定默认的 Node.js 解释器和包管理器

PyCharm 每次从 Project 列表中选择 Node Interpreter 别名时会自动使用默认的项目解释器，例如，在创建运行/调试配置时。

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

  1. 打开 设置 对话框（Ctrl+Alt+S ），然后转到 语言和框架 | Node.js。

  2. 从 Node 解释器(I) 列表中选择要在当前项目中默认使用的配置。

  3. 从 包管理器 列表中选择与要使用的软件包管理器相关联的别名。 PyCharm 会自动检测其位置。

    设置：新配置的远程 Node.js 解释器被选为默认解释器

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

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

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

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

      2. 通过 curl (curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm) 来安装 /usr/local/pnpm-global/<version>/node_modules/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 解释器(I) 列表中，选择通过 Docker Compose 相关的远程 Node.js 解释器。

    使用 Docker Compose 的 Node.js：运行/调试配置，选择解释器

    或者，单击 “浏览”按钮 ，位于 Node 解释器(I) 字段旁边。 并 如上所述配置一个远程 Node.js 解释器。

    使用 Docker 的 Node.js：运行/调试配置、配置解释器、选择 添加 Remote

  5. 在 Docker Compose 区域中，指定要传递给 Docker Compose 的命令和选项。 接受默认设置或点击 “展开”按钮 并指定自定义设置，例如，自定义 Docker Compose 标志，像 --rm 或 --service-ports。 了解更多信息请访问 Docker 官方网站。

    请检查 命令预览。

    Docker Compose 区域预览
最后修改日期： 2025年 9月 26日
支持的 Node.js 版本运行和调试 Node.js