node_modulesが重い理由 — pnpmとBunを測る

pnpmとBunを測る。パッケージの箱と共有する接続線、ストップウォッチ。

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倍」ではない

この記事でやること

  1. ~/react-demo/ をコピーした実験用フォルダを作り、time npm install と du -sh node_modules で現状を数字にする
  2. pnpm を入れて、同じプロジェクトで測り直す。 ls -l と stat でシンボリックリンクとハードリンクを実際に見る
  3. 同じプロジェクトを2つ用意して、npm と pnpm でディスク使用量を比べる(ここが山場)
  4. npm では通り、pnpm では落ちるコードを書いて、幽霊依存を再現する
  5. Bun を入れて bun install の速さを測り、動かないものがあることも確認する
  6. node_modules の中に esbuild と Rollup が両方いることを確認して、なぜ2つ要るのかを読む

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
inode(アイノード)Linux がファイルの実体1つに振っている番号。名前ではなく中身の側に付く
ハードリンク同じ inode にもう1つ名前を付けること。実体は1つなので、ディスクは増えない。コピーではない
シンボリックリンク「あっちを見て」と別の場所を指し示すだけの小さなファイル。Windowsのショートカットに近い
グローバルストアpnpm がパッケージの実体をPC全体で1箇所に貯めておく場所。各プロジェクトはそこへのリンクを持つ
pnpmperformant npm。ストア+リンク方式のパッケージマネージャ
yarnnpm より先にロックファイルと速度を持ち込んだパッケージマネージャ。現在は v1 と v2以降で別物
幽霊依存(phantom dependency)package.json に書いていないのに import できてしまうパッケージ。ある日突然消える
Bunランタイム(node の代わり)とパッケージマネージャ(npm の代わり)を兼ねる道具。Zig で書かれている
ランタイムJavaScript を実際に実行するプログラムそのもの。Node.js や Bun がこれ
ネイティブコードCPU が直接実行できる形にあらかじめ変換済みのプログラム。Go や Rust はこれを作る
SWCRust で書かれたトランスパイラ。Babel の置き換えとして使われる
RolldownRust で書かれたバンドラ。Vite の中の esbuild と Rollup を1つにまとめようとしている

① まず測る — 「遅い」「重い」を数字にする

感想のまま乗り換えると、良くなったかどうかが判定できません。 先に数字を作ります。

実験用にコピーを作る

~/react-demo/ は触りません。 Reactの回で作ったものを、そのまま残します。

VMの中の Ubuntu で打ちます。

bash
$ cd ~
$ cp -r react-demo pm-demo
$ rm -rf pm-demo/node_modules pm-demo/dist
$ ls pm-demo
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 に組み込みで入っているので、追加のインストールは要りません。

bash
$ cd ~/pm-demo
$ time npm install
added 213 packages in 9s

real	0m9.412s
user	0m9.106s
sys	0m2.310s

3つの数字が出ます。読むのは real です。

行意味
real実際に待たされた時間(時計の時間)。体感はこれ
userCPU がプログラムの計算に使った時間
sysCPU が OS の仕事(ファイル書き込みなど)に使った時間

何がどれだけあるのか測る

bash
$ du -sh node_modules
$ ls node_modules | wc -l
$ find node_modules -type f | wc -l
118M	node_modules
216
19842

数字は環境で違います。 大事なのは3つ目です。

フォルダは216個。でもファイルは約2万個あります。

これが「遅い」の正体でした。ネットからのダウンロードより、2万個のファイルをディスクに書く方が時間を食っています。 だから2回目の npm install は速いのに(ダウンロードはキャッシュから)、rm -rf node_modules してからやり直すと、また同じくらいかかります。

確かめます。

bash
$ rm -rf node_modules
$ time npm install

ネットに1バイトも取りに行っていないのに、ほとんど同じ時間がかかったはずです。

ここで一番大事なこと。 npm install の遅さは「回線が遅いから」ではありません。 大半はファイルを作る作業です。 だから「速いパッケージマネージャ」は、ダウンロードを速くしているのではなく、ファイルを作る回数を減らしています。

[スクリーンショット: 01_npm測定.png] time npm install と du -sh node_modules、find node_modules -type f | wc -l を続けて実行した結果を、まとめて1枚で撮ってください。


