Bunのbun outdatedとupdateで依存を更新する方法

​​Bun​npm,package.json,パッケージ管理

Bun のプロジェクトで依存パッケージをアップデートするときは、bun outdated で新しいバージョンが出ているものを一覧にし、bun update で上げます。オプションを付けない bun update は、package.json に書いた範囲(^4.0.0 や ~1.11.0)の中でだけ上げ、メジャーバージョンを越えるのは --latest を付けたときだけでした。

npm の npm outdated と npm update に当たる作業を Bun で行いたいときに、どのコマンドで package.json と bun.lock の何が変わるかを確かめました。私は検証環境に、わざと古いバージョンを入れたプロジェクトを作り、コマンドを1つずつ実行して、出力と package.json の差分を見ました。

補足

検証環境は Ubuntu 24.04(x86_64)、Bun 1.4.4 です。2026年11月15日に、標準のレジストリ(registry.npmjs.org)から取得しました。表の「Latest」の数字は、その時点の最新バージョンです。workspaces を使ったモノレポでの --filter と --recursive、catalog、bun update -g、Windows と macOS は試していません。

試したプロジェクト

依存は5つです。bun add zod@3.22.0 のようにバージョンを指定して古いバージョンを入れ、そのあとで package.json の書き方だけを、よくある範囲の書き方に変えました。ms だけは、範囲にしないでバージョンを固定したままにしています。

json
{
  "name": "update-app",
  "private": true,
  "dependencies": {
    "chalk": "^4.0.0",
    "dayjs": "~1.11.0",
    "ms": "2.1.1",
    "zod": "^3.22.0"
  },
  "devDependencies": {
    "typescript": "~5.4.2"
  }
}

この状態で bun install を実行すると「Saved lockfile」と出ますが、入っているバージョンは変わりませんでした。bun.lock の記録も、zod は 3.22.0、chalk は 4.0.0 などのままです。

txt
$ bun install
bun install v1.4.4 (38afee6c8)
Saved lockfile

Checked 10 installs across 11 packages (no changes) [1.00ms]

bun outdated で古い依存を一覧にする

プロジェクトのフォルダで bun outdated を実行すると、新しいバージョンが出ている依存が表になります。

txt
$ bun outdated
bun outdated v1.4.4 (38afee6c8)
┌──────────────────┬─────────┬─────────┬─────────┐
│ Package          │ Current │ Update  │ Latest  │
├──────────────────┼─────────┼─────────┼─────────┤
│ chalk            │ 4.0.0   │ 4.1.2   │ 6.0.1   │
├──────────────────┼─────────┼─────────┼─────────┤
│ dayjs            │ 1.11.0  │ 1.11.23 │ 1.11.23 │
├──────────────────┼─────────┼─────────┼─────────┤
│ ms               │ 2.1.1   │ 2.1.1   │ 2.1.3   │
├──────────────────┼─────────┼─────────┼─────────┤
│ zod              │ 3.22.0  │ 3.25.76 │ 4.6.7   │
├──────────────────┼─────────┼─────────┼─────────┤
│ typescript (dev) │ 5.4.2   │ 5.4.5   │ 7.0.2   │
└──────────────────┴─────────┴─────────┴─────────┘

公式ドキュメントの bun outdated のページによると、3つの列は次の意味です。

  • Current:いま入っているバージョン
  • Update:package.json に書いた範囲の中で、いちばん新しいバージョン
  • Latest:レジストリで latest のタグが付いているバージョン

表を見ると、bun update でどこまで上がるかが分かります。zod は ^3.22.0 なので 3.x の中の 3.25.76 までで、4.6.7 には上がりません。dayjs は ~1.11.0 なので 1.11.x の中で上がり、ちょうど最新の 1.11.23 に届きます。バージョンを固定した ms は、範囲の中にほかのバージョンがないので、Update が 2.1.1 のままです。devDependencies の依存には (dev) が付きます。

端末で見ると、Update と Latest の数字は、上がる桁から先に色が付きます。この検証では、メジャーバージョンが上がる 6.0.1 などが赤、マイナーバージョンが上がる chalk の「1.2」などが黄色、パッチだけが上がる dayjs の「23」などが緑になりました。

bun outdated の表を端末で表示した画面。Update と Latest の数字の一部が赤・黄・緑で色分けされている
端末での bun outdated の表示。上がる桁から先に色が付く

パイプで別のコマンドに出力を渡したとき(bun outdated | cat)は、罫線が | と - の表になり、色も付きませんでした。列の中身は同じです。

調べる依存を絞るときは、名前を引数に渡します。* を使ったパターンも使え、! を先頭に付けたパターンに合う依存は表から外れます。

txt
$ bun outdated 'z*'
bun outdated v1.4.4 (38afee6c8)
┌──────────┬─────────┬─────────┬────────┐
│ Package  │ Current │ Update  │ Latest │
├──────────┼─────────┼─────────┼────────┤
│ zod      │ 3.22.0  │ 3.25.76 │ 4.6.7  │
└──────────┴─────────┴─────────┴────────┘

bun outdated '!typescript' では、typescript だけを除いた4つが並びました。なお、古い依存が表に出ていても、bun outdated の終了コードは 0 でした。

bun update –dry-run で上がるバージョンを先に見る

bun update に --dry-run を付けると、どの依存がどのバージョンに上がるかだけを表示します。

txt
$ bun update --dry-run
bun update v1.4.4 (38afee6c8)
↑ chalk 4.0.0 → 4.1.2 (v6.0.1 available)
↑ dayjs 1.11.0 → 1.11.23
↑ typescript 5.4.2 → 5.4.5 (v7.0.2 available)
↑ zod 3.22.0 → 3.25.76 (v4.6.7 available)

