Windows 下通过 WSL 安装配置 Bun 运行时的完整指南

背景

近期前端工具链领域涌现出一款备受瞩目的项目 Bun，其发展势头迅猛，行业竞争日益激烈。Bun 定位为一款全新的 JavaScript 运行时环境，内部集成了打包工具、转译器、任务运行器以及 npm 客户端等功能。

Bun 是一款类似于 Node.js 或 Deno 的现代 JavaScript 运行时。与 Node.js 采用 V8 引擎不同，Bun 基于 JavaScriptCore 构建。它原生实现了数百个 Node.js 和 Web API，涵盖了约 90% 的 Node-API 函数（用于本机模块）、文件系统（fs）、路径处理（path）以及 Buffer 等核心功能。

Bun 旨在浏览器之外运行全球大多数 JavaScript 代码，旨在通过提升性能和简化复杂性来增强未来基础设施，并通过提供更优、更简便的工具来提高开发者的生产力。

本文旨在演示如何在 Windows 系统上安装并体验 Bun。

环境准备

• 安装 WSL

官网提供的一键安装脚本仅支持 Linux、macOS 和 WSL 环境，无法直接在 Windows 桌面环境中运行。因此，若要在 Windows 上安装 Bun，必须首先安装 Linux 子系统，即 WSL（Windows Subsystem for Linux）。

具体安装步骤可参考微软官方文档《Install Linux on Windows with WSL》。

建议使用 Windows Terminal 以快速启动 WSL 终端，可在 Microsoft Store 中获取：Windows Terminal。

• 确保开启 BIOS 虚拟机功能

进入 BIOS 设置界面，将虚拟化技术 Intel Virtual Technology 的状态由 Disable 更改为 Enable，以启用该功能。

• 开启 Hyper-v

以管理员身份运行 PowerShell 或 CMD.exe。

bcdedit /set hypervisorlaunchtype auto

关于虚拟机和 Hyper-V 的详细设置，可参考博文《Vmware Workstation16 出现 "VMware Workstation 不可恢复错误：(vcpu-1)"故障解决》。

安装 Bun

• 确保 WSL 系统（本文以 Ubuntu 为例）已安装 unzip 工具，否则在执行 Bun 安装时可能会报错。

error: unzip is required to install Bun (see: https://github.com/Jarred-Sumner/bun#unzip-is-required

使用 Terminal 打开 WSL，在 Ubuntu 系统中执行以下命令安装 unzip：

sudo apt-get install unzip

• 在 WSL 终端中输入以下命令进行安装：

 curl https://bun.sh/install | bash

若出现如下提示，则表明安装成功：

Bun was installed successfully to /root/.bun/bin/bun
Manually add the directory to your $HOME/.bashrc (or similar)
   BUN_INSTALL="/root/.bun"
   PATH="$BUN_INSTALL/bin:$PATH"

• 根据安装提示，需手动添加环境变量。

使用 vim 编辑器打开 .bashrc 配置文件。

vim /root/.bashrc

将以下环境变量配置追加至 .bashrc 文件末尾，保存后生效。

BUN_INSTALL="/root/.bun"
PATH="$BUN_INSTALL/bin:$PATH"

退出 WSL 并重新进入，验证安装是否成功。

bun -h

• 测试模块

利用 VS Code 的 WSL 扩展来管理 WSL 系统中的项目文件。

官方提供了详细教程《Get started using VSCode with WSL》供参考。

新建一个 http.js 文件，并编写如下代码：

// http.js
export default {
  port: 3000,
  fetch(request) {
    return new Response("Welcome to Bun!");
  },
};

启动 HTTP 服务。

bun run http.js

访问 http://localhost:3000，若看到 Welcome to Bun! 信息，则表示运行成功。

官网还提供了更多示例案例供尝试：Bun Examples。

总结

经过实际体验，该工具仍有待完善，尤其对于 Windows 用户而言，安装过程较为繁琐，官方最好能提供原生的 Windows 安装包。目前该版本仅为 Beta 阶段，适合用于学习研究，若要投入生产环境使用，尚需时日。毕竟 Node.js 已在前端开发领域广泛普及，而 Deno 的生态系统也在逐步建立中，前路依然漫长。

参考

Vmware Workstation16 出现 "VMware Workstation 不可恢复错误：(vcpu-1)"故障解决

Bun

以上就是 Windows 下安装 Bun 像 Node 或 Deno 的现代 JS 运行时的详细内容，更多关于 Windows 下安装 Bun 的资料请关注本站其它相关文章！