PyCharm 2026.1 Help

通过 SSH 使用 Node.js

在开始之前

  1. 请确保在设置中启用 JavaScript 和 TypeScript 捆绑插件。 按 Ctrl+Alt+S 打开设置,然后选择 插件。 点击 已安装 选项卡。 在搜索字段中,键入 JavaScript 和 TypeScript。 有关插件的更多信息,请参见 管理插件

  2. 设置 | 插件 页面的 插件市场 选项卡上安装 Node.jsNode.js 远程解释器JavaScript 调试器FTP/SFTP/WebDAV 连接插件,详见 从 JetBrains Marketplace 安装插件。 插件仅在 PyCharm 专业版中可用。

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

  4. 请确保您的项目源代码位于目标远程主机上。 可以通过以下两种方式完成:

    • 按照 上传和下载文件 中的说明,将您的项目源代码上传到目标远程主机。

    • 在您的本地计算机上启用网络共享,并将您的项目文件夹挂载到远程主机的目标目录中。

      共享文件和文件夹的方式取决于您使用的操作系统。 有关更多信息,请参阅您的操作系统说明。

在可通过 SSH 访问的远程主机上配置 Node.js 运行时

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

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

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

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

  2. 点击 "浏览" 按钮 ,位于 Node 运行时 字段旁边。

    添加运行时 - 浏览按钮
  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 运行时 列表中选择 项目 别名时,PyCharm 都会自动使用此解释器,例如在创建运行/调试配置时。

    要使用与新运行时关联的包管理器来管理项目依赖项,请在项目中将此包管理器设置为默认。 为此,请在 软件包管理器(M) 字段中指定该包管理器的位置。

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

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

创建 Node.js 运行/调试配置

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

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

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

  4. Node 运行时 列表中,选择相应的可通过 SSH 访问的远程 Node.js 运行时。

    创建 Node.js 运行配置:选择通过 SSH 的远程 Node.js 解释器

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

  5. 将本地文件夹映射到远程主机上的文件夹。

    1. 点击 "浏览" 按钮 (位于 路径映射 字段旁),或按下 Shift+Enter

    2. 在打开的 编辑项目路径映射对话框 中,点击工具栏中的 添加按钮

      创建 Node.js 运行配置:添加映射
    3. 指定本地文件夹的路径以及远程主机上相应的文件夹。 例如,您可以将项目文件夹映射到 /home/opc

      创建 Node.js 运行配置:已添加映射
    4. 点击 确定(O) 后,您将返回到 运行/调试配置 对话框,其中新的映射显示在 路径映射 字段中。

      创建 Node.js 运行配置:显示已添加的映射

运行您的应用程序

  • 在工具栏的 运行/调试配置 小部件列表中,选择新创建的 Node.js 配置,然后点击其旁边的  Run 按钮

  • 或者,创建一个 Node.js 运行/调试配置(如上所述 )或修改现有配置,然后在对话框中点击 运行

调试应用程序

  1. 根据需要在 Node.js 代码中设置 断点

  2. 创建一个 Node.js 配置 如上所述 ,在工具栏的 选择运行/调试配置 列表中选择该配置,并点击列表旁的 Debug 按钮

  3. 操作方式与 在本地与 Node.js 应用程序一起启动调试器 时相同。

2026年 3月 24日