② パッケージマネージャは3つある — 違いはディスクの使い方

名前を並べると、こうなります。

名前出てきた時期何のために作られたか
npm2010〜Node.js に最初から付いてくる。標準
yarn2016〜npm が遅く、ロックファイルも無かった時代への回答
pnpm2017〜同じパッケージを何度もディスクに書くのをやめるための道具

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 の要らないやり方を選びます。

bash
$ npm install -g pnpm
$ pnpm --version
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 を自動で使わせるものです。

bash
$ corepack enable pnpm

package.json にこう書いておくと、チーム全員が同じバージョンを使います。

{
  "packageManager": "pnpm@10.15.1"
}

この記事では npm install -g pnpm で進めます。 Corepack は Node.js のバージョンによって扱いが変わるので、最初の1回は素直な方を使います。

pnpm で入れ直して測る

同じフォルダで npm と pnpm を混ぜてはいけません。 先に消します。

bash
$ cd ~/pm-demo
$ rm -rf node_modules
$ time pnpm install

1回目は、想像より遅いはずです。

Packages: +213
Progress: resolved 213, reused 0, downloaded 213, added 213, done

real	0m21.087s

「速いって聞いたのに」と思うところです。 理由は reused 0 です。ストアが空なので、全部ダウンロードしています。 ここは正直に書きます。pnpm の1回目は npm より遅いことがあります。

2回目を測ります。

bash
$ rm -rf node_modules
$ time pnpm install
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 を見る

ここが、この記事で一番見てほしいところです。

bash
$ ls -lA node_modules | head
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個ありました。

bash
$ ls node_modules | wc -l
5

package.json に書いたものだけです。 scheduler はいません。

実体は .pnpm の中にあります。

bash
$ ls node_modules/.pnpm | head -5
$ ls node_modules/.pnpm | wc -l
@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 がそのファイルを指している名前の数です。

bash
$ stat -c '%i %h %s %n' node_modules/.pnpm/react@19.2.0/node_modules/react/package.json
1442361 2 1234 node_modules/.pnpm/react@19.2.0/node_modules/react/package.json

%h が 2 です。 つまり、この中身を指している名前が、ディスク上に2つあるということです。もう1つはストアの中にあります。

比較のために、npm のときはこうでした。

bash
$ cd ~/react-demo
$ stat -c '%i %h %s %n' node_modules/react/package.json
1439102 1 1234 node_modules/react/package.json

%h が 1。この中身を指しているのは、この名前だけです。 キャッシュからコピーされたものだからです。

ハードリンクとシンボリックリンクは、まったくの別物です。

シンボリックリンクハードリンク
中身「あっちを見て」というパスの文字列実体そのものへの、もう1つの名前
ls -ll で始まり -> が出る普通のファイルと見分けが付かない
元を消すとリンクが切れて壊れる平気(名前が1つ減るだけ)
ディスクほぼ00(実体は増えない)
pnpm での役割node_modules/react → .pnpm/react@19.2.0/….pnpm/… の中身 → グローバルストア

pnpm はこの2つを使い分けています。 「どのパッケージが見えるか」の管理はシンボリックリンクで、「実体を1つにする」のはハードリンクです。

ストアの場所はこれで分かります。

bash
$ pnpm store path
/home/ubuntu/.local/share/pnpm/store/v10

ディスクは「2個目のプロジェクト」で減る

ここで、多くの記事が書いていないことを書きます。

bash
$ cd ~/pm-demo
$ du -sh node_modules
115M	node_modules

npm のときは 118M でした。ほとんど減っていません。

「pnpm は容量が減る」は、嘘ではありませんが、プロジェクト1個では起きません。 du は実体のあるファイルのサイズを数えるので、ハードリンクだろうと1回は数えます。このプロジェクトが使っているファイルの合計は、npm でも pnpm でも同じです。

減るのは2個目からです。 実際にやります。

bash
$ cd ~
$ cp -r react-demo pm-demo2
$ rm -rf pm-demo2/node_modules pm-demo2/dist
$ cd ~/pm-demo2
$ pnpm install

そして、2つをまとめて測ります。ここが肝心です。

