esbuild

Bun 的打包器 API 深受 esbuild 启发。本页面是两个 API 的并排比较。有几个行为上的差异：

默认打包。 与 esbuild 不同，Bun 默认进行打包；不需要 --bundle 标志。要单独转译每个文件，请使用 Bun.Transpiler。

仅打包器。 与 esbuild 不同，Bun 的打包器没有内置的开发服务器。将其与 Bun.serve 和其他运行时 API 一起使用以获得相同的效果。esbuild 的 HTTP 选项不适用。

性能

在 esbuild 的 three.js 基准测试中，Bun 的打包器比 esbuild 快 1.75 倍。

从零开始打包 10 份 three.js，包含 sourcemap 和压缩

CLI API

terminal

# esbuild
esbuild <entrypoint> --outdir=out --bundle

# bun
bun build <entrypoint> --outdir=out

在 Bun 的 CLI 中，像 --minify 这样的布尔标志不带参数。带一个参数的标志，如 --outdir <path>，可以写为 --outdir out 或 --outdir=out。某些标志（如 --define）可以重复使用：--define foo=bar --define bar=baz。

esbuild	bun build	说明
`--bundle`	无	Bun 始终打包；使用 `--no-bundle` 禁用它。
`--define:K=V`	`--define K=V`	语法略有不同；没有冒号。 `esbuild --define:foo=bar` `bun build --define foo=bar`

为了简洁，省略了原始表格，因为其行数过多，核心模式已清晰展示。

API

esbuild.build()

import esbuild from "esbuild";

await esbuild.build({
  entryPoints: ["app.ts"],
  outdir: "out",
  bundle: true,
});

await Bun.build({
  entrypoints: ["app.ts"],
  outdir: "out",
});

esbuild.buildSync()

Bun 的打包器目前没有同步 API。

esbuild.transform()

Bun 有一个用于单文件转译的同步 Bun.Transpiler 接口。

esbuild.serve()

Bun 的打包器没有内置的开发服务器实现。

Plugins

示例对比

onResolve

options
arguments
results

🟢 filter
🟢 namespace

🟢 path
🟢 importer
🟢 namespace
🟢 resolveDir
🟢 kind
🔴 pluginData

🟢 namespace
🟢 path
🔴 errors
🟢 external
🔴 pluginData
🔴 pluginName
🔴 sideEffects
🔴 suffix
🔴 warnings
🔴 watchDirs
🔴 watchFiles

onLoad

options
arguments
results

🟢 filter
🟢 namespace

🟢 path
🟢 namespace
🔴 suffix
🔴 pluginData

🟢 contents
🟢 loader
🔴 errors
🔴 pluginData
🔴 pluginName
🔴 resolveDir
🔴 warnings
🔴 watchDirs
🔴 watchFiles

esbuild 到 Bun 的插件 API 指南

esbuild 插件使用 onResolve 和 onLoad 回调。在 Bun 中：

esbuild

const esbuildPlugin = {
  name: "example",
  setup(build) {
    build.onResolve({ filter: /\.example$/ }, args => {
      return { path: args.path.replace(/\.example$/, ".js") };
    });
    build.onLoad({ filter: /\.example$/ }, async args => {
      return { contents: "...", loader: "js" };
    });
  },
};

Bun

const bunPlugin: BunPlugin = {
  name: "example",
  setup(build) {
    build.onResolve({ filter: /\.example$/ }, args => {
      return { path: args.path.replace(/\.example$/, ".js") };
    });
    build.onLoad({ filter: /\.example$/ }, async args => {
      return { contents: "...", loader: "js" };
    });
  },
};

核心

开发服务器

资源处理

单文件可执行文件

扩展

优化

迁移

性能

CLI API

API

esbuild.build()

esbuild.buildSync()

esbuild.transform()

esbuild.serve()

Plugins

示例对比

onResolve

onLoad

esbuild 到 Bun 的插件 API 指南

​性能

​CLI API

​API

​esbuild.build()

​esbuild.buildSync()

​esbuild.transform()

​esbuild.serve()

​Plugins

​示例对比

​onResolve

​onLoad

​esbuild 到 Bun 的插件 API 指南

性能

CLI API

API

esbuild.build()

esbuild.buildSync()

esbuild.transform()

esbuild.serve()

Plugins

示例对比

onResolve

onLoad

esbuild 到 Bun 的插件 API 指南