Skip to content

Bun への移行について

本プロジェクトでは、これまで Node.js(npm / yarn / pnpm)を利用して開発を行ってきましたが、開発速度と依存管理の効率化のため、実行環境およびパッケージマネージャを Bun へ移行しました。

Bun は高速な JavaScript ランタイムであり、開発体験が大きく向上します。
今後、このプロジェクトでは Bun を必須とし、従来ツールとの併用は行いません。

1. 事前準備

Bun をローカル環境にインストールしてください。


curl -fsSL [https://bun.sh/install](https://bun.sh/install) | bash

Windows の場合:


powershell -c "irm bun.sh/install.ps1 | iex"

インストール後、以下で動作確認できます。


bun --version

2. 依存関係のインストール

プロジェクトをクローンした後、従来の npm installyarn install は使用しません。

代わりに、以下を実行してください。


bun install

これにより Bun 専用ロックファイル(bun.lockb)が生成され、依存関係がセットアップされます。

3. スクリプト実行の変更

すべてのスクリプトは bun run に統一されます。

例:


bun run dev
bun run build
bun run start

従来の npm runyarn dev は使用しません。

4. 注意点

  • npm や yarn など、別のパッケージマネージャと混在させると依存が壊れます
  • node_modules を削除して Bun で再構築することを推奨
  • CI も Bun ベースに変更済みです
  • プロジェクト全体で Bun を標準として運用します

この移行により、開発環境の起動、依存解決、ビルド時間が大幅に短縮され、より快適な開発が可能になります。