bash
$ cd ~
$ du -csh pm-demo/node_modules pm-demo2/node_modules
115M	pm-demo/node_modules
1.8M	pm-demo2/node_modules
117M	total

2個目が 1.8M です。 ゼロではないのは、シンボリックリンクとディレクトリの分です。中身は1バイトも増えていません。

npm で同じことをすると、こうなります。

bash
$ cd ~
$ cp -r react-demo pm-demo3
$ rm -rf pm-demo3/node_modules pm-demo3/dist
$ cd ~/pm-demo3 && npm install
$ cd ~
$ du -csh react-demo/node_modules pm-demo3/node_modules
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 で入れた方のプロジェクトで打ちます。

bash
$ cd ~/react-demo
$ node -e "console.log(require.resolve('scheduler'))"
/home/ubuntu/react-demo/node_modules/scheduler/index.js

package.json を見てください。scheduler はどこにも書いていません。

bash
$ grep scheduler package.json

何も出ません。書いていないのに、使えます。 これが幽霊依存です。

pnpm では落ちる

bash
$ cd ~/pm-demo
$ node -e "console.log(require.resolve('scheduler'))"
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 の厳しさは、この事故を「今日、目に見える形で」起こしているだけです。 半年後に理由不明で落ちるか、今日エラーで止まるか。 どちらがいいかという話です。

直し方は簡単

エラーが出たら、書けばいいだけです。

bash
$ pnpm add scheduler

「厳しくて使えない」と感じたときの正体は、たいてい「自分の package.json が実態と合っていなかった」です。

npm のままでも、この考え方は持ち帰れます。 import する前に、それが package.json に書いてあるか確認する。 書いていないなら npm install で足す。それだけで、この事故は起きません。


⑤ ロックファイルは3つあって、互換性が無い

npmの回で package-lock.json をやりました。「実際に何のどのバージョンを入れたか」の記録です。

問題は、パッケージマネージャごとに別のファイルを作ることです。

道具ロックファイル形式
npmpackage-lock.jsonJSON
yarnyarn.lock独自
pnpmpnpm-lock.yamlYAML
Bunbun.lockJSONC(以前は bun.lockb というバイナリ)

中身は互換ではありません。 移行時に読み取ってくれるものはありますが(pnpm は package-lock.json を読んで pnpm-lock.yaml を作ります)、「両方置いておけば両方使える」ではありません。

さっきの pnpm install のあと、フォルダを見てください。

bash
$ cd ~/pm-demo
$ ls *.json *.yaml
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人が違うバージョンのパッケージで作業していて、誰も気づきません。 そして片方だけを更新するので、時間が経つほどズレが広がります。

移行したら、古い方は消してコミットします。

bash
$ rm package-lock.json

逆に、npm のままでいるなら pnpm-lock.yaml を消します。 どちらか1つだけがリポジトリにある状態を保ちます。

npm ci との関係

npm ci は「ロックファイルだけを見て、書き換えない」コマンドでした。これに相当するものが、どの道具にもあります。

道具手元で開発するときCI・本番でのコマンド
npmnpm installnpm ci
yarn(v2以降)yarn installyarn install --immutable
pnpmpnpm installpnpm install --frozen-lockfile
Bunbun installbun 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 の最小構成には入っていません。ここを飛ばすと、途中で止まります。

bash
$ sudo apt update
$ sudo apt install -y unzip

インストールは公式のスクリプトですが、npmの回でやったとおり、curl | bash をそのまま打たずに、先に中身を落として読みます。

bash
$ cd ~
$ curl -fsSL https://bun.sh/install -o bun-install.sh
$ less bun-install.sh

less は q で抜けます。「どこから何を落として、どこに置くのか」だけ確認できれば十分です。 ~/.bun に置いて、~/.bashrc にパスを足す、という内容になっているはずです。

bash
$ bash bun-install.sh

パスを通し直します。

bash
$ source ~/.bashrc
$ bun --version
1.2.21

bun install の速さを測る

新しいコピーで測ります。

bash
$ cd ~
$ cp -r react-demo pm-demo4
$ rm -rf pm-demo4/node_modules pm-demo4/dist pm-demo4/package-lock.json
$ cd ~/pm-demo4
$ time 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回目はさらに速くなります。

bash
$ rm -rf node_modules
$ time bun install
 213 packages installed [412.00ms]

real	0m0.489s

9秒 → 0.5秒です。 ここは、実際に見ると驚きます。

npmpnpmBun
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 の開発サーバーも動きます。

bash
$ bunx --bun vite --host 0.0.0.0

動いたら「へえ」で十分です。 ここで本番を移す判断はしません。


⑦ ビルドツールの中身 — Vite の裏で2つ動いている

ビルドツールの回で、Vite は開発と本番で別のやり方を使うと書きました。あれは比喩ではなく、本当に別のプログラムが動いています。

確かめます。ここは、この記事で使った Vite 7(vite@7.1.3)での話です。 2026年3月に出た Vite 8 では esbuild と Rollup が Rolldown 1つに置き換わったので、いま npm create vite@latest で作ったプロジェクトでは、この先の結果が変わります(⑧の最後で触れます)。

bash
$ cd ~/react-demo
$ ls node_modules | grep -E '^(esbuild|rollup)$'
esbuild
rollup

両方入っています。 どちらも自分で入れた覚えはありません。Vite が連れてきています。

bash
$ npm ls esbuild rollup
react-demo@0.0.0 /home/ubuntu/react-demo
└─┬ vite@7.1.3
  ├── esbuild@0.25.9
  └── rollup@4.46.2

実物も動きます。

bash
$ ./node_modules/.bin/esbuild --version
$ ./node_modules/.bin/rollup --version

なぜ2つ要るのか

「速い方(esbuild)だけ使えばいいのでは」と思うところです。目的が違います。

開発中(npm run dev)本番(npm run build)
実行回数保存するたび。1日に何百回リリース時に1回
求められるものとにかく速いこと出力の質(小さい・正しい・分割されている)
出力の大きさどうでもいい(自分しか見ない)ユーザーの通信量そのもの
担当esbuildRollup

開発中は「雑でいいから速く」、本番は「遅くていいから良く」。要求が正反対です。

具体的に、Vite の中で esbuild が担当しているのはこの2つです。

  1. 依存の事前バンドル。 node_modules の中の何百ファイルを、起動時に数個へまとめる。これをやらないと、ブラウザが数百回リクエストします
  2. TypeScript と JSX の変換。 TypeScriptの回で「型は実行時には消える」とやりました。あの型を消す作業を、保存のたびに esbuild がやっています

Rollup が担当しているのは本番ビルドです。

  1. tree shaking の質。 「使っていないコードを捨てる」の判定が丁寧
  2. コード分割(chunk)。ページごとに読み込むファイルを分ける
  3. プラグインの数。 Vite のプラグインの仕組みは、Rollup のものをそのまま借りています

3つめが決定的でした。Rollup を捨てると、既存のプラグインが全部使えなくなります。

Vite は「独自の高速ビルドツール」ではありません。 「開発は esbuild、本番は Rollup」という役割分担そのものが、Vite 7 までの Vite です。

そして、これには代償があります。 開発中と本番で、別のプログラムが別のやり方でコードを処理しているということは、「開発では動いたのに、本番で壊れる」が起こりうるということです。ビルドツールの回で npm run preview を必ず通すべき、と書いた理由がこれです。


⑧ esbuild と SWC が速い理由 — JavaScriptで書かれていない

理由の1つめは、身も蓋もないものです。

道具書かれている言語
webpack / Babel / RollupJavaScript
esbuildGo
SWC(Babel の置き換え)Rust
Rolldown / OxcRust
BunZig
Biome(ESLint・Prettier の置き換え)Rust

JavaScript のビルドツールが、JavaScript で書かれて、Node.js の上で動いていました。

これが何を意味するか。

  1. 起動のたびにコードを読んで解釈する。 Goの回で「実行ファイル1つで動く」をやりました。Go や Rust は、CPU が直接読める形にあらかじめ変換済みです
  2. JavaScript は基本的に1つのことしかできない。 CPU が8コアあっても、素直に書くと1コアしか使いません。Go や Rust は8コアを全部使ってファイルを並列に処理できます
  3. メモリの扱いを自分で決められる。 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つです。

  1. Node.js に最初から付いてくる。 入れ方の説明が1行も要りません
  2. 詰まったときに、検索して出てくる答えが npm 前提です。学習中に「道具が違うせいで解決策が使えない」が一番きつい
  3. 今の自分のプロジェクトは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 で入れたものはバージョンごとに別の場所に入るので、切り替えると付いてきません。

