这次我们来看一个 JavaScript/TypeScript 运行时的新版本Bun 1.4。它不是一个新的 AI 模型而是一个旨在替代 Node.js 和 Deno 的工具链集成了包管理器、测试运行器和打包器。对于前端、全栈开发者或者任何需要快速构建、运行 JavaScript/TypeScript 项目的人来说它的核心吸引力在于“快”和“一体化”。Bun 1.4 版本带来了几个关键更新对 Windows 平台的原生支持、内置的 SQLite 客户端、以及一系列性能优化和错误修复。最值得关注的是它终于让 Windows 用户能像 macOS 和 Linux 用户一样通过官方安装器直接体验 Bun 的速度。同时内置 SQLite 意味着你可以不依赖任何外部 npm 包直接在 Bun 中操作数据库这对于构建原型、小型应用或需要轻量级数据存储的场景非常方便。本文将带你快速了解 Bun 1.4 的核心能力并完成从安装部署到功能验证的全过程。我们会重点关注如何在 Windows、macOS、Linux 上安装 Bun 1.4。如何利用其一体化工具链运行、安装、打包、测试提升开发效率。如何测试新的内置 SQLite 模块。如何排查常见的安装与运行问题特别是 Windows 上可能遇到的 AVX 指令集警告和内存错误。它的性能表现和资源占用情况。如果你正在寻找一个更快的 JavaScript 开发工具链或者对 Node.js 的某些性能瓶颈感到困扰那么 Bun 1.4 值得一试。1. 核心能力速览Bun 1.4 作为一个一体化的 JavaScript 运行时和工具包其核心能力可以概括为以下几点能力项说明项目类型JavaScript/TypeScript 运行时、包管理器、打包器、测试运行器一体化工具链。开源团队Jarred Sumner 及 Oven 团队开发。主要功能1.运行.js,.ts,.jsx,.tsx文件。2.包管理(bun install)替代npm,yarn,pnpm。3.打包(bun build)生成适用于 Bun、Node.js、浏览器的代码。4.测试运行(bun test)内置兼容 Jest 的测试运行器。5.内置 SQLite(import { Database } from bun:sqlite)。推荐硬件无特殊 GPU 要求。CPU 需支持 AVX 指令集2011年后的大部分 CPU 都支持否则在 Windows 上可能遇到警告或崩溃。内存占用运行时内存占用通常低于同等任务的 Node.js 进程具体取决于应用复杂度。包安装速度极快内存效率高。支持平台macOS(x64, Apple Silicon),Linux(x64, arm64),Windows(x64, 原生支持)。启动方式命令行直接调用 (bun run,bun install等)。是否支持 API本身是命令行工具但其运行时提供丰富的内置 API如Bun.file,Bun.serve,bun:sqlite。是否支持批量任务通过脚本 (bun run) 和强大的打包功能 (bun build) 支持批量构建和处理。适合场景快速原型开发、全栈应用、需要极速npm install的项目、工具链简化、轻量级服务端应用。2. 适用场景与使用边界Bun 的设计目标是提升 JavaScript 开发的整体体验它特别适合以下几类开发者和场景追求极致效率的开发者如果你厌倦了npm install的漫长等待Bun 的包管理器速度极快能显著缩短依赖安装时间。全栈或工具链开发者Bun 集成了运行、打包、测试无需在node,npm,webpack/vite,jest之间切换简化了项目配置。构建小型服务或脚本内置的Bun.serveAPI 和 SQLite 支持让你能快速搭建一个轻量级的 HTTP API 服务无需安装express和sqlite3包。Monorepo 项目Bun 的包管理器和 Workspaces 支持能高效处理多包项目的依赖。使用边界与注意事项生产环境谨慎评估虽然 Bun 日趋稳定但其生态成熟度仍落后于 Node.js。对于大型、复杂、依赖特定原生模块Node.js C Addons的企业级生产项目需进行充分测试。Node.js API 兼容性Bun 实现了大部分 Node.js API但并非 100% 兼容。某些深度依赖 Node.js 特定行为或冷门 API 的库可能无法直接运行。原生模块支持Bun 使用不同的底层技术JavaScriptCore因此为 Node.jsV8编译的 C 插件无法直接使用。需要寻找 Bun 原生版本或纯 JavaScript 替代品。社区与生态npm 上的包数量庞大但并非所有包都针对 Bun 优化或测试过。遇到问题时社区解决方案可能不如 Node.js 丰富。3. 环境准备与前置条件在安装 Bun 1.4 之前请确保你的系统满足以下基本条件。操作系统Windows 10/11(x64)已获得官方原生支持。macOS(10.13 x64 或 Apple Silicon)。Linux(x64, arm64)大多数主流发行版均可。系统依赖检查清单终端/命令行确保你有一个可用的终端Windows 上的 PowerShell、CMD 或 Windows TerminalmacOS 的 Terminal 或 iTerm2Linux 的 bash/zsh 等。CPU 指令集Windows 用户重点注意Bun 在 Windows 上需要 CPU 支持AVXAdvanced Vector Extensions指令集。2011年之后生产的 Intel Sandy Bridge 架构及之后的 CPU以及 AMD 推土机架构之后的 CPU 通常都支持。如果不支持运行时会出现警告并可能导致奇怪的崩溃。权限确保你有权限在系统或用户目录安装软件通常需要管理员/root权限进行全局安装用户目录安装则不需要。可选但推荐代码编辑器如 VSCode并安装 Bun 相关的语法高亮和工具扩展。网络环境安装过程需要从 GitHub 等源下载确保网络通畅。4. 安装部署与启动方式Bun 提供了多种安装方式选择最适合你的一种。4.1 使用官方安装脚本推荐这是最快捷的安装方式适用于 macOS、Linux 和 Windows通过 WSL 或 PowerShell。打开你的终端执行以下命令# 使用 curl curl -fsSL https://bun.sh/install | bash # 或者使用 wget wget -qO- https://bun.sh/install | bash脚本会自动检测你的系统架构下载最新的 Bun 二进制文件并将其安装到~/.bun/bin目录下。安装完成后脚本会提示你将~/.bun/bin添加到你的PATH环境变量中。对于 Windows 用户PowerShell在管理员身份运行的 PowerShell 中执行powershell -c irm bun.sh/install.ps1 | iex这个 PowerShell 脚本会处理 Windows 上的原生安装。4.2 使用包管理器安装macOS (Homebrew):brew tap oven-sh/bun brew install bunLinux (Linuxbrew):brew tap oven-sh/bun brew install bun注意Windows 的包管理器如 Chocolatey, Scoop可能尚未提供最新的 1.4 版本建议优先使用官方安装脚本。4.3 验证安装安装完成后重启你的终端或者手动执行source ~/.bashrc(或~/.zshrc,~/.profile) 来重新加载环境变量。然后运行bun --version如果输出版本号例如1.4.0则说明安装成功。4.4 项目初始化与启动创建一个新的 Bun 项目非常简单# 1. 创建一个新目录并进入 mkdir my-bun-app cd my-bun-app # 2. 初始化项目会创建 package.json bun init # 按照提示填写项目信息或一路回车使用默认值 # 3. 安装依赖例如安装一个流行的 web 框架 Elysia bun add elysia # 4. 创建一个简单的服务器文件 index.ts echo import { Elysia } from elysia; const app new Elysia() .get(/, () Hello from Bun 1.4!) .listen(3000); console.log( Server is running at http://localhost:${app.server?.port}); index.ts # 5. 运行你的 TypeScript 服务器无需额外编译 bun run index.ts现在打开浏览器访问http://localhost:3000你应该能看到 “Hello from Bun 1.4!”。5. 功能测试与效果验证让我们针对 Bun 1.4 的几个核心特性进行实际测试。5.1 测试一包管理器速度 (bun install)这是 Bun 的招牌功能。我们可以用一个现有项目来对比。准备测试环境找一个依赖较多的现有 Node.js 项目或者创建一个临时项目并添加一些依赖如bun add react react-dom types/react types/react-dom。清除缓存可选为了公平对比可以先清除 npm/bun 的缓存 (npm cache clean -f,bun pm cache rm)。执行安装使用npm install或yarn install记录时间。删除node_modules和package-lock.json/yarn.lock。使用bun install记录时间。预期结果在大多数情况下bun install的完成时间会显著少于传统的包管理器尤其是冷启动安装时。速度提升来自其并发的下载和优化的解压算法。5.2 测试二内置 SQLite 模块 (bun:sqlite)这是 1.4 版本的一个重要新特性。我们编写一个简单的脚本来测试。创建一个文件sqlite-test.ts// 导入内置的 sqlite 模块 import { Database } from bun:sqlite; // 创建或打开一个数据库内存数据库 const db new Database(:memory:); // 执行 SQL创建一个 users 表 db.run( CREATE TABLE IF NOT EXISTS users ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, email TEXT NOT NULL UNIQUE ); ); // 插入数据 const insert db.prepare(INSERT INTO users (name, email) VALUES (?, ?)); insert.run(Alice, aliceexample.com); insert.run(Bob, bobexample.com); // 查询数据 const query db.prepare(SELECT * FROM users); const users query.all(); console.log(All users:, users); // 参数化查询 const userQuery db.prepare(SELECT * FROM users WHERE name ?); const alice userQuery.get(Alice); console.log(User Alice:, alice); // 关闭数据库连接对于内存数据库进程结束会自动关闭 db.close();运行这个脚本bun run sqlite-test.ts预期结果脚本应成功执行并在控制台打印出插入的两位用户信息。这证明了 Bun 内置的 SQLite 模块工作正常无需安装sqlite3npm 包。5.3 测试三TypeScript 原生运行与打包 (bun runbun build)Bun 内置了 TypeScript 编译器可以直接运行.ts文件。直接运行 TS上面的index.ts和sqlite-test.ts已经验证了这一点。无需ts-node或先编译成 JS。测试打包功能创建一个包含简单模块的文件。math.ts:export function add(a: number, b: number): number { return a b; } export const PI 3.14159;main.ts:import { add, PI } from ./math; console.log(2 3 ${add(2, 3)}); console.log(PI is approximately ${PI});使用 Bun 打包成一个单独的、适用于 Node.js 的 JS 文件bun build ./main.ts --outdir ./dist --target node查看dist/main.js文件它应该是一个打包并优化过的 JavaScript 文件可以在 Node.js 环境中直接运行node ./dist/main.js预期结果node ./dist/main.js应输出与bun run main.ts相同的结果。这验证了 Bun 的打包器能正确处理 TypeScript 模块和依赖。5.4 测试四测试运行器 (bun test)Bun 的测试运行器兼容 Jest 的语法。创建一个测试文件math.test.tsimport { expect, test } from bun:test; import { add } from ./math; test(add function, () { expect(add(1, 2)).toBe(3); expect(add(-1, 5)).toBe(4); expect(add(0, 0)).toBe(0); });运行测试bun test预期结果你应该看到测试通过的输出显示测试套件和用例都成功了。这比启动 Jest 通常要快得多。6. 接口 API 与批量任务虽然 Bun 本身不是一个 HTTP API 服务但它提供了创建 API 服务的内置 API (Bun.serve)并且其命令行工具非常适合处理批量任务。6.1 使用Bun.serve创建 HTTP API创建一个简单的 JSON API 服务api-server.tsconst server Bun.serve({ port: 3001, async fetch(request) { const url new URL(request.url); // 定义路由 if (url.pathname /api/hello) { return new Response(JSON.stringify({ message: Hello from Bun API! }), { headers: { Content-Type: application/json }, }); } if (url.pathname /api/echo request.method POST) { const body await request.json(); return new Response(JSON.stringify({ received: body }), { headers: { Content-Type: application/json }, }); } return new Response(Not Found, { status: 404 }); }, }); console.log(API Server listening on http://localhost:${server.port});运行它bun run api-server.ts。使用 curl 测试 API# GET 请求 curl http://localhost:3001/api/hello # POST 请求 curl -X POST http://localhost:3001/api/echo \ -H Content-Type: application/json \ -d {name:Bun, version:1.4}预期结果GET 请求返回{message:Hello from Bun API!}POST 请求回显你发送的 JSON 数据。6.2 批量任务处理Bun 的脚本执行能力和文件系统 API (Bun.file) 使其擅长批量任务。例如批量重命名一个目录下的图片文件import { readdir, rename } from fs/promises; import { join } from path; async function batchRenameImages(dirPath: string, prefix: string img_) { try { const files await readdir(dirPath, { withFileTypes: true }); let count 1; for (const file of files) { if (file.isFile() /\.(jpg|jpeg|png|gif)$/i.test(file.name)) { const oldPath join(dirPath, file.name); const ext file.name.split(.).pop(); const newName ${prefix}${count.toString().padStart(3, 0)}.${ext}; const newPath join(dirPath, newName); await rename(oldPath, newPath); console.log(Renamed: ${file.name} - ${newName}); count; } } console.log(Batch rename completed. Total ${count-1} files processed.); } catch (error) { console.error(Error during batch rename:, error); } } // 使用示例处理当前目录下的 images 文件夹 batchRenameImages(./images);将此脚本保存为batch-rename.ts并在包含images文件夹的目录下运行bun run batch-rename.ts。注意操作文件前请务必备份7. 资源占用与性能观察Bun 的性能优势主要体现在启动时间、包安装速度和某些操作如文件读写上。如何观察资源占用时间测量使用time命令Unix-like系统或 Measure-Command (PowerShell) 来对比命令执行时间。# Linux/macOS time bun install time npm install # Windows PowerShell Measure-Command { bun install } Measure-Command { npm install }内存占用在任务管理器Windows、活动监视器macOS或htopLinux中观察bun进程的内存使用情况。运行一个简单的 HTTP 服务器与使用node运行类似功能的服务器进行对比。冷/热启动多次运行同一个脚本 (bun run script.ts)首次运行为冷启动后续运行为热启动利用缓存观察速度差异。性能影响因素项目规模依赖项越多、代码量越大Bun 在安装和打包时的速度优势可能越明显。磁盘 I/OBun 的包安装大量使用并行 I/O 和高效的缓存在 SSD 上表现更佳。网络状况首次安装包时需要从网络下载。一个简单的性能对比测试创建一个简单的循环计算脚本perf-test.jsconsole.time(calculation); let sum 0; for (let i 0; i 1e9; i) { sum i; } console.timeEnd(calculation); console.log(Sum (partial):, sum);分别用 Node.js 和 Bun 运行node perf-test.js bun run perf-test.js注意纯计算性能受 JavaScript 引擎V8 vs JavaScriptCore影响结果可能因场景而异。Bun 的优势更多体现在工具链和 I/O 密集型任务上。8. 常见问题与排查方法以下是使用 Bun尤其是在 Windows 上可能遇到的常见问题及解决方法。问题现象可能原因排查方式解决方案安装失败网络错误网络连接问题无法访问 GitHub 或 Bun 的下载源。检查网络尝试使用curl -I https://bun.sh或浏览器访问。1. 使用代理如需。2. 尝试使用包管理器如 Homebrew安装。3. 手动下载二进制文件并配置 PATH。运行bun --version提示“命令未找到”~/.bun/bin未添加到系统的 PATH 环境变量。执行echo $PATH(Unix) 或$env:Path(PowerShell) 查看是否包含 Bun 的路径。根据安装脚本的提示将~/.bun/bin添加到你的 shell 配置文件.bashrc,.zshrc,profile并重启终端。Windows 上运行时出现警告warn: cpu lacks avx support, strange crashes may occur. reinstall bun or use ...你的 CPU 不支持 AVX 指令集。确认 CPU 型号。可以使用 CPU-Z 等工具查看指令集支持。1.最佳方案如果硬件允许考虑更换支持 AVX 的 CPU。2.临时方案警告可能不影响简单使用但复杂操作可能崩溃。可以尝试使用 WSL2Linux 子系统在 Linux 环境下运行 Bun通常可以规避此问题。Windows 上出现内存错误或崩溃可能与 AVX 不支持、特定库不兼容或 Bun 本身在特定 Windows 版本的 Bug 有关。查看崩溃时的错误信息。尝试在 WSL2 中运行相同的操作。1. 首先确保已安装最新的 Bun 版本 (bun upgrade)。2. 在 WSL2Ubuntu等中安装并使用 Bun这是目前 Windows 上最稳定的方案。3. 向 Bun 的 GitHub 仓库提交 Issue附上详细的重现步骤和错误信息。bun install后项目运行报错提示模块找不到1.node_modules结构可能与传统 npm 不同。2. 包可能不完全兼容 Bun。检查bun.lockb文件是否存在。尝试删除node_modules和bun.lockb重新运行bun install。1. 确保使用bun run来运行脚本而不是node。2. 对于不兼容的包可以尝试寻找替代品或使用bun install --backendnodejs_compat标志如果可用来尝试兼容模式安装。3. 在 Bun 的 Discord 或 GitHub 讨论区搜索该包是否已知有问题。运行 TypeScript 文件时语法报错Bun 内置的 TypeScript 版本或配置可能与项目预期不符。检查项目根目录是否有tsconfig.json。对比 Bun 支持的 TS 特性。1. 确保tsconfig.json配置正确。2. 可以尝试使用bun --bun标志来强制使用 Bun 的运行时如果默认不是。3. 复杂的 TS 配置或实验性语法可能导致问题尝试简化。端口已被占用另一个进程正在使用 Bun 服务试图监听的端口如 3000。使用 netstat -anofindstr :3000(Windows) 或lsof -i :3000 (Unix) 查找占用进程。9. 最佳实践与使用建议为了更顺畅地使用 Bun 1.4这里有一些建议从新项目或非核心项目开始如果你是 Bun 新手建议在一个全新的个人项目或公司内部工具项目中尝试而不是直接迁移大型核心生产项目。善用bun init它创建的package.json中scripts默认使用bun run这是一个好习惯。理解bun.lockbBun 使用二进制的bun.lockb文件来锁定依赖版本而不是package-lock.json或yarn.lock。请将其提交到版本控制。注意全局包使用bun add -g package安装全局工具时它们会被安装到 Bun 的全局目录可能与 npm 的全局包隔离。利用内置 API尽可能使用 Bun 的内置 API如Bun.file,Bun.serve,bun:sqlite它们通常比安装第三方 npm 包性能更好且无需管理依赖。性能分析Bun 提供了--hot标志用于开发时的热重载以及--smol标志来减少内存使用。在合适的场景下使用它们。保持更新Bun 迭代很快定期使用bun upgrade获取最新版本、性能改进和 Bug 修复。社区与支持遇到问题时查阅 官方文档 或加入 Bun 的 Discord 社区 那里非常活跃。备份与回滚在尝试将现有 Node.js 项目迁移到 Bun 前确保你有完整的备份包括node_modules。如果遇到无法解决的问题可以轻松回退到npm或yarn。10. 总结与下一步Bun 1.4 版本特别是其对 Windows 的原生支持大大降低了这个高性能工具链的入门门槛。它的核心价值在于一体化和速度将运行、安装、打包、测试等多个环节的效率提升到了一个全新的水平。最值得尝试的点极速的依赖安装如果你受够了漫长的npm installbun install会带来惊喜。开箱即用的 TypeScript 支持无需配置ts-node或构建步骤直接运行.ts文件。内置的 SQLite 数据库为快速原型开发和小型应用提供了极其便利的数据存储方案。最先应该验证的功能在你的开发机上按照本文的步骤完成安装并运行sqlite-test.ts和api-server.ts两个示例。这能在几分钟内让你感受到 Bun 的直接和高效。最容易踩的坑对于Windows 用户CPU 是否支持AVX指令集是首要检查项。如果遇到警告或崩溃优先考虑在WSL2环境中使用 Bun这是当前最稳定的方案。后续探索方向深入框架集成尝试将 Bun 与新兴的 Web 框架如 Elysia、Hono结合构建全栈应用。探索打包优化使用bun build对你的前端或库项目进行打包对比其输出大小和性能。参与社区关注 Bun 的 GitHub 仓库和 Discord了解其最新动态和最佳实践。Bun 正在快速成长虽然生态尚在追赶 Node.js但其在开发体验上的优势已经非常明显。对于追求效率的开发者而言现在正是将其纳入技术栈进行探索和评估的好时机。建议收藏本文作为你上手 Bun 1.4 的实操指南和排错手册。 Bun 1.4 一体化工具链：极速开发与内置 SQLite 实战指南
这次我们来看一个 JavaScript/TypeScript 运行时的新版本Bun 1.4。它不是一个新的 AI 模型而是一个旨在替代 Node.js 和 Deno 的工具链集成了包管理器、测试运行器和打包器。对于前端、全栈开发者或者任何需要快速构建、运行 JavaScript/TypeScript 项目的人来说它的核心吸引力在于“快”和“一体化”。Bun 1.4 版本带来了几个关键更新对 Windows 平台的原生支持、内置的 SQLite 客户端、以及一系列性能优化和错误修复。最值得关注的是它终于让 Windows 用户能像 macOS 和 Linux 用户一样通过官方安装器直接体验 Bun 的速度。同时内置 SQLite 意味着你可以不依赖任何外部 npm 包直接在 Bun 中操作数据库这对于构建原型、小型应用或需要轻量级数据存储的场景非常方便。本文将带你快速了解 Bun 1.4 的核心能力并完成从安装部署到功能验证的全过程。我们会重点关注如何在 Windows、macOS、Linux 上安装 Bun 1.4。如何利用其一体化工具链运行、安装、打包、测试提升开发效率。如何测试新的内置 SQLite 模块。如何排查常见的安装与运行问题特别是 Windows 上可能遇到的 AVX 指令集警告和内存错误。它的性能表现和资源占用情况。如果你正在寻找一个更快的 JavaScript 开发工具链或者对 Node.js 的某些性能瓶颈感到困扰那么 Bun 1.4 值得一试。1. 核心能力速览Bun 1.4 作为一个一体化的 JavaScript 运行时和工具包其核心能力可以概括为以下几点能力项说明项目类型JavaScript/TypeScript 运行时、包管理器、打包器、测试运行器一体化工具链。开源团队Jarred Sumner 及 Oven 团队开发。主要功能1.运行.js,.ts,.jsx,.tsx文件。2.包管理(bun install)替代npm,yarn,pnpm。3.打包(bun build)生成适用于 Bun、Node.js、浏览器的代码。4.测试运行(bun test)内置兼容 Jest 的测试运行器。5.内置 SQLite(import { Database } from bun:sqlite)。推荐硬件无特殊 GPU 要求。CPU 需支持 AVX 指令集2011年后的大部分 CPU 都支持否则在 Windows 上可能遇到警告或崩溃。内存占用运行时内存占用通常低于同等任务的 Node.js 进程具体取决于应用复杂度。包安装速度极快内存效率高。支持平台macOS(x64, Apple Silicon),Linux(x64, arm64),Windows(x64, 原生支持)。启动方式命令行直接调用 (bun run,bun install等)。是否支持 API本身是命令行工具但其运行时提供丰富的内置 API如Bun.file,Bun.serve,bun:sqlite。是否支持批量任务通过脚本 (bun run) 和强大的打包功能 (bun build) 支持批量构建和处理。适合场景快速原型开发、全栈应用、需要极速npm install的项目、工具链简化、轻量级服务端应用。2. 适用场景与使用边界Bun 的设计目标是提升 JavaScript 开发的整体体验它特别适合以下几类开发者和场景追求极致效率的开发者如果你厌倦了npm install的漫长等待Bun 的包管理器速度极快能显著缩短依赖安装时间。全栈或工具链开发者Bun 集成了运行、打包、测试无需在node,npm,webpack/vite,jest之间切换简化了项目配置。构建小型服务或脚本内置的Bun.serveAPI 和 SQLite 支持让你能快速搭建一个轻量级的 HTTP API 服务无需安装express和sqlite3包。Monorepo 项目Bun 的包管理器和 Workspaces 支持能高效处理多包项目的依赖。使用边界与注意事项生产环境谨慎评估虽然 Bun 日趋稳定但其生态成熟度仍落后于 Node.js。对于大型、复杂、依赖特定原生模块Node.js C Addons的企业级生产项目需进行充分测试。Node.js API 兼容性Bun 实现了大部分 Node.js API但并非 100% 兼容。某些深度依赖 Node.js 特定行为或冷门 API 的库可能无法直接运行。原生模块支持Bun 使用不同的底层技术JavaScriptCore因此为 Node.jsV8编译的 C 插件无法直接使用。需要寻找 Bun 原生版本或纯 JavaScript 替代品。社区与生态npm 上的包数量庞大但并非所有包都针对 Bun 优化或测试过。遇到问题时社区解决方案可能不如 Node.js 丰富。3. 环境准备与前置条件在安装 Bun 1.4 之前请确保你的系统满足以下基本条件。操作系统Windows 10/11(x64)已获得官方原生支持。macOS(10.13 x64 或 Apple Silicon)。Linux(x64, arm64)大多数主流发行版均可。系统依赖检查清单终端/命令行确保你有一个可用的终端Windows 上的 PowerShell、CMD 或 Windows TerminalmacOS 的 Terminal 或 iTerm2Linux 的 bash/zsh 等。CPU 指令集Windows 用户重点注意Bun 在 Windows 上需要 CPU 支持AVXAdvanced Vector Extensions指令集。2011年之后生产的 Intel Sandy Bridge 架构及之后的 CPU以及 AMD 推土机架构之后的 CPU 通常都支持。如果不支持运行时会出现警告并可能导致奇怪的崩溃。权限确保你有权限在系统或用户目录安装软件通常需要管理员/root权限进行全局安装用户目录安装则不需要。可选但推荐代码编辑器如 VSCode并安装 Bun 相关的语法高亮和工具扩展。网络环境安装过程需要从 GitHub 等源下载确保网络通畅。4. 安装部署与启动方式Bun 提供了多种安装方式选择最适合你的一种。4.1 使用官方安装脚本推荐这是最快捷的安装方式适用于 macOS、Linux 和 Windows通过 WSL 或 PowerShell。打开你的终端执行以下命令# 使用 curl curl -fsSL https://bun.sh/install | bash # 或者使用 wget wget -qO- https://bun.sh/install | bash脚本会自动检测你的系统架构下载最新的 Bun 二进制文件并将其安装到~/.bun/bin目录下。安装完成后脚本会提示你将~/.bun/bin添加到你的PATH环境变量中。对于 Windows 用户PowerShell在管理员身份运行的 PowerShell 中执行powershell -c irm bun.sh/install.ps1 | iex这个 PowerShell 脚本会处理 Windows 上的原生安装。4.2 使用包管理器安装macOS (Homebrew):brew tap oven-sh/bun brew install bunLinux (Linuxbrew):brew tap oven-sh/bun brew install bun注意Windows 的包管理器如 Chocolatey, Scoop可能尚未提供最新的 1.4 版本建议优先使用官方安装脚本。4.3 验证安装安装完成后重启你的终端或者手动执行source ~/.bashrc(或~/.zshrc,~/.profile) 来重新加载环境变量。然后运行bun --version如果输出版本号例如1.4.0则说明安装成功。4.4 项目初始化与启动创建一个新的 Bun 项目非常简单# 1. 创建一个新目录并进入 mkdir my-bun-app cd my-bun-app # 2. 初始化项目会创建 package.json bun init # 按照提示填写项目信息或一路回车使用默认值 # 3. 安装依赖例如安装一个流行的 web 框架 Elysia bun add elysia # 4. 创建一个简单的服务器文件 index.ts echo import { Elysia } from elysia; const app new Elysia() .get(/, () Hello from Bun 1.4!) .listen(3000); console.log( Server is running at http://localhost:${app.server?.port}); index.ts # 5. 运行你的 TypeScript 服务器无需额外编译 bun run index.ts现在打开浏览器访问http://localhost:3000你应该能看到 “Hello from Bun 1.4!”。5. 功能测试与效果验证让我们针对 Bun 1.4 的几个核心特性进行实际测试。5.1 测试一包管理器速度 (bun install)这是 Bun 的招牌功能。我们可以用一个现有项目来对比。准备测试环境找一个依赖较多的现有 Node.js 项目或者创建一个临时项目并添加一些依赖如bun add react react-dom types/react types/react-dom。清除缓存可选为了公平对比可以先清除 npm/bun 的缓存 (npm cache clean -f,bun pm cache rm)。执行安装使用npm install或yarn install记录时间。删除node_modules和package-lock.json/yarn.lock。使用bun install记录时间。预期结果在大多数情况下bun install的完成时间会显著少于传统的包管理器尤其是冷启动安装时。速度提升来自其并发的下载和优化的解压算法。5.2 测试二内置 SQLite 模块 (bun:sqlite)这是 1.4 版本的一个重要新特性。我们编写一个简单的脚本来测试。创建一个文件sqlite-test.ts// 导入内置的 sqlite 模块 import { Database } from bun:sqlite; // 创建或打开一个数据库内存数据库 const db new Database(:memory:); // 执行 SQL创建一个 users 表 db.run( CREATE TABLE IF NOT EXISTS users ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, email TEXT NOT NULL UNIQUE ); ); // 插入数据 const insert db.prepare(INSERT INTO users (name, email) VALUES (?, ?)); insert.run(Alice, aliceexample.com); insert.run(Bob, bobexample.com); // 查询数据 const query db.prepare(SELECT * FROM users); const users query.all(); console.log(All users:, users); // 参数化查询 const userQuery db.prepare(SELECT * FROM users WHERE name ?); const alice userQuery.get(Alice); console.log(User Alice:, alice); // 关闭数据库连接对于内存数据库进程结束会自动关闭 db.close();运行这个脚本bun run sqlite-test.ts预期结果脚本应成功执行并在控制台打印出插入的两位用户信息。这证明了 Bun 内置的 SQLite 模块工作正常无需安装sqlite3npm 包。5.3 测试三TypeScript 原生运行与打包 (bun runbun build)Bun 内置了 TypeScript 编译器可以直接运行.ts文件。直接运行 TS上面的index.ts和sqlite-test.ts已经验证了这一点。无需ts-node或先编译成 JS。测试打包功能创建一个包含简单模块的文件。math.ts:export function add(a: number, b: number): number { return a b; } export const PI 3.14159;main.ts:import { add, PI } from ./math; console.log(2 3 ${add(2, 3)}); console.log(PI is approximately ${PI});使用 Bun 打包成一个单独的、适用于 Node.js 的 JS 文件bun build ./main.ts --outdir ./dist --target node查看dist/main.js文件它应该是一个打包并优化过的 JavaScript 文件可以在 Node.js 环境中直接运行node ./dist/main.js预期结果node ./dist/main.js应输出与bun run main.ts相同的结果。这验证了 Bun 的打包器能正确处理 TypeScript 模块和依赖。5.4 测试四测试运行器 (bun test)Bun 的测试运行器兼容 Jest 的语法。创建一个测试文件math.test.tsimport { expect, test } from bun:test; import { add } from ./math; test(add function, () { expect(add(1, 2)).toBe(3); expect(add(-1, 5)).toBe(4); expect(add(0, 0)).toBe(0); });运行测试bun test预期结果你应该看到测试通过的输出显示测试套件和用例都成功了。这比启动 Jest 通常要快得多。6. 接口 API 与批量任务虽然 Bun 本身不是一个 HTTP API 服务但它提供了创建 API 服务的内置 API (Bun.serve)并且其命令行工具非常适合处理批量任务。6.1 使用Bun.serve创建 HTTP API创建一个简单的 JSON API 服务api-server.tsconst server Bun.serve({ port: 3001, async fetch(request) { const url new URL(request.url); // 定义路由 if (url.pathname /api/hello) { return new Response(JSON.stringify({ message: Hello from Bun API! }), { headers: { Content-Type: application/json }, }); } if (url.pathname /api/echo request.method POST) { const body await request.json(); return new Response(JSON.stringify({ received: body }), { headers: { Content-Type: application/json }, }); } return new Response(Not Found, { status: 404 }); }, }); console.log(API Server listening on http://localhost:${server.port});运行它bun run api-server.ts。使用 curl 测试 API# GET 请求 curl http://localhost:3001/api/hello # POST 请求 curl -X POST http://localhost:3001/api/echo \ -H Content-Type: application/json \ -d {name:Bun, version:1.4}预期结果GET 请求返回{message:Hello from Bun API!}POST 请求回显你发送的 JSON 数据。6.2 批量任务处理Bun 的脚本执行能力和文件系统 API (Bun.file) 使其擅长批量任务。例如批量重命名一个目录下的图片文件import { readdir, rename } from fs/promises; import { join } from path; async function batchRenameImages(dirPath: string, prefix: string img_) { try { const files await readdir(dirPath, { withFileTypes: true }); let count 1; for (const file of files) { if (file.isFile() /\.(jpg|jpeg|png|gif)$/i.test(file.name)) { const oldPath join(dirPath, file.name); const ext file.name.split(.).pop(); const newName ${prefix}${count.toString().padStart(3, 0)}.${ext}; const newPath join(dirPath, newName); await rename(oldPath, newPath); console.log(Renamed: ${file.name} - ${newName}); count; } } console.log(Batch rename completed. Total ${count-1} files processed.); } catch (error) { console.error(Error during batch rename:, error); } } // 使用示例处理当前目录下的 images 文件夹 batchRenameImages(./images);将此脚本保存为batch-rename.ts并在包含images文件夹的目录下运行bun run batch-rename.ts。注意操作文件前请务必备份7. 资源占用与性能观察Bun 的性能优势主要体现在启动时间、包安装速度和某些操作如文件读写上。如何观察资源占用时间测量使用time命令Unix-like系统或 Measure-Command (PowerShell) 来对比命令执行时间。# Linux/macOS time bun install time npm install # Windows PowerShell Measure-Command { bun install } Measure-Command { npm install }内存占用在任务管理器Windows、活动监视器macOS或htopLinux中观察bun进程的内存使用情况。运行一个简单的 HTTP 服务器与使用node运行类似功能的服务器进行对比。冷/热启动多次运行同一个脚本 (bun run script.ts)首次运行为冷启动后续运行为热启动利用缓存观察速度差异。性能影响因素项目规模依赖项越多、代码量越大Bun 在安装和打包时的速度优势可能越明显。磁盘 I/OBun 的包安装大量使用并行 I/O 和高效的缓存在 SSD 上表现更佳。网络状况首次安装包时需要从网络下载。一个简单的性能对比测试创建一个简单的循环计算脚本perf-test.jsconsole.time(calculation); let sum 0; for (let i 0; i 1e9; i) { sum i; } console.timeEnd(calculation); console.log(Sum (partial):, sum);分别用 Node.js 和 Bun 运行node perf-test.js bun run perf-test.js注意纯计算性能受 JavaScript 引擎V8 vs JavaScriptCore影响结果可能因场景而异。Bun 的优势更多体现在工具链和 I/O 密集型任务上。8. 常见问题与排查方法以下是使用 Bun尤其是在 Windows 上可能遇到的常见问题及解决方法。问题现象可能原因排查方式解决方案安装失败网络错误网络连接问题无法访问 GitHub 或 Bun 的下载源。检查网络尝试使用curl -I https://bun.sh或浏览器访问。1. 使用代理如需。2. 尝试使用包管理器如 Homebrew安装。3. 手动下载二进制文件并配置 PATH。运行bun --version提示“命令未找到”~/.bun/bin未添加到系统的 PATH 环境变量。执行echo $PATH(Unix) 或$env:Path(PowerShell) 查看是否包含 Bun 的路径。根据安装脚本的提示将~/.bun/bin添加到你的 shell 配置文件.bashrc,.zshrc,profile并重启终端。Windows 上运行时出现警告warn: cpu lacks avx support, strange crashes may occur. reinstall bun or use ...你的 CPU 不支持 AVX 指令集。确认 CPU 型号。可以使用 CPU-Z 等工具查看指令集支持。1.最佳方案如果硬件允许考虑更换支持 AVX 的 CPU。2.临时方案警告可能不影响简单使用但复杂操作可能崩溃。可以尝试使用 WSL2Linux 子系统在 Linux 环境下运行 Bun通常可以规避此问题。Windows 上出现内存错误或崩溃可能与 AVX 不支持、特定库不兼容或 Bun 本身在特定 Windows 版本的 Bug 有关。查看崩溃时的错误信息。尝试在 WSL2 中运行相同的操作。1. 首先确保已安装最新的 Bun 版本 (bun upgrade)。2. 在 WSL2Ubuntu等中安装并使用 Bun这是目前 Windows 上最稳定的方案。3. 向 Bun 的 GitHub 仓库提交 Issue附上详细的重现步骤和错误信息。bun install后项目运行报错提示模块找不到1.node_modules结构可能与传统 npm 不同。2. 包可能不完全兼容 Bun。检查bun.lockb文件是否存在。尝试删除node_modules和bun.lockb重新运行bun install。1. 确保使用bun run来运行脚本而不是node。2. 对于不兼容的包可以尝试寻找替代品或使用bun install --backendnodejs_compat标志如果可用来尝试兼容模式安装。3. 在 Bun 的 Discord 或 GitHub 讨论区搜索该包是否已知有问题。运行 TypeScript 文件时语法报错Bun 内置的 TypeScript 版本或配置可能与项目预期不符。检查项目根目录是否有tsconfig.json。对比 Bun 支持的 TS 特性。1. 确保tsconfig.json配置正确。2. 可以尝试使用bun --bun标志来强制使用 Bun 的运行时如果默认不是。3. 复杂的 TS 配置或实验性语法可能导致问题尝试简化。端口已被占用另一个进程正在使用 Bun 服务试图监听的端口如 3000。使用 netstat -anofindstr :3000(Windows) 或lsof -i :3000 (Unix) 查找占用进程。9. 最佳实践与使用建议为了更顺畅地使用 Bun 1.4这里有一些建议从新项目或非核心项目开始如果你是 Bun 新手建议在一个全新的个人项目或公司内部工具项目中尝试而不是直接迁移大型核心生产项目。善用bun init它创建的package.json中scripts默认使用bun run这是一个好习惯。理解bun.lockbBun 使用二进制的bun.lockb文件来锁定依赖版本而不是package-lock.json或yarn.lock。请将其提交到版本控制。注意全局包使用bun add -g package安装全局工具时它们会被安装到 Bun 的全局目录可能与 npm 的全局包隔离。利用内置 API尽可能使用 Bun 的内置 API如Bun.file,Bun.serve,bun:sqlite它们通常比安装第三方 npm 包性能更好且无需管理依赖。性能分析Bun 提供了--hot标志用于开发时的热重载以及--smol标志来减少内存使用。在合适的场景下使用它们。保持更新Bun 迭代很快定期使用bun upgrade获取最新版本、性能改进和 Bug 修复。社区与支持遇到问题时查阅 官方文档 或加入 Bun 的 Discord 社区 那里非常活跃。备份与回滚在尝试将现有 Node.js 项目迁移到 Bun 前确保你有完整的备份包括node_modules。如果遇到无法解决的问题可以轻松回退到npm或yarn。10. 总结与下一步Bun 1.4 版本特别是其对 Windows 的原生支持大大降低了这个高性能工具链的入门门槛。它的核心价值在于一体化和速度将运行、安装、打包、测试等多个环节的效率提升到了一个全新的水平。最值得尝试的点极速的依赖安装如果你受够了漫长的npm installbun install会带来惊喜。开箱即用的 TypeScript 支持无需配置ts-node或构建步骤直接运行.ts文件。内置的 SQLite 数据库为快速原型开发和小型应用提供了极其便利的数据存储方案。最先应该验证的功能在你的开发机上按照本文的步骤完成安装并运行sqlite-test.ts和api-server.ts两个示例。这能在几分钟内让你感受到 Bun 的直接和高效。最容易踩的坑对于Windows 用户CPU 是否支持AVX指令集是首要检查项。如果遇到警告或崩溃优先考虑在WSL2环境中使用 Bun这是当前最稳定的方案。后续探索方向深入框架集成尝试将 Bun 与新兴的 Web 框架如 Elysia、Hono结合构建全栈应用。探索打包优化使用bun build对你的前端或库项目进行打包对比其输出大小和性能。参与社区关注 Bun 的 GitHub 仓库和 Discord了解其最新动态和最佳实践。Bun 正在快速成长虽然生态尚在追赶 Node.js但其在开发体验上的优势已经非常明显。对于追求效率的开发者而言现在正是将其纳入技术栈进行探索和评估的好时机。建议收藏本文作为你上手 Bun 1.4 的实操指南和排错手册。