morochief/soar/bun-runtime

Bunランタイム

Bunは高速なオールインワンJavaScriptランタイムとツールキット：ランタイム、パッケージマネージャー、バンドラー、テストランナー。

使用時期

• Bunを好む：新しいJS/TSプロジェクト、インストール/実行速度が重要なスクリプト、Bunランタイムでのデプロイメント、単一のツールチェーン（実行+インストール+テスト+ビルド）が必要な場合。
• Nodeを好む：最大のエコシステム互換性、ノードを仮定するレガシーツール、またはある依存関係が既知のBun問題がある場合。

使用時期：Bunを採用、Nodeから移行、Bunスクリプト/テストを書いたりデバッグしたり、Vercelまたは他のプラットフォームでBunを構成する場合。

動作方法

• ランタイム：ドロップイン互換のNodeランタイム（JavaScriptCoreで構築、Zigで実装）。
• パッケージマネージャー：bun installはnpm/yarnよりも大幅に高速です。ロックファイルはbun.lock（テキスト）（デフォルト）。古いバージョンはbun.lockb（バイナリ）を使用しました。
• バンドラー：アプリとライブラリ用の組み込みバンドラーとトランスパイラー。
• テストランナー：Jest様のAPIを備えた組み込みbun test。

Nodeからの移行：node script.jsをbun run script.jsまたはbun script.jsに置き換えます。npm installの代わりにbun installを実行します。ほとんどのパッケージは機能します。npm スクリプトにはbun runを使用します。bun xをnpxスタイルの1回限りの実行に使用します。Nodeの組み込みはサポートされています。パフォーマンスの向上のため、Bunチャネルが存在する場合は優先。

Vercel：プロジェクト設定でBunに設定をランタイムに設定します。ビルド：bun run buildまたはbun build ./src/index.ts --outdir=dist。インストール：再現可能なデプロイの場合はbun install --frozen-lockfile。

例

実行とインストール

# 依存関係をインストール（bun.lockまたはbun.lockbを作成/更新）
bun install
 
# スクリプトまたはファイルを実行
bun run dev
bun run src/index.ts
bun src/index.ts

スクリプトとenv

bun run --env-file=.env dev
FOO=bar bun run script.ts

テスト

bun test
bun test --watch

// test/example.test.ts
import { expect, test } from "bun:test";
test("add", () => {
  expect(1 + 2).toBe(3);
});

常見の問題

• bun installはnode_modulesを作成しますが、シンボリックリンクの多用により構造が異なります。
• 古い依存関係にはBun互換性の問題がある可能性があります。Node にフォールバックする。
• VercelでBun使用時は設定とビルドコマンドが必須。