Bun ist eine All-in-One JavaScript-Runtime und Toolkit in Zig. Der Paketmanager installiert Abhängigkeiten bis zu 23x schneller als npm.
Installation und Grundbefehle
Bun installiert sich in Sekunden und funktioniert als Drop-in-Ersatz für npm-Befehle.
# Install Bun
curl -fsSL https://bun.sh/install | bash
# Verify installation
bun --version # 1.x.x
# Install dependencies (reads package.json)
bun install
# Install a specific package
bun add express
bun add -d typescript @types/node # dev dependency
bun add -g bunx # global install
# Remove a package
bun remove lodash
# Update all packages
bun update
# Run a script from package.json
bun run build
bun run dev
# Execute a TypeScript file directly (no transpile step)
bun run index.tsWorkspaces (Monorepo-Unterstützung)
Bun unterstützt npm-style Workspaces für Monorepos.
// package.json — monorepo root
{
"name": "my-monorepo",
"workspaces": [
"packages/*",
"apps/*"
],
"scripts": {
"dev": "bun run --filter '*' dev",
"build": "bun run --filter '*' build",
"test": "bun test"
}
}
// Run a script only in specific workspace
bun run --filter @myapp/web dev
// Install a dependency in a specific workspace
bun add react --cwd apps/web
// Link a local workspace package
// (Bun automatically resolves workspace: protocol)Die binäre Lockfile (bun.lockb)
Bun verwendet eine binäre Lockfile statt JSON.
# bun.lockb is a binary lockfile (much faster to parse than JSON)
# To view lockfile contents in human-readable form:
bun bun.lockb # prints as yarn.lock format
# To regenerate lockfile:
bun install --frozen-lockfile # CI: fails if lockfile is stale
# Migrating from npm/yarn/pnpm:
# Bun reads package-lock.json, yarn.lock, pnpm-lock.yaml
# to preserve existing versions on first install
# .gitignore for Bun:
# node_modules/
# *.lock (optional — commit bun.lockb for reproducible installs)Leistungs-Benchmarks
Buns Paketmanager ist deutlich schneller als alle Alternativen.
# Benchmark: installing react + 1400 packages
# (warm cache, MacBook M2 Pro)
npm install: 28.3s
yarn install: 14.1s
pnpm install: 9.4s
bun install: 1.2s # 23x faster than npm!
# Cold cache (first install, no node_modules)
npm install: 38.7s
bun install: 4.1s # 9x faster
# bun install uses:
# - Symlink-based node_modules (like pnpm)
# - Binary lockfile (bun.lockb) for fast parsing
# - Parallel downloads
# - Global package cache (~/.bun/install/cache)
# - Native code (written in Zig)bunx und eingebaute Tools
bunx führt Pakete ohne Download aus — verwendet gecachte Binärdateien.
# bunx — like npx but instant (no download delay)
bunx create-next-app@latest my-app
bunx prettier --write .
bunx eslint src/
# Run TypeScript directly
bun index.ts # works without ts-node or compilation
bun --watch server.ts # auto-restart on file changes
# Bun's built-in test runner (Jest-compatible API)
bun test
bun test --watch
bun test src/utils.test.ts
// Example test file
import { expect, test, describe } from 'bun:test';
describe('math', () => {
test('adds numbers', () => {
expect(1 + 2).toBe(3);
});
test('async operations', async () => {
const result = await fetch('https://api.example.com/data');
expect(result.ok).toBe(true);
});
});Skripte und Build-Integration
Bun führt package.json-Skripte schneller aus als npm/yarn.
// package.json scripts with Bun
{
"scripts": {
"dev": "bun --watch src/index.ts",
"build": "bun build src/index.ts --outdir dist --target node",
"bundle:web": "bun build src/app.ts --outdir public/js --target browser --minify",
"test": "bun test",
"lint": "bunx eslint src/",
"format": "bunx prettier --write src/"
}
}
// Bun's built-in bundler (replaces esbuild/webpack for simple cases)
// bun build src/index.ts --outdir dist --target node --minify
// Environment variables (Bun auto-loads .env files)
// No need for dotenv package!
console.log(process.env.DATABASE_URL); // works in Bun automaticallyBun vs npm vs pnpm vs Yarn
| Feature | Bun | npm | pnpm | Yarn |
|---|---|---|---|---|
| Install speed (warm) | 1.2s | 28.3s | 9.4s | 14.1s |
| Lockfile format | Binary | JSON | YAML | Custom text |
| node_modules style | Symlinks | Hoisted | Symlinks | Hoisted/PnP |
| Workspace support | Yes | Yes | Yes | Yes |
| Built-in TypeScript | Yes (native) | No | No | No |
| Built-in test runner | Yes (Jest API) | No | No | No |
| .env auto-loading | Yes | No | No | No |
Best Practices
- bun.lockb für reproduzierbare Installs committen.
- bun --watch für die Entwicklung verwenden.
- Schrittweise von npm migrieren.
- Für Monorepos Bun Workspaces mit Turborepo kombinieren.
- Bun lädt .env automatisch — kein dotenv-Paket nötig.
Häufige Fragen
Ist Bun 2026 produktionsbereit?
Ja. Bun 1.0+ erreichte 2023 Stabilität mit 99%+ Node.js-API-Abdeckung.
Funktioniert Bun mit allen npm-Paketen?
Fast alle. Ausnahmen sind Pakete mit nativen Node-Addons.
Kann ich Bun mit Next.js verwenden?
Ja für den Paketmanager — bun install funktioniert sofort.
Wie unterscheidet sich bun.lockb von package-lock.json?
bun.lockb ist ein Binärformat, das in Mikrosekunden geparst wird.
Bun oder pnpm für ein neues Projekt?
Beide sind ausgezeichnet. Bun für den All-in-One-Ansatz, pnpm für große Monorepos.