4 packages would be updated [285.00ms]

(v6.0.1 available) は、範囲の外にもっと新しいメジャーバージョンがあることを表します。実行の前とあとで package.json と bun.lock のハッシュ値(sha256)を比べたところ、どちらも変わっていませんでした。node_modules に入っている zod も 3.22.0 のままでした。

bun update で package.json の範囲の中で上げる

名前を付けて bun update zod を実行すると、zod だけが上がりました。

txt
$ bun update zod
bun update v1.4.4 (38afee6c8)
↑ zod 3.22.0 → 3.25.76 (v4.6.7 available)

1 package installed [103.00ms]

実行の前に取っておいた package.json と比べると、zod の行が書き換わっていました。

diff
$ diff ../p0.json package.json
8c8
<     "zod": "^3.22.0"
---
>     "zod": "^3.25.76"

入るバージョンが上がるだけでなく、package.json に書いた範囲の下限も、入れたバージョンに合わせて ^3.25.76 に変わります。公式ドキュメントの bun update のページにも、^ や ~ はそのまま残してバージョンの数字を書き換える、と書かれています。

続けて、名前を付けずに bun update を実行すると、残りの依存がまとめて上がりました。

txt
$ bun update
bun update v1.4.4 (38afee6c8)
↑ typescript 5.4.2 → 5.4.5 (v7.0.2 available)
↑ chalk 4.0.0 → 4.1.2 (v6.0.1 available)
↑ dayjs 1.11.0 → 1.11.23

3 packages installed [241.00ms]
diff
$ diff ../p1.json package.json
5,6c5,6
<     "chalk": "^4.0.0",
<     "dayjs": "~1.11.0",
---
>     "chalk": "^4.1.2",
>     "dayjs": "~1.11.23",
11c11
<     "typescript": "~5.4.2"
---
>     "typescript": "~5.4.5"

~ で書いた dayjs と typescript は ~ のまま、^ の chalk は ^ のままです。バージョンを固定した ms は、package.json も bun.lock も 2.1.1 のままでした。公式ドキュメントにも、固定したバージョンは bun update では package.json の記述を書き換えない、とあります。bun.lock の記録も chalk@4.1.2、dayjs@1.11.23、typescript@5.4.5、zod@3.25.76 に変わりました。

このあとの bun outdated では、範囲の中で最新になった dayjs が表から消えました。もう一度 bun update を実行すると、「Checked 10 installs across 11 packages (no changes)」と出て、何も変わりませんでした。

–latest でメジャーバージョンまで上げる

package.json の範囲を越えて最新バージョンに上げるには、--latest(-L)を付けます。名前を付けずに --dry-run と合わせると、すでに最新の dayjs を除く4つが、範囲の外のメジャーバージョンも含めて最新バージョンに上がると表示されました。

txt
$ bun update --latest --dry-run
bun update v1.4.4 (38afee6c8)
↑ chalk 4.1.2 → 6.0.1
↑ ms 2.1.1 → 2.1.3
↑ typescript 5.4.5 → 7.0.2
↑ zod 3.25.76 → 4.6.7

4 packages would be updated [548.00ms]
注意

名前を付けずに bun update --latest を実行すると、この例では zod が 3 から 4 に、typescript が 5 から 7 にと、範囲の外のメジャーバージョンにまとめて上がります。上げる前に --dry-run で上がる依存とバージョンを確かめ、上げたくないものがあるときは、次のように名前を指定して上げる依存を絞ります。

名前を付けて bun update chalk --latest を実行すると、chalk だけが 6.0.1 に上がり、package.json も ^6.0.1 に書き換わりました。続けて、バージョンを固定した ms にも --latest を付けて実行しました。差分は、chalk を上げる前に取っておいた package.json との比較なので、chalk の行も出ています。

txt
$ bun update ms --latest
bun update v1.4.4 (38afee6c8)
↑ ms 2.1.1 → 2.1.3

1 package installed [35.00ms]
diff
$ diff ../p2.json package.json
5c5
<     "chalk": "^4.1.2",
---
>     "chalk": "^6.0.1",
7c7
<     "ms": "2.1.1",
---
>     "ms": "2.1.3",

固定したバージョンは --latest を付けたときだけ書き換わり、書き方は固定のまま(^ は付かない)でした。

bun update -i で上げる依存を選ぶ

上げる依存を画面で選びたいときは、bun update -i(--interactive)を使います。最初のプロジェクトをコピーしておいたものを使って、↓キーで dayjs に移り、Space キーで選んだところが次の画面です。

bun update -i の選択画面。dependencies と devDependencies に分かれて依存が並び、dayjs だけが選ばれている
bun update -i で dayjs を選んだところ

依存は dependencies と devDependencies に分かれて並び、Current、Target、Latest の3つのバージョンが出ます。Target は範囲の中で上がるバージョンで、bun outdated の Update と同じ数字でした。バージョンを固定した ms も、Target が 2.1.1 のまま一覧に出ました。

この状態で Enter キーを押すと、選んだ dayjs だけが上がりました。Enter キーのあとに画面に出た文字を抜き出すと、次のとおりです。

txt
✓ Selected 1 package to update

Installing updates...
  🔒 Saving lockfile... 
↑ dayjs 1.11.0 → 1.11.23

1 package installed [12.00ms]

package.json では dayjs だけが ~1.11.23 に変わり、ほかの依存は元の書き方のままでした。公式ドキュメントによると、この画面では a ですべてを選べます。l を押すと、カーソルのある依存の上げ先が Target と Latest で切り替わります。Ctrl+C で抜けると、何も上げずに終わります。

​Posted by 86