bash
$ nvm current
$ npm install -g pnpm

pnpm の1回目が npm より遅くて、話が違うと思った

これは正常です。 ストアが空なので全部ダウンロードしています。Progress: の reused 0 がその印です。2回目から本領が出ます。

記事やベンチマークが「速い」と言っているのは、ほぼ2回目以降の話です。

du -sh で pnpm が小さくならず、混乱した

③で書いたとおりです。 プロジェクト1個では減りません。そして別々に du -sh を打つと、共有されている実体を二重に数えます。

bash
$ du -csh ~/pm-demo/node_modules ~/pm-demo2/node_modules

必ず1回の du にまとめて渡してください。

同じフォルダで npm と pnpm を混ぜて、動かなくなった

npm install 済みのフォルダで pnpm install を打つと、平らな node_modules の上にリンク方式が重なって、中途半端な状態になります。 そのあと npm run dev すると、意味の分からないエラーが出ます。

決まり手は、消して作り直すことです。

bash
$ rm -rf node_modules
$ pnpm install

ロックファイルも片方に揃えてください(⑤)。

bun install が途中で止まる / インストールできない

unzip が入っていません。

bash
$ sudo apt install -y unzip

bun を実行したら Illegal instruction (core dumped)

CPU が AVX2 という命令に対応していないと出ます。 古いCPUのPCや、VMware の設定でCPU機能を制限している場合に起きます。

Bun にはその分岐向けのビルド(baseline)が用意されています。

bash
$ curl -fsSL https://bun.sh/install -o bun-install.sh
$ BUN_VERSION_VARIANT=baseline bash bun-install.sh

ここで詰まったら、深追いせずに Bun は飛ばして構いません。 この記事の本題は⑦と⑧です。

pnpm にしたら npm run dev が動かなくなった

幽霊依存です(④)。 エラーメッセージに出ているパッケージ名を、そのまま足します。

bash
$ pnpm add <エラーに出ているパッケージ名>

これは pnpm のバグではなく、package.json が実態と合っていなかったということです。

ストアを消したら、全プロジェクトが壊れた

やってはいけないことです。 node_modules の中身はストアへのハードリンクなので……と言いたいところですが、ハードリンクは元を消しても平気です(実体は名前が0個になるまで消えません)。

壊れるのは rm -rf ~/.local/share/pnpm/store ではなく、pnpm store prune を打ったあとに pnpm install し直したときです。片付けたいときは、先に使っていないプロジェクトの node_modules を消してから pnpm store prune を打ちます。


後片づけ

実験用フォルダを全部消します。

bash
$ cd ~
$ rm -rf pm-demo pm-demo2 pm-demo3 pm-demo4
$ ls

react-demo と tw-demo と web が残っていることを確認してください。 この記事では、元のプロジェクトは1つも書き換えていません。

pnpm のストアを空にします(残しても構いません)。

bash
$ pnpm store prune
$ du -sh $(pnpm store path)

pnpm 自体を消すなら。

bash
$ npm uninstall -g pnpm

Bun を消すなら。

bash
$ rm -rf ~/.bun
$ rm ~/bun-install.sh

~/.bashrc の末尾に Bun がパスを追加しているので、それも消します。

bash
$ nano ~/.bashrc

末尾にある、この4行あたりを削除して保存します(Ctrl+O → Enter → Ctrl+X)。

# bun
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"
bash
$ source ~/.bashrc

消さなくても害はありません。 ただ、入れたものを戻せる状態にしておくのは、この先ずっと効きます。


まとめ

  • 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つも増えていない

参考リンク


次に読む

この記事は 【第4段階】フロントエンド の 12 / 15 本目です。

記事
← 前の記事Reactにできないことがある — Web Components
→ 次の記事E2Eはsleepで待たない — Playwrightで1本目

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›Package Managers
  • npm / yarn / pnpm(ディスクの使い方が違う)
  • Bun / esbuild / Rollup / SWC — ビルドの中で何が動いているか

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次