WebStorm 2025.2 Help

Bun

WebStorm 集成了 Bun ,因此,您可以使用它运行与调试 JavaScript 和 TypeScript 文件,也可以将其用作包管理器。

开始之前

请确保已在 已安装 选项卡的 设置 | 插件 页面中启用 Bun 捆绑插件,如 安装插件 所述。

安装 Bun

请按照 Bun 官方网站 上的说明安装 Bun。

配置 Bun

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 语言与框架 | Bun

  2. 指定 Bun 可执行文件的路径。

    Bun 可执行文件的路径默认为您的 PATH 环境变量,因此如果您将 Bun 字段留空,调试器将尝试自动检测 Bun 可执行文件。

将 Bun 设置为项目包管理器

  1. 在打开的 设置 对话框中(Ctrl+Alt+S ),转到 语言与框架 | Node.js。 将打开 Node.js 页面。

  2. 包管理器 字段中,指定 Bun 安装位置。

    • 选择 bun 可使用系统默认安装。

      选择 Bun 作为项目包管理器
    • 如需使用自定义安装,请点击 选择 ,然后从列表中选择安装文件夹,详细了解请参阅 选择项目包管理器

使用 Bun 运行并调试

WebStorm 支持调试适配器协议(DAP),增强了调试体验。

使用 Bun,您可以运行并调试 JavaScript 与 TypeScript 文件。

从编辑器中使用 Bun 运行或调试

如果您已将 Bun 指定为默认项目包管理器 如上所述 ,则可以直接从编辑器中运行与调试 JavaScript 与 TypeScript 文件。 在此情况下,WebStorm 会创建一个 临时运行/调试配置 ,您可以将其保存并在以后使用。

  • 如需运行文件,请从上下文菜单中选择 运行 '<file name>'

    从编辑器中使用 Bun 运行文件
  • 如需调试文件,请在需要的地方设置断点,然后从上下文菜单中选择 调试 '<file name>'

    从编辑器中启动 Bun 调试会话

通过运行/调试配置使用 Bun 运行与调试

使用 Bun 运行/调试配置进行调试

创建 Bun 运行/调试配置

  1. 转到 运行 | 编辑配置。 或者,也可以从工具栏的 运行 小部件中选择 编辑配置

    打开编辑配置对话框

    在打开的 编辑配置 对话框中,点击工具栏上的 添加 按钮(添加按钮 ),从列表中选择 Bun

    创建运行/调试配置,选择类型为 Bun

    将打开 运行/调试配置:Bun 对话框。

  2. 文件 字段中,指定启动应用程序的主文件路径。 请指定所需的 JavaScript 或 TypeScript 文件,或使用宏,例如 $FilePath$

  3. 可选:

    • Bun 参数 字段中,指定 Bun CLI 选项,例如 --watch--hot ,详细说明请参阅 Bun 官方网站

    • 勾选 在入口处中断 复选框,使应用程序在第一行停止执行。

运行/调试配置:Bun

运行应用程序

  1. 创建 Bun 运行/调试配置 如上所述

  2. 从工具栏的 运行/调试配置 小部件列表中,选择新建的 Bun 配置,然后点击其旁边的 运行按钮

    通过 Bun 运行/调试配置运行应用程序

开始调试

  1. 在代码中需要的地方设置 断点

  2. 创建 Bun 运行/调试配置 如上所述

  3. 从工具栏的 运行 小部件列表中,选择新建的 Bun 配置,然后点击其旁边的 调试按钮

    使用运行/调试配置启动 Bun 调试会话

    调试工具窗口将打开。

  4. 执行将触发包含断点代码的操作,然后切换至 WebStorm,此时将启用 调试 工具窗口的控件。 继续调试会话 — 逐步执行断点 、切换帧、动态修改变量、 检查挂起的程序计算表达式以及 设置监视

最后修改日期: 2025年 9月 26日