使用 Docker Compose 的 Node.js
Docker Compose 用于运行多容器应用程序。 例如,您可以将 Web 服务器、后台数据库与应用程序代码分别作为服务运行。 如有需要,您可以通过添加更多容器来扩展每个服务。 由此,您可以在动态环境中高效地进行开发与测试,该环境与生产环境相似。
开始之前
请确保在 设置 | 插件 页面、 已安装 选项卡中启用了所需插件: JavaScript Debugger、 Node.js、 Node.js Remote Interpreter 和 Docker。 如需了解更多信息,请参阅 Managing plugins。
按照 Docker 中所述下载、安装并配置 Docker
使用 Docker Compose 配置 Node.js 解释器
Docker 中的 Node.js 解释器可在 配置Node.js 远程解释器 对话框中进行配置。 您可以通过 设置 对话框的 Node.js 页面打开此对话框,也可以在稍后 创建或编辑 Node.js 运行/调试配置时打开,用于运行或调试应用程序。
推荐的方式是在 设置 对话框中配置远程 Node.js 解释器。 在此情况下,您可以将解释器及其关联的包管理器设置为项目默认值。 因此,您不仅可以使用已配置的 Docker 中的 Node.js 解释器运行和调试应用程序,还可以管理项目依赖项、运行测试并对代码进行 lint 检查。 请参阅下方的 npm、pnpm 与 yarn 配合 Docker 使用、 测试应用 和 ESLint 与 Docker。
在 Node.js 运行/调试配置中直接配置的远程 Node.js 解释器仅可与该配置一同使用。
打开 设置 对话框(Ctrl+Alt+S ),然后转到 。
单击
按钮(位于 Node 解释器(I) 字段旁)。

在 Node.js Interpreters 对话框中,列表列出了当前已配置的所有解释器,请点击工具栏中的
,并在上下文菜单中选择 添加远程。

在打开的 Configure Node.js Remote Interpreter dialog 中,选择 Docker Compose。
从 服务器 列表中选择要使用的 Docker 配置。

或者,单击字段旁的 新建 ,根据 Enable Docker support 中的说明配置 Docker 服务器。
在 配置文件 字段中,指定要使用的 docker-compose 配置文件。 单击 浏览 ,并在打开的 Docker Compose 配置文件 对话框中创建配置文件列表。

从 服务 列表中选择要使用的服务:

单击 确定 返回到 Node.js 解释器 对话框,新解释器已添加到列表中。 如需将新配置的解释器设置为项目默认值,请在列表中选择该解释器并单击 确定 返回到 Node.js 对话框。

每次在 Node 解释器 列表中选择 Project 别名时(例如创建运行/调试配置时),WebStorm 都会自动使用该解释器。
如需使用与新解释器关联的包管理器来管理项目依赖项,请将该包管理器设置为项目默认值。 为此,请在 软件包管理器(M) 字段中指定包管理器的位置。 详细了解 在项目中指定默认的 Node.js 解释器和包管理器。
在项目中指定默认 Node.js 解释器和包管理器
每次从 Node 解释器 列表中选择 Project 别名时(例如,在创建运行/调试配置时),WebStorm 会自动使用默认项目解释器。
默认项目包管理器会自动用于管理依赖项,例如,当您从 package.json 文件中运行 <package manager> install 或安装第三方工具(如 ESLint、Prettier 等)时。
打开 设置 对话框(Ctrl+Alt+S ),然后前往 。
从 Node 解释器(I) 列表中选择在当前项目中默认使用的配置。
从 包管理器 列表中选择与要使用的包管理器关联的别名。 WebStorm 会自动检测其位置。

或者,手动指定所需包管理器的位置。
npm 可执行文件的默认位置为
/usr/local/lib/node_modules/npm。pnpm 的默认位置取决于安装方式:
通过 npm 安装时的位置为 /usr/local/lib/node_modules/pnpm 。
通过 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 运行/调试配置
前往 。 在打开的 编辑配置 对话框中,点击工具栏上的
,然后在上下文菜单中选择 Node.js。 运行/调试配置:Node.js 对话框将打开。
在 文件 字段中指定启动应用的主文件路径(例如, Express 应用的 bin/www )。

如有必要,可根据 运行和调试 Node.js 应用 中的说明指定一些可选设置。
从 Node 解释器(I) 列表中选择通过 Docker Compose 使用的相关远程 Node.js 解释器。

或者,点击
(在 Node 解释器(I) 字段旁边),如 上文所述 配置远程 Node.js 解释器。

在 Docker Compose 区域中指定要传递给 Docker Compose 的命令和选项。 接受默认设置或点击
并指定自定义设置,例如自定义 Docker Compose 标志,如
--rm或--service-ports。 请参阅 Docker 官方网站 了解详情。检查 命令预览。
