モノレポ管理ツールの技術的比較：Lerna、Nx、Turborepo

JavaScript/TypeScript のモノレポ管理には、lerna、nx、turbo（Turborepo）という3つの主要な選択肢があります。これらは「複数のパッケージを1つのリポジトリで管理する」という共通の目標を持ちますが、アプローチと機能範囲は大きく異なります。この記事では、実際の開発シナリオに基づいて、各ツールの強み・弱みを深く掘り下げます。

📦 パッケージ管理とバージョニング：公開の自動化

lerna は、もともと npm パッケージのバージョニングと公開を目的として開発されました。lerna version と lerna publish コマンドにより、変更のあったパッケージだけを自動的にバージョンアップし、npm に公開できます。

// lerna.json
{
  "version": "independent",
  "packages": ["packages/*"]
}

# 変更のあったパッケージだけをバージョンアップ
lerna version --conventional-commits

# 公開
lerna publish from-git

nx にも nx release コマンド（v18以降）が追加されましたが、従来はバージョニング機能が弱く、多くのチームが Lerna と併用していました。現在は Nx 単体でも可能ですが、Lerna ほどの成熟度はありません。

# Nx のリリース機能（ベータ段階）
nx release version
nx release publish

turbo は、バージョニングや公開機能を一切提供しません。これは意図的な設計で、Turborepo は「タスクランナー」に特化しており、パッケージ公開は別ツール（例: Changesets、Lerna）に任せる想定です。

💡 ポイント：npm パッケージを頻繁に公開するライブラリ中心のモノレポでは、lerna が依然として有力な選択肢です。一方、アプリケーション中心のモノレポ（例: 複数のフロントエンド + バックエンド）では、バージョニング機能は不要なことが多く、nx や turbo の方が適しています。

⚡ タスク実行とキャッシュ：ビルド・テストの高速化

lerna のタスク実行（例: lerna run build）は、パッケージ間の依存関係を考慮して順序を決定しますが、キャッシュ機能がありません。毎回フルビルドになるため、大規模なモノレポでは時間がかかります。

# lerna は依存関係順にビルドするが、キャッシュなし
lerna run build --scope=app-web

nx は、ローカルおよびリモートの高度なキャッシュ機構を備えています。タスクの入力（ソースコード、依存関係、環境変数など）に基づいてハッシュを計算し、同じ入力であれば結果を再利用します。さらに、affected コマンドで変更の影響を受けたプロジェクトだけを実行できます。

# 影響を受けたプロジェクトだけをビルド
nx affected:build

# キャッシュヒット時は「retrieved from cache」と表示

// nx.json
{
  "tasksRunnerOptions": {
    "default": {
      "runner": "nx/tasks-runners/default",
      "options": {
        "cacheableOperations": ["build", "test", "lint"]
      }
    }
  }
}

turbo も同様に、インクリメンタルなキャッシュを提供しますが、設定が極めてシンプルです。turbo.json でパイプラインを定義するだけで、依存関係に基づく並列実行とキャッシュが有効になります。

// turbo.json
{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    },
    "test": {
      "dependsOn": ["build"],
      "inputs": ["src/**", "test/**"]
    }
  }
}

# turbo は自動でキャッシュを活用
turbo run build

💡 ポイント：nx と turbo はどちらもキャッシュで高速化しますが、nx はより詳細な制御（例: キャッシュの無効化条件、カスタムハッシュアルゴリズム）が可能で、turbo は「設定不要」の哲学でシンプルさを重視しています。

🧩 ワークスペース構造と依存関係管理

lerna は、packages/ 配下の各ディレクトリを独立した npm パッケージとして扱います。依存関係は package.json の dependencies で管理され、lerna bootstrap でシンボリックリンクを作成します（ただし、最近の Lerna は Yarn/PNPM のワークスペース機能を推奨しており、bootstrap は非推奨）。

// packages/app/package.json
{
  "name": "@myorg/app",
  "dependencies": {
    "@myorg/ui": "*"
  }
}

nx は、ワークスペース内に「プロジェクト」としてアプリやライブラリを定義します。project.json（または package.json）で各プロジェクトのメタデータを管理し、nx graph コマンドで依存関係を可視化できます。

// apps/web/project.json
{
  "name": "web",
  "targets": {
    "build": {
      "executor": "@nx/next:build",
      "outputs": ["{options.outputPath}"]
    }
  }
}

# 依存関係グラフをブラウザで表示
nx graph

turbo は、Yarn/PNPM/NPM のネイティブなワークスペース機能に完全に依存します。package.json の workspaces フィールドでパッケージを定義し、Turborepo 自体はワークスペース構造を認識しません。

// package.json (root)
{
  "workspaces": ["apps/*", "packages/*"]
}

💡 ポイント：nx は独自のプロジェクトメタデータを持ち、高度な分析が可能ですが、turbo は既存のパッケージマネージャーの仕組みをそのまま使うため、移行コストが低いです。

🛠️ 開発者体験（DX）とエコシステム統合

lerna は、最小限の機能に絞られており、コード生成や高度なLintルールなどは提供しません。他のツール（例: ESLint、Prettier）との統合は手動で行う必要があります。

nx は、コード生成（Schematics） や コンテキスト感知Lint（例: 使用していない依存関係の検出）など、豊富なDX機能を提供します。また、React、Angular、Node.js など多数のフレームワーク向けの公式プラグインがあります。

# Nx で React コンポーネントを生成
nx g @nx/react:component button --project=ui

turbo は、Vercel 社が開発しており、Next.js、Remix、SvelteKit などと緊密に統合されています。例えば、Next.js プロジェクトでは turbo run dev で高速な開発サーバーが起動します。

// turbo.json for Next.js
{
  "pipeline": {
    "dev": {
      "persistent": true,
      "cache": false
    }
  }
}

# 高速な並列開発サーバー
turbo run dev

💡 ポイント：Vercel エコシステム（特に Next.js）を使っているなら、turbo は最小限の設定で最大の恩恵を受けられます。一方、多様な技術スタックを管理する大規模チームでは、nx の包括的な機能セットが有利です。

🌐 リモートキャッシュとCI統合

lerna は、リモートキャッシュ機能を提供していません。CI上での高速化は、自前でキャッシュを実装する必要があります。

nx は、Nx Cloud（商用サービス）またはセルフホスト可能な分散キャッシュをサポートしています。CI上でビルド結果を共有し、チーム全体でキャッシュを再利用できます。

# Nx Cloud に接続
nx connect-to-nx-cloud

turbo も、Vercel Remote Caching を無料で提供しています。turbo token を設定するだけで、CIやローカル間でキャッシュを共有できます。

# Vercel Remote Cache を有効化
echo "TURBO_TOKEN=your_token" >> .env.local

💡 ポイント：リモートキャッシュは nx と turbo の共通の強みですが、turbo の方が設定が簡単で、無料で利用できます。nx の Nx Cloud はより詳細な分析ダッシュボードを提供します。

📊 まとめ：各ツールの適正シナリオ

💡 最終的な判断基準

• ライブラリ中心のモノレポで、npm 公開が主目的 → lerna（ただし、Changesets との併用も検討）
• 大規模アプリケーション群を含むモノレポで、包括的なDXと分析が必要 → nx
• 既存のビルドツールを活かしつつ、最小限の設定で高速化したい → turbo

現代のモノレポでは、lerna 単体ではなく、turbo + changesets や nx + lerna といった組み合わせも一般的です。プロジェクトの規模、チームのスキルセット、使用技術スタックを考慮して、最適なツールを選んでください。