node_modulesが重いのは、パッケージマネージャがディスクの使い方を変えているからです。npm・pnpm・Bunを同じ条件で測って比べます。
前回: クラス名を考えるのをやめる — Tailwind CSS 作業場所はVMの中(Ubuntu)です。この回は
~/react-demo/を読み取り専用の材料として使い、コピーした別フォルダで実験します。~/react-demo/と~/tw-demo/は書き換えません。
npm install を打って、終わるのを待っている時間があります。
その間にやることが無いので、ぼんやり眺めています。終わったら du -sh node_modules を打って、また固まります。
「遅い」「重い」は、ずっと感想のままでした。
そして、検索するとこう出てきます。「pnpm は速い」「Bun は爆速」「esbuild は100倍」。数字だけが並んでいて、なぜ速いのかは書いていません。 書いてあっても「Rustで書かれているから」で終わっています。
そこで乗り換えると、たいてい失敗します。自分は「何が遅かったのか」を測っていないので、乗り換えて速くなったのかどうかも分からないからです。
この記事は「pnpm の使い方」でも「Bun のすすめ」でもありません。まず測って、次に仕組みを見て、最後に「それでも npm のままでいい」と結論する記事です。
結論を先に書きます。このサイトはこの先も npm で進めます。 それでもこの回をやる理由は、node_modules の中で何が起きているかを知らないと、npm install が壊れたときに何も出来ないからです。npmの回で「node_modules は消してよい」と分かりました。今回はその一段下、「消してよいものは、ディスクの上でどう置かれているのか」を見ます。
対象レベル: 初級 / 区分: 必修
この記事でわかること
npm installが遅い理由の大半はダウンロードではなく、ファイルを「書く」ことだということ。だから2回目は速い- npm・yarn・pnpm の違いは機能ではなく、
node_modulesの形だということ。pnpm が減らすのはプロジェクト1個のディスクではなく、プロジェクト2個目以降のディスク - npm の平らな
node_modulesは、書いていない依存を import できてしまうこと。それが「自分は何も変えていないのに壊れた」の正体 - ロックファイルは3種類あって互換性が無いこと。2つ同時にコミットするのは事故のもと
- Bun は速いが、パッケージマネージャとランタイムが同じ名前で呼ばれていること。どちらを使うかで話がまるで違う
- Vite は1つのビルドツールではなく、esbuild と Rollup の使い分けだということ(Vite 7 まで。Vite 8 で Rolldown 1つになった)。開発と本番で目的が違うから2つ要る
- esbuild や SWC が速い最大の理由は、JavaScript で書かれていないこと。ただし「言語を変えたから100倍」ではない
この記事でやること
~/react-demo/をコピーした実験用フォルダを作り、time npm installとdu -sh node_modulesで現状を数字にする- pnpm を入れて、同じプロジェクトで測り直す。
ls -lとstatでシンボリックリンクとハードリンクを実際に見る - 同じプロジェクトを2つ用意して、npm と pnpm でディスク使用量を比べる(ここが山場)
- npm では通り、pnpm では落ちるコードを書いて、幽霊依存を再現する
- Bun を入れて
bun installの速さを測り、動かないものがあることも確認する node_modulesの中に esbuild と Rollup が両方いることを確認して、なぜ2つ要るのかを読む
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| inode(アイノード) | Linux がファイルの実体1つに振っている番号。名前ではなく中身の側に付く |
| ハードリンク | 同じ inode にもう1つ名前を付けること。実体は1つなので、ディスクは増えない。コピーではない |
| シンボリックリンク | 「あっちを見て」と別の場所を指し示すだけの小さなファイル。Windowsのショートカットに近い |
| グローバルストア | pnpm がパッケージの実体をPC全体で1箇所に貯めておく場所。各プロジェクトはそこへのリンクを持つ |
| pnpm | performant npm。ストア+リンク方式のパッケージマネージャ |
| yarn | npm より先にロックファイルと速度を持ち込んだパッケージマネージャ。現在は v1 と v2以降で別物 |
| 幽霊依存(phantom dependency) | package.json に書いていないのに import できてしまうパッケージ。ある日突然消える |
| Bun | ランタイム(node の代わり)とパッケージマネージャ(npm の代わり)を兼ねる道具。Zig で書かれている |
| ランタイム | JavaScript を実際に実行するプログラムそのもの。Node.js や Bun がこれ |
| ネイティブコード | CPU が直接実行できる形にあらかじめ変換済みのプログラム。Go や Rust はこれを作る |
| SWC | Rust で書かれたトランスパイラ。Babel の置き換えとして使われる |
| Rolldown | Rust で書かれたバンドラ。Vite の中の esbuild と Rollup を1つにまとめようとしている |
① まず測る — 「遅い」「重い」を数字にする
感想のまま乗り換えると、良くなったかどうかが判定できません。 先に数字を作ります。
実験用にコピーを作る
~/react-demo/ は触りません。 Reactの回で作ったものを、そのまま残します。
VMの中の Ubuntu で打ちます。
eslint.config.js index.html package.json package-lock.json public README.md src vite.config.js
cp -rはnode_modulesごとコピーするので、少し時間がかかります。 そのあと消しています。 「先に消してからコピーすればいいのでは」と思うところですが、元の~/react-demo/を壊さないために、コピー側だけを消す順番にしています。
npm install を測る
time を頭に付けると、かかった時間が出ます。time は bash に組み込みで入っているので、追加のインストールは要りません。
added 213 packages in 9s
real 0m9.412s
user 0m9.106s
sys 0m2.310s
3つの数字が出ます。読むのは real です。
| 行 | 意味 |
|---|---|
real | 実際に待たされた時間(時計の時間)。体感はこれ |
user | CPU がプログラムの計算に使った時間 |
sys | CPU が OS の仕事(ファイル書き込みなど)に使った時間 |
何がどれだけあるのか測る
118M node_modules
216
19842
数字は環境で違います。 大事なのは3つ目です。
フォルダは216個。でもファイルは約2万個あります。
これが「遅い」の正体でした。ネットからのダウンロードより、2万個のファイルをディスクに書く方が時間を食っています。 だから2回目の npm install は速いのに(ダウンロードはキャッシュから)、rm -rf node_modules してからやり直すと、また同じくらいかかります。
確かめます。
ネットに1バイトも取りに行っていないのに、ほとんど同じ時間がかかったはずです。
ここで一番大事なこと。
npm installの遅さは「回線が遅いから」ではありません。 大半はファイルを作る作業です。 だから「速いパッケージマネージャ」は、ダウンロードを速くしているのではなく、ファイルを作る回数を減らしています。
[スクリーンショット: 01_npm測定.png] time npm install と du -sh node_modules、find node_modules -type f | wc -l を続けて実行した結果を、まとめて1枚で撮ってください。
② パッケージマネージャは3つある — 違いはディスクの使い方
名前を並べると、こうなります。
| 名前 | 出てきた時期 | 何のために作られたか |
|---|---|---|
| npm | 2010〜 | Node.js に最初から付いてくる。標準 |
| yarn | 2016〜 | npm が遅く、ロックファイルも無かった時代への回答 |
| pnpm | 2017〜 | 同じパッケージを何度もディスクに書くのをやめるための道具 |
yarn が解こうとした問題は、npm 自身がほぼ解いてしまいました。 ロックファイルは package-lock.json として npm に入り、速度も改善されました。だから今 yarn を新規に選ぶ理由は薄いのですが、既存プロジェクトで使われているので読めた方がいい、という位置です。
pnpm が解こうとした問題だけが、npm に取り込まれずに残っています。
npm の node_modules は「平ら」
npmの回で「依存が依存を呼ぶ」を見ました。あれをディスクにどう置くか、が問題です。
素直に置くと、こうなります(入れ子)。
node_modules/
└── react-dom/
└── node_modules/
└── scheduler/
これを全部やると、同じ scheduler が何十箇所にもコピーされます。 昔の npm はこれをやっていて、Windows ではパスが長すぎてエラーになるほどでした。
npm 3 以降は、これをやめて「平ら」にしました(hoisting/巻き上げ)。
node_modules/
├── react/
├── react-dom/
└── scheduler/ ← 自分で入れた覚えがないのに、ここにいる
scheduler は自分で入れたものではありません。react-dom が必要としているだけです。 それが、自分の直接の依存と同じ高さに並んでいます。
この「平ら」が、速さとディスクを両方犠牲にしないための答えでした。 そして、あとで見る大きな落とし穴でもあります。
pnpm がやったこと
pnpm の答えは、「ディスクに実体を1つだけ置いて、あとは全部リンクにする」です。
[PC全体で1箇所のストア]
react 19.2.0 の実体(1つだけ)
↑ ハードリンク ↑ ハードリンク
プロジェクトA の node_modules プロジェクトB の node_modules
プロジェクトを10個作っても、react の実体はディスク上に1つです。
そして、プロジェクト直下の node_modules には「自分が package.json に書いたものだけ」を、シンボリックリンクで置きます。 scheduler は出てきません。
言葉だけだと分からないので、実際に見ます。
③ pnpm を入れて、同じプロジェクトで比べる
ここが山場です。
pnpm を入れる
入れ方は3つあります。 nvm を使っているので、sudo の要らないやり方を選びます。
10.15.1
npm install -gは避けようという話をしたのに、ここでは使っています。 理由は、pnpm はプロジェクトの部品ではなく、npmと同じ立場の道具だからです。プロジェクトの中に入れると、「pnpm を使うために npm install が要る」という妙なことになります。 nvm でNode.jsのバージョンを切り替えると、-gで入れたものは付いてきません。pnpm: command not foundになったら、それが原因です。入れ直してください。
もう1つのやり方(Corepack)も知っておくと得です。Node.js に同梱されていて、package.json に書いたバージョンの pnpm を自動で使わせるものです。
package.json にこう書いておくと、チーム全員が同じバージョンを使います。
{
"packageManager": "pnpm@10.15.1"
}
この記事では npm install -g pnpm で進めます。 Corepack は Node.js のバージョンによって扱いが変わるので、最初の1回は素直な方を使います。
pnpm で入れ直して測る
同じフォルダで npm と pnpm を混ぜてはいけません。 先に消します。
1回目は、想像より遅いはずです。
Packages: +213
Progress: resolved 213, reused 0, downloaded 213, added 213, done
real 0m21.087s
「速いって聞いたのに」と思うところです。 理由は reused 0 です。ストアが空なので、全部ダウンロードしています。 ここは正直に書きます。pnpm の1回目は npm より遅いことがあります。
2回目を測ります。
Packages: +213
Progress: resolved 213, reused 213, downloaded 0, added 213, done
real 0m2.104s
reused 213。1つもダウンロードしていません。そして、ファイルもコピーしていません。
| npm(キャッシュあり) | pnpm(ストアあり) | |
|---|---|---|
real | 約9秒 | 約2秒 |
| していること | 2万個のファイルを作る | 2万個のリンクを張る |
リンクを張るのは、ファイルを書くよりずっと安いからです。
ls -l で node_modules を見る
ここが、この記事で一番見てほしいところです。
total 4
lrwxrwxrwx 1 ubuntu ubuntu 60 Sep 11 10:12 @vitejs -> .pnpm/@vitejs+plugin-react@5.0.0_vite@7.1.3/node_modules/@vitejs
drwxr-xr-x 32 ubuntu ubuntu 4096 Sep 11 10:12 .bin
drwxr-xr-x 4 ubuntu ubuntu 4096 Sep 11 10:12 .pnpm
lrwxrwxrwx 1 ubuntu ubuntu 38 Sep 11 10:12 eslint -> .pnpm/eslint@9.33.0/node_modules/eslint
lrwxrwxrwx 1 ubuntu ubuntu 36 Sep 11 10:12 react -> .pnpm/react@19.2.0/node_modules/react
lrwxrwxrwx 1 ubuntu ubuntu 44 Sep 11 10:12 react-dom -> .pnpm/react-dom@19.2.0/node_modules/react-dom
lrwxrwxrwx 1 ubuntu ubuntu 34 Sep 11 10:12 vite -> .pnpm/vite@7.1.3/node_modules/vite
2つのことに気づいてください。
1つめ。行頭が l です。 d(ディレクトリ)でも -(普通のファイル)でもありません。l はシンボリックリンクです。 Linuxのファイルの置き場所の回で ls -l の読み方をやりましたが、この l はそこでは出てきませんでした。
2つめ。並んでいるのが、.bin と .pnpm を除くと5個しかありません。 npm のときは216個ありました。
5
package.json に書いたものだけです。 scheduler はいません。
実体は .pnpm の中にあります。
@ampproject+remapping@2.3.0
@babel+code-frame@7.27.1
@babel+core@7.28.3
@babel+helper-compilation-targets@7.27.2
@babel+parser@7.28.3
213
213個、全部ここにいます。 ただし名前が パッケージ名@バージョン になっていて、/ が + に置き換わっています。 これは「同じパッケージの別バージョンを、隣同士に置ける」ようにするためです。
[スクリーンショット: 02_pnpm-node-modules.png] ls -lA node_modules | head の結果を撮ってください。行頭の l と -> が見えるようにしてください。
中身はコピーではない — stat で確かめる
シンボリックリンクの先は .pnpm の中でした。では .pnpm の中身は、ストアからのコピーなのでしょうか。
stat で見ます。%i が inode 番号、%h がそのファイルを指している名前の数です。
1442361 2 1234 node_modules/.pnpm/react@19.2.0/node_modules/react/package.json
%h が 2 です。 つまり、この中身を指している名前が、ディスク上に2つあるということです。もう1つはストアの中にあります。
比較のために、npm のときはこうでした。
1439102 1 1234 node_modules/react/package.json
%h が 1。この中身を指しているのは、この名前だけです。 キャッシュからコピーされたものだからです。
ハードリンクとシンボリックリンクは、まったくの別物です。
| シンボリックリンク | ハードリンク | |
|---|---|---|
| 中身 | 「あっちを見て」というパスの文字列 | 実体そのものへの、もう1つの名前 |
ls -l | l で始まり -> が出る | 普通のファイルと見分けが付かない |
| 元を消すと | リンクが切れて壊れる | 平気(名前が1つ減るだけ) |
| ディスク | ほぼ0 | 0(実体は増えない) |
| pnpm での役割 | node_modules/react → .pnpm/react@19.2.0/… | .pnpm/… の中身 → グローバルストア |
pnpm はこの2つを使い分けています。 「どのパッケージが見えるか」の管理はシンボリックリンクで、「実体を1つにする」のはハードリンクです。
ストアの場所はこれで分かります。
/home/ubuntu/.local/share/pnpm/store/v10
ディスクは「2個目のプロジェクト」で減る
ここで、多くの記事が書いていないことを書きます。
115M node_modules
npm のときは 118M でした。ほとんど減っていません。
「pnpm は容量が減る」は、嘘ではありませんが、プロジェクト1個では起きません。 du は実体のあるファイルのサイズを数えるので、ハードリンクだろうと1回は数えます。このプロジェクトが使っているファイルの合計は、npm でも pnpm でも同じです。
減るのは2個目からです。 実際にやります。
そして、2つをまとめて測ります。ここが肝心です。
115M pm-demo/node_modules
1.8M pm-demo2/node_modules
117M total
2個目が 1.8M です。 ゼロではないのは、シンボリックリンクとディレクトリの分です。中身は1バイトも増えていません。
npm で同じことをすると、こうなります。
118M react-demo/node_modules
118M pm-demo3/node_modules
236M total
倍になりました。
du -cshを1回で打つ理由があります。duが「同じ実体を2回数えない」のは、1回の実行の中だけです。 別々にdu -shを打つと、両方とも 115M と表示されて、合計が 230M に見えます。 これは嘘です。 ハードリンクを測るときは、必ず1回のduにまとめて渡してください。
これが pnpm の本当の効き方です。
- プロジェクトが1個なら、ほぼ変わらない
- プロジェクトが10個あるなら、劇的に変わる
node_modulesを消して入れ直す作業が速くなるのは、1個でも効く
「自分は今いくつプロジェクトを持っているか」で、効くかどうかが決まります。 今の自分は react-demo と tw-demo の2つです。まだ、痛くありません。
④ pnpm が厳しいのは意図的 — 幽霊依存
速さやディスクより、こちらの方が本質です。
②で見たとおり、npm の node_modules は平らでした。scheduler が自分の直接の依存と同じ場所にいました。
Node.js は node_modules を上から順に探すだけなので、そこにあれば読めてしまいます。
npm では通る
npm で入れた方のプロジェクトで打ちます。
/home/ubuntu/react-demo/node_modules/scheduler/index.js
package.json を見てください。scheduler はどこにも書いていません。
何も出ません。書いていないのに、使えます。 これが幽霊依存です。
pnpm では落ちる
node:internal/modules/cjs/loader:1215
throw err;
^
Error: Cannot find module 'scheduler'
pnpm は、package.json に書いていないものを見えなくしています。
初めて pnpm を使うと、ここで大量にエラーが出ます。 そして「pnpm は厳しすぎる、使いにくい」と言って戻ります。自分もそう思いました。
これが実際に起こすバグ
なぜ厳しくするのかは、こう考えると分かります。
自分のコードにこう書いたとします。動きます。テストも通ります。
import { unstable_now } from 'scheduler'
半年後、react-dom がバージョンアップして、内部で使う部品を scheduler から別のものに変えました。
すると、node_modules から scheduler が消えます。
自分は1文字も変えていないのに、npm install した瞬間にビルドが落ちます。
Failed to resolve import "scheduler"
そして原因が分かりません。 自分の変更履歴には何もないからです。package.json にも書いていないので、「いつから使っていたのか」すら追えません。
もっと悪いのは、消えずに「バージョンだけ変わる」ケースです。エラーにならず、動きだけが静かに変わります。
pnpm の厳しさは、この事故を「今日、目に見える形で」起こしているだけです。 半年後に理由不明で落ちるか、今日エラーで止まるか。 どちらがいいかという話です。
直し方は簡単
エラーが出たら、書けばいいだけです。
「厳しくて使えない」と感じたときの正体は、たいてい「自分の package.json が実態と合っていなかった」です。
npm のままでも、この考え方は持ち帰れます。 import する前に、それが package.json に書いてあるか確認する。 書いていないなら npm install で足す。それだけで、この事故は起きません。
⑤ ロックファイルは3つあって、互換性が無い
npmの回で package-lock.json をやりました。「実際に何のどのバージョンを入れたか」の記録です。
問題は、パッケージマネージャごとに別のファイルを作ることです。
| 道具 | ロックファイル | 形式 |
|---|---|---|
| npm | package-lock.json | JSON |
| yarn | yarn.lock | 独自 |
| pnpm | pnpm-lock.yaml | YAML |
| Bun | bun.lock | JSONC(以前は bun.lockb というバイナリ) |
中身は互換ではありません。 移行時に読み取ってくれるものはありますが(pnpm は package-lock.json を読んで pnpm-lock.yaml を作ります)、「両方置いておけば両方使える」ではありません。
さっきの pnpm install のあと、フォルダを見てください。
package.json package-lock.json pnpm-lock.yaml
両方あります。これが一番危ない状態です。
何が起きるか。
- A さんは
npm installする →package-lock.jsonを見る - B さんは
pnpm installする →pnpm-lock.yamlを見る - CI は
npm ciする →package-lock.jsonを見る
3人が違うバージョンのパッケージで作業していて、誰も気づきません。 そして片方だけを更新するので、時間が経つほどズレが広がります。
移行したら、古い方は消してコミットします。
逆に、npm のままでいるなら pnpm-lock.yaml を消します。 どちらか1つだけがリポジトリにある状態を保ちます。
npm ci との関係
npm ci は「ロックファイルだけを見て、書き換えない」コマンドでした。これに相当するものが、どの道具にもあります。
| 道具 | 手元で開発するとき | CI・本番でのコマンド |
|---|---|---|
| npm | npm install | npm ci |
| yarn(v2以降) | yarn install | yarn install --immutable |
| pnpm | pnpm install | pnpm install --frozen-lockfile |
| Bun | bun install | bun install --frozen-lockfile |
名前は違いますが、やっていることは全部同じです。
「ロックファイルと
package.jsonが食い違っていたら、直さずにエラーで止まれ」
GitHub Actionsの回でCIを書きました。そこで npm install と書いていたら、npm ci に直す価値があります。 「テストした中身と、本番に出る中身が違う」を防ぐためです。
そして、パッケージマネージャを変えたら、CIのコマンドも必ず変えてください。 ここを忘れると、CIだけが古いロックファイルを見続けます。
⑥ Bun を触る — ただし期待の掛け方に注意
Bun は、名前が1つなのに正体が3つあります。
| Bun の顔 | 何の代わりか | 完成度 |
|---|---|---|
パッケージマネージャ(bun install) | npm | 今すぐ使える。とても速い |
ランタイム(bun run / bun index.js) | node | かなり動くが、動かないものもある |
| バンドラ・テストランナー | Vite / Vitest | 発展途上 |
「Bun は速い」と言われているとき、たいていは1つめの話です。 そして1つめだけを使うことができます。 これが実は一番現実的な使い方です。
入れる
その前に unzip が要ります。 Ubuntu Server の最小構成には入っていません。ここを飛ばすと、途中で止まります。
インストールは公式のスクリプトですが、npmの回でやったとおり、curl | bash をそのまま打たずに、先に中身を落として読みます。
less は q で抜けます。「どこから何を落として、どこに置くのか」だけ確認できれば十分です。 ~/.bun に置いて、~/.bashrc にパスを足す、という内容になっているはずです。
パスを通し直します。
1.2.21
bun install の速さを測る
新しいコピーで測ります。
bun install v1.2.21
+ react@19.2.0
+ react-dom@19.2.0
+ vite@7.1.3
213 packages installed [1.42s]
real 0m1.503s
2回目はさらに速くなります。
213 packages installed [412.00ms]
real 0m0.489s
9秒 → 0.5秒です。 ここは、実際に見ると驚きます。
| npm | pnpm | Bun | |
|---|---|---|---|
real(キャッシュあり) | 約9秒 | 約2秒 | 約0.5秒 |
なぜ速いのかは⑧と同じ理屈です。Zig で書かれていて、ファイル操作を並列でやり、システムコールの回数を削っているからです。やっている仕事の中身が根本的に違うわけではありません。
Bun もグローバルキャッシュからハードリンクを張ります。ただしnode_modules の形は npm と同じ「平ら」が既定です。つまり、④の幽霊依存は Bun でも起きます。
まだ全部は動かない
ここは正直に書きます。
bun install はほぼ問題ありません。問題が出るのは bun run でランタイムとして使ったときです。
- 一部の Node.js の機能が未実装、または挙動が違う。減ってはいますが、まだあります
- C++ で書かれたネイティブモジュールが動かないことがある(データベースのドライバなどに多い)
postinstallスクリプトの扱いが npm と違う。Bun は既定で信頼済みのパッケージ以外のスクリプトを実行しません- 周辺ツールが Bun を想定していないことがある
だから、この記事の立場はこうです。
bun installだけを使い、実行はnodeでやる、という使い方は今日から現実的です。bun runでアプリ全体を動かすのは、まだ「試す」段階です。
Vite の開発サーバーも動きます。
動いたら「へえ」で十分です。 ここで本番を移す判断はしません。
⑦ ビルドツールの中身 — Vite の裏で2つ動いている
ビルドツールの回で、Vite は開発と本番で別のやり方を使うと書きました。あれは比喩ではなく、本当に別のプログラムが動いています。
確かめます。ここは、この記事で使った Vite 7(vite@7.1.3)での話です。 2026年3月に出た Vite 8 では esbuild と Rollup が Rolldown 1つに置き換わったので、いま npm create vite@latest で作ったプロジェクトでは、この先の結果が変わります(⑧の最後で触れます)。
esbuild
rollup
両方入っています。 どちらも自分で入れた覚えはありません。Vite が連れてきています。
react-demo@0.0.0 /home/ubuntu/react-demo
└─┬ vite@7.1.3
├── esbuild@0.25.9
└── rollup@4.46.2
実物も動きます。
なぜ2つ要るのか
「速い方(esbuild)だけ使えばいいのでは」と思うところです。目的が違います。
開発中(npm run dev) | 本番(npm run build) | |
|---|---|---|
| 実行回数 | 保存するたび。1日に何百回 | リリース時に1回 |
| 求められるもの | とにかく速いこと | 出力の質(小さい・正しい・分割されている) |
| 出力の大きさ | どうでもいい(自分しか見ない) | ユーザーの通信量そのもの |
| 担当 | esbuild | Rollup |
開発中は「雑でいいから速く」、本番は「遅くていいから良く」。要求が正反対です。
具体的に、Vite の中で esbuild が担当しているのはこの2つです。
- 依存の事前バンドル。
node_modulesの中の何百ファイルを、起動時に数個へまとめる。これをやらないと、ブラウザが数百回リクエストします - TypeScript と JSX の変換。 TypeScriptの回で「型は実行時には消える」とやりました。あの型を消す作業を、保存のたびに esbuild がやっています
Rollup が担当しているのは本番ビルドです。
- tree shaking の質。 「使っていないコードを捨てる」の判定が丁寧
- コード分割(chunk)。ページごとに読み込むファイルを分ける
- プラグインの数。 Vite のプラグインの仕組みは、Rollup のものをそのまま借りています
3つめが決定的でした。Rollup を捨てると、既存のプラグインが全部使えなくなります。
Vite は「独自の高速ビルドツール」ではありません。 「開発は esbuild、本番は Rollup」という役割分担そのものが、Vite 7 までの Vite です。
そして、これには代償があります。 開発中と本番で、別のプログラムが別のやり方でコードを処理しているということは、「開発では動いたのに、本番で壊れる」が起こりうるということです。ビルドツールの回で npm run preview を必ず通すべき、と書いた理由がこれです。
⑧ esbuild と SWC が速い理由 — JavaScriptで書かれていない
理由の1つめは、身も蓋もないものです。
| 道具 | 書かれている言語 |
|---|---|
| webpack / Babel / Rollup | JavaScript |
| esbuild | Go |
| SWC(Babel の置き換え) | Rust |
| Rolldown / Oxc | Rust |
| Bun | Zig |
| Biome(ESLint・Prettier の置き換え) | Rust |
JavaScript のビルドツールが、JavaScript で書かれて、Node.js の上で動いていました。
これが何を意味するか。
- 起動のたびにコードを読んで解釈する。 Goの回で「実行ファイル1つで動く」をやりました。Go や Rust は、CPU が直接読める形にあらかじめ変換済みです
- JavaScript は基本的に1つのことしかできない。 CPU が8コアあっても、素直に書くと1コアしか使いません。Go や Rust は8コアを全部使ってファイルを並列に処理できます
- メモリの扱いを自分で決められる。 JavaScript は自動でゴミを片付けてくれますが、その片付けの時間が積もります
ただし、「言語を変えたから100倍」ではありません。ここは誇張されがちです。
esbuild が速い理由には、言語と関係ない設計判断が同じくらい効いています。
- コードの解析を1回しかやらない。 従来は「Babelが解析→文字列に戻す→webpackがまた解析」と、同じ作業を何度も繰り返していました
- 道具の間でデータを受け渡す形式を、いちいち文字列に戻さない
- 機能を絞っている。 esbuild は「なんでもできる」ことを目指していません
つまり、速さの正体は「言語」+「同じ作業を繰り返さない設計」です。同じ設計のまま JavaScript で書き直しても、かなり速くなります。
Rolldown — 2つを1つにする動き
⑦で「開発と本番で別のプログラムが動く」ことの代償を書きました。この代償をなくそうという動きが Rolldown です。
Rust で書かれた、Rollup と互換のバンドラです。Vite の作者たちが中心になって作っていて、狙いは「Vite の中の esbuild と Rollup を、Rolldown 1つに置き換える」こと。そうすれば開発と本番が同じプログラムで処理されるので、「開発では動いたのに本番で壊れる」が原理的に減ります。 副産物として本番ビルドも速くなります。
移行はすでに終わっています。 2026年3月の Vite 8 で、Vite の中の esbuild と Rollup は Rolldown 1つに置き換わりました(Rolldown 自体も 2026年5月に 1.0 になっています)。⑦で見た2つの役割分担は、この記事で使った Vite 7 までの姿です。この記事では Vite 8 には手を出しませんが、新しく作るプロジェクトは Vite 8 になるので、「Vite の中身はもう入れ替わった」という事実だけは知っておいてください。
⑨ 選び方 — 今から始めるなら npm のままでいい
測って、中を見た上での結論です。
| 状況 | 選ぶもの |
|---|---|
| 学習中・プロジェクトが数個 | npm。 標準で、記事も答えも一番多い |
| プロジェクトが10個以上あり、ディスクが苦しい | pnpm |
| チームで「幽霊依存」の事故が実際に起きた | pnpm |
| モノレポ(1つのリポジトリに複数パッケージ) | pnpm |
| 既存プロジェクトが yarn を使っている | そのまま yarn。 動いているものを移さない |
| CIのインストール時間が本気で問題になっている | Bun(bun install だけ) |
| 速いらしいから | やめる |
このサイトは、この先も npm で進めます。 理由は3つです。
- Node.js に最初から付いてくる。 入れ方の説明が1行も要りません
- 詰まったときに、検索して出てくる答えが npm 前提です。学習中に「道具が違うせいで解決策が使えない」が一番きつい
- 今の自分のプロジェクトは2個。 ③で見たとおり、2個ではディスクは減りません
乗り換えるべきタイミングは、はっきりしています。
du -sh ~/*/node_modulesを打って、自分で「多い」と思ったとき。npm installの待ち時間を、実際に不満に思ったとき。 「書いていないものを import していた」事故に、実際に遭ったとき。
どれも、起きてから動けば間に合います。
⑩ やりすぎない — 道具の乗り換えは、作るものが増えないと意味がない
ここまで書いておいて逆のことを言いますが、この節が一番言いたいことです。
この記事でやったことを並べると、こうなります。
- pnpm を入れた
- Bun を入れた
- 実験用のフォルダを4つ作った
npm installが7秒速くなった
そして、作ったサービスは1つも増えていません。
道具を新しくすることには、独特の気持ちよさがあります。 数字が改善するのが目に見えるし、記事も書きやすいし、詳しくなった感じがします。そして、失敗しません。 うまくいかなくても元に戻すだけなので、「作るもの」と違って、恥ずかしい思いをしません。
だから、ここに逃げ込めてしまいます。
判断の基準を1つだけ持っておきます。
その乗り換えは、「作りたいものが作れるようになる」か。 ならないなら、後回しでいい。
npm install が7秒速くなっても、作れるものは1つも増えません。 一方、④で見た幽霊依存の理屈は、npm のままでも使えて、実際に事故を減らします。 ⑦のesbuild と Rollup の役割分担は、本番だけ壊れたときに、どちらを疑えばいいかを教えてくれます。
この記事で持ち帰るべきなのは、道具ではなく、この2つの理解の方です。
つまずいたところ
pnpm: command not found
npm install -g pnpm は成功したのに、次のログインで消えている場合があります。
nvm で Node.js のバージョンを切り替えたのが原因です。 -g で入れたものはバージョンごとに別の場所に入るので、切り替えると付いてきません。
pnpm の1回目が npm より遅くて、話が違うと思った
これは正常です。 ストアが空なので全部ダウンロードしています。Progress: の reused 0 がその印です。2回目から本領が出ます。
記事やベンチマークが「速い」と言っているのは、ほぼ2回目以降の話です。
du -sh で pnpm が小さくならず、混乱した
③で書いたとおりです。 プロジェクト1個では減りません。そして別々に du -sh を打つと、共有されている実体を二重に数えます。
必ず1回の du にまとめて渡してください。
同じフォルダで npm と pnpm を混ぜて、動かなくなった
npm install 済みのフォルダで pnpm install を打つと、平らな node_modules の上にリンク方式が重なって、中途半端な状態になります。 そのあと npm run dev すると、意味の分からないエラーが出ます。
決まり手は、消して作り直すことです。
ロックファイルも片方に揃えてください(⑤)。
bun install が途中で止まる / インストールできない
unzip が入っていません。
bun を実行したら Illegal instruction (core dumped)
CPU が AVX2 という命令に対応していないと出ます。 古いCPUのPCや、VMware の設定でCPU機能を制限している場合に起きます。
Bun にはその分岐向けのビルド(baseline)が用意されています。
ここで詰まったら、深追いせずに Bun は飛ばして構いません。 この記事の本題は⑦と⑧です。
pnpm にしたら npm run dev が動かなくなった
幽霊依存です(④)。 エラーメッセージに出ているパッケージ名を、そのまま足します。
これは pnpm のバグではなく、package.json が実態と合っていなかったということです。
ストアを消したら、全プロジェクトが壊れた
やってはいけないことです。 node_modules の中身はストアへのハードリンクなので……と言いたいところですが、ハードリンクは元を消しても平気です(実体は名前が0個になるまで消えません)。
壊れるのは rm -rf ~/.local/share/pnpm/store ではなく、pnpm store prune を打ったあとに pnpm install し直したときです。片付けたいときは、先に使っていないプロジェクトの node_modules を消してから pnpm store prune を打ちます。
後片づけ
実験用フォルダを全部消します。
react-demo と tw-demo と web が残っていることを確認してください。 この記事では、元のプロジェクトは1つも書き換えていません。
pnpm のストアを空にします(残しても構いません)。
pnpm 自体を消すなら。
Bun を消すなら。
~/.bashrc の末尾に Bun がパスを追加しているので、それも消します。
末尾にある、この4行あたりを削除して保存します(Ctrl+O → Enter → Ctrl+X)。
# bun
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"
消さなくても害はありません。 ただ、入れたものを戻せる状態にしておくのは、この先ずっと効きます。
まとめ
npm installの遅さの大半はダウンロードではなく、2万個のファイルを作ること。 だから「速い道具」は、ファイルを作る回数を減らしている- npm・yarn・pnpm の違いは機能ではなく
node_modulesの形。 npm と Bun は平ら、pnpm はリンク - pnpm はシンボリックリンクとハードリンクを使い分けている。 「何が見えるか」はシンボリックリンク、「実体を1つにする」のはハードリンク。
ls -lの行頭のlと、stat -c '%h'の 2 が証拠 - pnpm でディスクが減るのは、プロジェクト2個目から。 1個では減らない。別々に
du -shを打つと二重に数えて嘘になる - pnpm の「厳しさ」は、npm の平らな
node_modulesが隠していた事故を、今日エラーにしているだけ。 書いていないものを import できるのは便利ではなく、半年後に理由不明で落ちる仕込み - ロックファイルは3種類あって互換性が無い。 リポジトリに2つ置くと、人によって違うバージョンで作業することになる。移行したら古い方は消す
- CI では必ず「ロックファイルを書き換えないコマンド」を使う。
npm ci/pnpm install --frozen-lockfile/yarn install --immutable。名前が違うだけで、全部同じ思想 - Bun は3つの顔を持つ。
bun installは今すぐ使えて桁違いに速い。bun runでランタイムとして使うのは、まだ試す段階 - Vite は1つのツールではなく、esbuild と Rollup の役割分担そのもの(Vite 7 まで)。 開発は回数が多く質は問われない、本番は1回だけで質が全て。要求が正反対だから2つ要る
- esbuild や SWC が速いのは、ネイティブコードで、並列に動けるから。 ただし「言語を変えたから100倍」ではなく、同じ解析を何度も繰り返さない設計が同じくらい効いている
- Rolldown は、その2つを1つにした。 Vite 8(2026年3月)から、Vite の中身は Rolldown 1つに入れ替わっている
- 今から始めるなら npm のままでいい。 標準で、答えが一番多く、プロジェクトが数個なら pnpm の利点は出ない。このサイトは npm で進める
- 道具の乗り換えは、作るものが増えないと意味がない。
npm installが7秒速くなっても、作れるものは1つも増えていない
参考リンク
- roadmap.sh — Frontend(Package Managers / Module Bundlers の項目)
- pnpm — なぜ pnpm なのか
- pnpm — node_modules の構造
- pnpm — install コマンド
- npm 公式ドキュメント — npm ci
- Node.js 公式 — Corepack
- Yarn 公式
- Bun — インストール
- Bun — bun install
- esbuild — なぜ速いのか(FAQ)
- Vite — なぜ Vite なのか
- Rollup 公式
- Rolldown 公式
- SWC 公式
- man7.org — ln(ハードリンクとシンボリックリンク)
次に読む
この記事は 【第4段階】フロントエンド の 12 / 15 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- npm / yarn / pnpm(ディスクの使い方が違う)
- Bun / esbuild / Rollup / SWC — ビルドの中で何が動いているか
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント