WebStorm 2025.3 Help

Bun

WebStorm 集成了 Bun ,从而使您能够使用其运行和调试 JavaScript 与 TypeScript 文件,以及将其用作软件包管理器。

开始之前

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

安装 Bun

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

配置 Bun

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 语言&框架 | JavaScript 运行时

  2. 请从 首选运行时 列表中选择 Bun

  3. Bun 区域中,指定 Bun 可执行文件的路径。

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

将 Bun 设置为项目软件包管理器

  1. 设置 对话框(Ctrl+Alt+S ),转到 语言与框架 | JavaScript 运行时。 将打开 JavaScript 运行时 页面。

  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年 12月 8日