npm vs pnpm vs Yarn: パッケージマネージャーの技術的比較

JavaScriptエコシステムにおけるパッケージマネージャーは、依存関係の解決、インストール、スクリプト実行など、開発ワークフローの根幹を支えています。npm、pnpm、yarn はいずれも広く使われているツールですが、内部アーキテクチャや開発体験（DX）には明確な違いがあります。この記事では、プロフェッショナルなフロントエンド開発者の視点から、実際のエンジニアリング課題に即した技術的比較を行います。

📦 依存関係の管理方式：コピー vs シンボリックリンク vs ハードリンク

npm は従来の「ネストされた node_modules」方式を採用しています。各パッケージが自身の依存関係を再帰的に node_modules に配置するため、ディスク使用量が膨大になりやすく、重複インストールが発生します。

# npm install の結果（例）
node_modules/
├── lodash/
└── express/
    └── node_modules/
        └── lodash/  # 同じ lodash が複数回インストールされる可能性あり

pnpm は「コンテンツアドレス可能なストア」を用いて、すべてのパッケージをグローバルに1回だけ保存し、プロジェクト内ではシンボリックリンクとハードリンクで参照します。これにより、ディスク使用量が劇的に削減され、node_modules の構造もフラットになります。

# pnpm install の結果（例）
node_modules/
├── .pnpm/
│   ├── lodash@4.17.21 → /store/v3/lodash/4.17.21
│   └── express@4.18.2 → /store/v3/express/4.18.2
└── lodash → .pnpm/lodash@4.17.21/node_modules/lodash

yarn（Classic および Berry）は、Yarn Classic では npm と似たネスト方式でしたが、Yarn Berry（v2+）では Plug’n’Play（PnP）という新しい方式を導入しました。PnP では node_modules を完全に排除し、.pnp.cjs というファイルで依存関係を記述し、Node.js のモジュール解決をフックして直接パッケージストアから読み込みます。

# yarn install (Berry/PnP) の結果（例）
.pnp.cjs          # 依存関係マップ
.yarn/cache/      # 圧縮されたパッケージキャッシュ

💡 注意：Yarn Classic（v1）は依然としてメンテナンスされていますが、新規プロジェクトでは Yarn Berry（v2+）が推奨されています。本比較では Yarn Berry を前提とします。

⚡ インストール速度とディスク効率

npm は v7 以降でワークスペース（monorepo）サポートや --prefer-dedupe オプションを追加し、改善されていますが、依然として大量のファイルI/Oを伴うため、大規模プロジェクトでは遅くなりがちです。

# npm のワークスペース設定（package.json）
{
  "workspaces": ["packages/*"]
}

pnpm はハードリンクとシンボリックリンクにより、同じパッケージを複数プロジェクトで共有してもディスク容量を節約できます。また、node_modules がフラットなため、Node.js のモジュール解決も高速です。

# pnpm のワークスペース設定（pnpm-workspace.yaml）
packages:
  - 'packages/*'

yarn（Berry）の PnP 方式は、node_modules の作成をスキップするため、インストールが非常に高速です。ただし、一部のツール（特に古いBabelプラグインやESLint設定）が PnP に対応していない場合があり、互換性レイヤー（node-modules プラグイン）を使う必要があります。

# yarn のワークスペース設定（package.json）
{
  "workspaces": ["packages/*"]
}

🔒 モノレポとワークスペースの扱い

すべてのパッケージマネージャーはモノレポをサポートしていますが、その設計思想は異なります。

npm のワークスペースはシンプルで、ルートの package.json に workspaces フィールドを定義するだけで、各パッケージ間のリンクが自動的に行われます。

# npm でのパッケージ間依存
# packages/app/package.json
{
  "dependencies": {
    "ui-components": "workspace:*"
  }
}

pnpm も同様に workspace:* 構文をサポートし、さらに pnpm install -r で全ワークスペースを一括インストールできます。また、pnpm recursive コマンド（旧称）で全パッケージにコマンドを実行可能です。

# pnpm での全パッケージテスト実行
pnpm -r test

