GoLand 2025.2 Help

Node.js 与 Docker Compose 集成

Docker Compose 用于运行多容器应用。 例如,您可以将 Web 服务器、后台数据库和应用代码作为独立服务运行。 如有需要,每个服务都可以通过添加更多容器进行扩展。 这样可以在接近生产环境的动态环境中高效进行开发与测试。

开始之前

  1. 请确保已在 设置 | 插件 页签 已安装 上启用所需的 JavaScript 与 TypeScriptJavaScript 调试器Docker 插件。 如需了解更多信息,请参阅 管理插件

  2. 请按照 从 JetBrains Marketplace 安装插件 所述,在 设置 | 插件 页签 Marketplace 中安装 Node.jsNode.js Remote Interpreter 插件。

  3. 请按照 从 JetBrains Marketplace 安装插件 所述,在 设置 | 插件 页签 Marketplace 中安装 Node.jsNode.js Remote Interpreter 插件。

  4. 按照 Docker 中的说明下载、安装并配置 Docker

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

Docker 中的 Node.js 解释器在 配置Node.js 远程解释器 对话框中配置。 您可以通过 设置 对话框中的 Node.js 页,或在 创建或编辑 Node.js 运行/调试配置 用于运行或调试应用时打开此对话框。

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

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

要使用与新解释器关联的包管理器来管理项目依赖项,请将其设置为项目默认包管理器。 为此,请在字段 软件包管理器(M) 中指定包管理器的位置。 详情请参阅 在项目中指定默认 Node.js 解释器和包管理器

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

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

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

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

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

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

    设置:新配置的远程 Node.js 解释器已设为默认

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

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

    • pnpm 的默认位置取决于安装方式:

      1. 通过 npm 安装的默认位置为 /usr/local/lib/node_modules/pnpm

      2. 通过 curl 安装的默认位置为 /usr/local/pnpm-global/<version>/node_modules/pnpm curl -f https://get.pnpm.io/<version>.js | node - add --global pnpm)。

      详细信息请参阅 pnpm 官方网站

    • 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 解释器。

    Node.js 与 Docker Compose:运行/调试配置,选择解释器

    或者,单击 浏览按钮 (位于字段 Node 解释器(I) 旁边),然后按照 上文所述配置远程 Node.js 解释器。

    Node.js 与 Docker Compose:运行/调试配置,配置解释器,选择添加远程
  5. 在区域 Docker Compose 中,指定要传递给 Docker Compose 的命令和选项。 接受默认设置,或者单击 展开按钮 并指定自定义设置,例如自定义 Docker Compose 标志,如 --rm--service-ports。 详细信息请参阅 Docker 官方网站

    检查 命令预览

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