bun run CLI 使用法

bun run <file or script>

一般実行オプション

--silentboolean

スクリプトコマンドを出力しません

--if-presentboolean

エントリーポイントが存在しない場合、エラーなしで終了します

--evalstring

引数をスクリプトとして評価します。エイリアス：-e

--printstring

引数をスクリプトとして評価し、結果を出力します。エイリアス：-p

--helpboolean

このメニューを表示して終了します。エイリアス：-h

ワークスペース管理

--elide-linesnumber default: 10

--filter 使用時に表示されるスクリプト出力の行数（デフォルト：10）。すべての行を表示するには 0 に設定します

--filterstring

パターンに一致するすべてのワークスペースパッケージでスクリプトを実行します。エイリアス：-F

--workspacesboolean

すべてのワークスペースパッケージ（package.json の workspaces フィールドから）でスクリプトを実行します

ランタイムとプロセス制御

--bunboolean

スクリプトまたはパッケージに Node.js ではなく Bun のランタイムを強制的に使用させます（node のシンボリックリンク経由）。エイリアス：-b

--shellstring

package.json スクリプトに使用するシェルを制御します。bun または system のいずれかをサポートします

--smolboolean

メモリ使用量を減らしますが、ガベージコレクションをより頻繁に実行します

--expose-gcboolean

グローバルオブジェクトに gc() を公開します。Bun.gc() には影響しません

--no-deprecationboolean

カスタム非推奨のすべての報告を抑制します

--throw-deprecationboolean

非推奨警告がエラーになるかどうかを決定します

--titlestring

プロセスタイトルを設定します

--zero-fill-buffersboolean

Buffer.allocUnsafe(size) をゼロ埋めすることを強制するブール値

--no-addonsboolean

process.dlopen が呼び出された場合にエラーをスローし、エクスポート条件 node-addons を無効にします

--unhandled-rejectionsstring

strict、throw、warn、none、または warn-with-error-code のいずれか

--console-depthnumber default: 2

console.log オブジェクト検査のデフォルト深度を設定します（デフォルト：2）

開発ワークフロー

--watchboolean

ファイル変更時にプロセスを自動的に再起動します

--hotboolean

Bun ランタイム、テストランナー、またはバンドラーで自動リロードを有効にします

--no-clear-screenboolean

--hot または --watch が有効な場合に、リロード時にターミナル画面をクリアしないようにします

デバッグ

--inspectstring

Bun のデバッガーをアクティブにします

--inspect-waitstring

Bun のデバッガーをアクティブにし、実行前に接続を待機します

--inspect-brkstring

Bun のデバッガーをアクティブにし、コードの最初の行にブレークポイントを設定して待機します

依存関係とモジュール解決

--preloadstring

他のモジュールが読み込まれる前にモジュールをインポートします。エイリアス：-r

--requirestring

Node.js 互換性のための --preload のエイリアス

--importstring

Node.js 互換性のための --preload のエイリアス

--no-installboolean

Bun ランタイムでの自動インストールを無効にします

--installstring default: auto

自動インストール動作を設定します。auto（デフォルト、node_modules がない場合に自動インストール）、fallback（不足しているパッケージのみ）、force（常に）のいずれか

-iboolean

実行中に依存関係を自動インストールします。--install=fallback と同等です

--prefer-offlineboolean

Bun ランタイム内のパッケージの鮮度チェックをスキップし、ディスクから解決します

--prefer-latestboolean

Bun ランタイム内のパッケージの一致する最新バージョンを使用し、常に npm をチェックします

--conditionsstring

解決するためのカスタム条件を渡します

--main-fieldsstring

package.json で検索するメインフィールド。--target 依存のデフォルト

--preserve-symlinksboolean

ファイル解決時にシンボリックリンクを保持します

--preserve-symlinks-mainboolean

メインエントリーポイントを解決するときにシンボリックリンクを保持します

--extension-orderstring default: .tsx,.ts,.jsx,.js,.json

デフォルト：.tsx,.ts,.jsx,.js,.json

トランスパイルと言語機能

--tsconfig-overridestring

カスタム tsconfig.json を指定します。デフォルト $cwd/tsconfig.json

--definestring

解析中に K:V を置換します（例：--define process.env.NODE_ENV:"development"）。値は JSON として解析されます。エイリアス：-d

--dropstring

関数呼び出しを削除します（例：--drop=console はすべての console.* 呼び出しを削除します）

--loaderstring

.ext:loader でファイルを解析します（例：--loader .js:jsx）。有効なローダー：js、jsx、ts、tsx、json、toml、text、file、wasm、napi。エイリアス：-l

--no-macrosboolean

バンドラー、トランスパイラー、およびランタイムでのマクロの実行を無効にします

--jsx-factorystring

クラシック JSX ランタイムを使用して JSX 要素をコンパイルするときに呼び出される関数を変更します

--jsx-fragmentstring

JSX フラグメントをコンパイルするときに呼び出される関数を変更します

--jsx-import-sourcestring default: react

jsx および jsxs ファクトリ関数をインポートするために使用されるモジュール指定子を宣言します。デフォルト：react

--jsx-runtimestring default: automatic

automatic（デフォルト）または classic

--jsx-side-effectsboolean

JSX 要素を副作用があると見なします（pure 注釈を無効にします）

--ignore-dce-annotationsboolean

@__PURE__ などのツリーシェイキング注釈を無視します

ネットワークとセキュリティ

--portnumber

Bun.serve のデフォルトポートを設定します

--fetch-preconnectstring

コードの読み込み中に URL に事前接続します

--max-http-header-sizenumber default: 16384

HTTP ヘッダーの最大サイズをバイト単位で設定します。デフォルトは 16KiB

--dns-result-orderstring default: verbatim

DNS 検索結果のデフォルト順序を設定します。有効な順序：verbatim（デフォルト）、ipv4first、ipv6first

--use-system-caboolean

システムの信頼された証明書機関を使用します

--use-openssl-caboolean

OpenSSL のデフォルト CA ストアを使用します

--use-bundled-caboolean

バンドルされた CA ストアを使用します

--redis-preconnectboolean

起動時に $REDIS_URL に事前接続します

--sql-preconnectboolean

起動時に PostgreSQL に事前接続します

--user-agentstring

HTTP リクエストのデフォルト User-Agent ヘッダーを設定します

グローバル設定とコンテキスト

--env-filestring

指定されたファイルから環境変数を読み込みます

--cwdstring

ファイルとエントリーポイントを解決する絶対パス。これはプロセスの cwd を変更するだけです

--configstring

Bun 設定ファイルへのパスを指定します。デフォルト $cwd/bunfig.toml。エイリアス：-c

例

JavaScript または TypeScript ファイルを実行：

bun run ./index.js
bun run ./index.tsx

package.json スクリプトを実行：

bun run dev
bun run lint