JetBrains Rider 2025.2 Help

使用 Docker Compose 的 Node.js

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

开始之前

  1. 确保 JavaScript and TypeScriptJavaScript DebuggerNode.jsNode.js Remote InterpreterDocker 必需插件在 设置 | 插件 页面和 已安装 标签上已启用。 如需更多信息,请参阅 插件管理

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

使用 Docker Compose 配置 Node.js 解释器

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

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

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

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

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

  1. 打开 设置/首选项 对话框(Ctrl+Alt+S ),然后转到 语言和框架| Node.js

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

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

    设置:新配置的远程 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 运行/调试配置

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

    请检查 命令预览

    Docker Compose 区域预览
最后修改日期: 2025年 9月 26日