import Add from "/snippets/cli/add.mdx";

特定のパッケージを追加するには:

bun add preact

バージョン、バージョン範囲、またはタグを指定するには:

bun add zod@3.20.0
bun add zod@^3.0.0
bun add zod@latest

--dev

NOTE

**エイリアス** — `--development`、`-d`、`-D`

パッケージを開発依存関係（"devDependencies"）として追加するには:

bun add --dev @types/react
bun add -d @types/react

--optional

パッケージをオプションの依存関係（"optionalDependencies"）として追加するには:

bun add --optional lodash

--peer

パッケージをピア依存関係（"peerDependencies"）として追加するには:

bun add --peer @types/bun

--exact

NOTE

**エイリアス** — `-E`

パッケージを追加して解決されたバージョンに固定するには、--exact を使用します。これにより、パッケージのバージョンが解決され、バージョン範囲の代わりに正確なバージョン番号で package.json に追加されます。

bun add react --exact
bun add react -E

これにより、package.json に以下が追加されます。

{
  "dependencies": {
    // --exact なし
    "react": "^18.2.0", // これは >= 18.2.0 < 19.0.0 に一致

    // --exact あり
    "react": "18.2.0" // これは 18.2.0 のみに正確に一致
  }
}

このコマンドのオプションの完全なリストを表示するには:

bun add --help

--global

NOTE

**注** — これは現在のプロジェクトフォルダの package.json を変更しません。 **エイリアス** - `bun add --global`、`bun add -g`、`bun install --global`、`bun install -g`

パッケージをグローバルにインストールするには、-g/--global フラグを使用します。これにより、現在のプロジェクトの package.json は変更されません。通常、これはコマンドラインツールのインストールに使用されます。

bun add --global cowsay # または `bun add -g cowsay`
cowsay "Bun!"

 ______
< Bun! >
 ------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

グローバルインストールの動作を設定する

[install]
# `bun add --global` がパッケージをインストールする場所
globalDir = "~/.bun/install/global"

# グローバルにインストールされたパッケージバイナリがリンクされる場所
globalBinDir = "~/.bun/bin"

信頼された依存関係

他の npm クライアントとは異なり、Bun はインストールされた依存関係の任意のライフサイクルスクリプト（postinstall など）を実行しません。これらのスクリプトはマシン上で任意のコードを実行できる可能性があるため、潜在的なセキュリティリスクを表します。

特定のパッケージのライフサイクルスクリプトを Bun に許可させるには、package.json の trustedDependencies にパッケージを追加します。

{
  "name": "my-app",
  "version": "1.0.0",
  "trustedDependencies": ["my-trusted-package"] 
}

Bun はこのフィールドを読み取り、my-trusted-package のライフサイクルスクリプトを実行します。

Git 依存関係

公開またはプライベートな git リポジトリから依存関係を追加するには:

bun add git@github.com:moment/moment.git

NOTE

プライベートリポジトリをインストールするには、システムにリポジトリにアクセスするための適切な SSH 認証情報が必要です。

Bun は github、git、git+ssh、git+https など、さまざまなプロトコルをサポートしています。

{
  "dependencies": {
    "dayjs": "git+https://github.com/iamkun/dayjs.git",
    "lodash": "git+ssh://github.com/lodash/lodash.git#4.17.21",
    "moment": "git@github.com:moment/moment.git",
    "zod": "github:colinhacks/zod"
  }
}

Tarball 依存関係

パッケージ名は公開ホストされた .tgz ファイルに対応できます。インストール中、Bun はパッケージレジストリからではなく、指定された tarball URL からパッケージをダウンロードしてインストールします。

bun add zod@https://registry.npmjs.org/zod/-/zod-3.21.4.tgz

これにより、package.json に以下の行が追加されます。

{
  "dependencies": {
    "zod": "https://registry.npmjs.org/zod/-/zod-3.21.4.tgz"
  }
}