yarn（Berry）は yarn workspaces foreach で全ワークスペースにコマンドを実行でき、より柔軟なフィルタリング（--include、--exclude）が可能です。

# yarn での全パッケージビルド（ただし test-* 以外）
yarn workspaces foreach --exclude "test-*" run build

🛠️ スクリプト実行と拡張性

npm は npm run でスクリプトを実行し、npm exec（または npx）でローカル/グローバルコマンドを実行できます。拡張性は限定的で、主に scripts フィールドとライフサイクルフックに依存します。

// package.json
{
  "scripts": {
    "dev": "vite",
    "postinstall": "husky install"
  }
}

pnpm は pnpm run でスクリプトを実行し、pnpm dlx で一時的なコマンド実行をサポートします。また、pnpmfile.js（旧）や hooks（v8+）で依存関係解決をカスタマイズできます。

// .pnpmfile.cjs（例：特定パッケージの依存を上書き）
module.exports = {
  hooks: {
    readPackage(pkg) {
      if (pkg.name === 'problematic-lib') {
        pkg.dependencies = { ...pkg.dependencies, 'lodash': '^4.17.21' };
      }
      return pkg;
    }
  }
};

yarn（Berry）は yarn run でスクリプトを実行し、yarn dlx で一時コマンドを実行します。さらに、Yarn はプラグインシステムを備えており、@yarnpkg/plugin-* で機能を拡張できます（例：plugin-interactive-tools で対話型アップグレード）。

# yarn の対話型依存更新
yarn up -i

🔄 依存関係の更新とセキュリティ

npm は npm audit で脆弱性をチェックし、npm update で依存を更新できます。ただし、package-lock.json の競合解決は手動で行う必要があることが多いです。

npm audit
npm update lodash

pnpm は pnpm audit（内部で npm audit をラップ）で脆弱性をチェックし、pnpm update で更新します。pnpm outdated で更新可能なパッケージを確認可能です。

pnpm audit
pnpm update --latest

yarn（Berry）は yarn npm audit で脆弱性をチェックし、yarn up で依存を更新します。yarn dedupe で重複を最適化することもできます。

yarn npm audit
yarn up lodash@latest

🌐 オフラインとキャッシュ戦略

npm は ~/.npm にキャッシュを保存し、オフラインでも npm ci が可能ですが、ロックファイルがないと不安定です。

pnpm はグローバルストア（~/.pnpm-store）にすべてのパッケージを保存するため、同じバージョンのパッケージはネットワークアクセスなしで再利用できます。

yarn（Berry）は .yarn/cache に圧縮されたパッケージを保存し、.yarnrc.yml でキャッシュ戦略をカスタマイズできます。また、Zero-Installs（.yarn/cache をリポジトリに含める）により、yarn install が不要になるケースもあります。

# .yarnrc.yml
enableGlobalCache: false

📊 実際の選択基準：チームとプロジェクトに合わせて

大規模モノレポでディスク容量を節約したい場合

→ pnpm が最適です。ハードリンクによるストレージ効率と、フラットな node_modules による高速解決が魅力です。

最新技術を積極的に取り入れ、高度なカスタマイズが必要な場合

→ yarn（Berry）が向いています。PnP、プラグインシステム、Zero-Installs などの先進機能が活きます。

汎用性と安定性を重視し、学習コストを最小限に抑えたい場合

→ npm が無難です。Node.js 標準搭載で、ほとんどのCI/CD環境やツールがネイティブサポートしています。

📌 まとめ：主な違い一覧

💡 結論

• npm は「何も考えずに使える安心感」が強み。社内ツールや小〜中規模プロジェクトに最適。
• pnpm は「効率と整合性」を追求。大規模モノレポやCI環境での高速化が求められる場面で真価を発揮。
• yarn（Berry）は「最先端と制御力」が売り。高度なワークフローを構築したいチーム向け。

最終的には、チームのスキルセット、既存ツールチェーン、プロジェクト規模を総合的に判断して選ぶべきです。どれも成熟したツールであり、正解は「あなたのプロジェクトに最もフィットするもの」です。