Bunのbun outdatedとupdateで依存を更新する方法
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 だけは、範囲にしないでバージョンを固定したままにしています。
{
"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 などのままです。
$ bun install
bun install v1.4.4 (38afee6c8)
Saved lockfile
Checked 10 installs across 11 packages (no changes) [1.00ms]
bun outdated で古い依存を一覧にする
プロジェクトのフォルダで bun outdated を実行すると、新しいバージョンが出ている依存が表になります。
$ 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 | cat)は、罫線が | と - の表になり、色も付きませんでした。列の中身は同じです。
調べる依存を絞るときは、名前を引数に渡します。* を使ったパターンも使え、! を先頭に付けたパターンに合う依存は表から外れます。
$ 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 を付けると、どの依存がどのバージョンに上がるかだけを表示します。
$ 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 だけが上がりました。
$ 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 ../p0.json package.json
8c8
< "zod": "^3.22.0"
---
> "zod": "^3.25.76"
入るバージョンが上がるだけでなく、package.json に書いた範囲の下限も、入れたバージョンに合わせて ^3.25.76 に変わります。公式ドキュメントの bun update のページにも、^ や ~ はそのまま残してバージョンの数字を書き換える、と書かれています。
続けて、名前を付けずに bun update を実行すると、残りの依存がまとめて上がりました。
$ 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 ../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つが、範囲の外のメジャーバージョンも含めて最新バージョンに上がると表示されました。
$ 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 の行も出ています。
$ bun update ms --latest
bun update v1.4.4 (38afee6c8)
↑ ms 2.1.1 → 2.1.3
1 package installed [35.00ms]
$ 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 キーで選んだところが次の画面です。

依存は dependencies と devDependencies に分かれて並び、Current、Target、Latest の3つのバージョンが出ます。Target は範囲の中で上がるバージョンで、bun outdated の Update と同じ数字でした。バージョンを固定した ms も、Target が 2.1.1 のまま一覧に出ました。
この状態で Enter キーを押すと、選んだ dayjs だけが上がりました。Enter キーのあとに画面に出た文字を抜き出すと、次のとおりです。
✓ 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 で抜けると、何も上げずに終わります。



