コンテンツへスキップ

CIでVitestが遅い? 起動、インポート、プールを修正する

最終更新

Vitestが遅いとき、原因はほとんどの場合次の4つのいずれかです。環境の作成、インポートの遅さ、テストの分離によるオーバーヘッド、CIでのワーカー数の不足です。本ガイドでは、起動時やCIでVitestが遅くなる理由、インポートの高速化、遅いテストの見つけ方、分割実行の方法を取り上げます。Jestが遅いガイドの姉妹編であり、遅いE2Eテストのクラスターの一部です。

Vitestはメジャーバージョン間でオプション名を変更することがあり、特にプールに関連する名前が該当します。名前が重要な場合は、お使いのバージョンの設定リファレンスを確認してください。

まずプロファイリング:Durationの行

Vitestのサマリー行には、時間がどこで使われたかの内訳が表示されます。

Duration 3.76s (environment 79%, import 13%, transform 6%, tests 1%, setup 1%)

割合は、ウォールクロック時間ではなく、全ワーカーの計測時間に対する比率です。次のように診断に使ってください。

  • environmentが高い:ファイルごとにjsdomやhappy-domを作成している。対策:可能な場合はnodeを使用してください。
  • import / transformが高い:インポートや変換が遅い。対策:下記を参照してください。
  • testsが高い:テスト自体が遅い。テストを修正してください。
  • setup / workerが高い:ファイルごとのsetupFilesや分離のオーバーヘッド。

Vitestの起動が遅い

起動コストは実行ごとに発生し、分離が有効な場合はテストファイルごとにも発生します。これを減らすには次のとおりです。

  • デフォルトではnode環境を使用し、必要なファイルだけ// @vitest-environment jsdomでjsdomを有効にしてください。
  • setupFilesは軽く保ってください。重いセットアップ(サーバーの起動、フィクスチャの読み込み)は、一度だけ実行されるglobalSetupに置きます。
  • CIでは、ウォッチモードではなくvitest runを実行し、setup-nodeのキャッシュでnode_modulesをキャッシュしてください。GitHub Actionsのキャッシュを参照してください。

Vitestのインポートが遅い

Vitestは分離された各テストファイルで、インポートされたすべてのモジュールを評価します。多数のファイルが同じ大きなモジュールグラフをインポートしていると、そのたびにコストが発生します。最も一般的な原因はバレルファイルです。import { x } from "@/components"は、すべてのコンポーネントを読み込んでしまいます。

// slow: loads the whole barrel
import { Button } from "@/components";
// fast: loads one module
import { Button } from "@/components/Button";

その他の対策として、テストで不要な重いモジュールはモック(vi.mock)し、アイコンや ユーティリティライブラリ全体のインポートは避けてください。バージョンによっては、VitestのUIでインポートの内訳を確認できます。1つの関数をテストするために2,000個のモジュールをインポートしているなら、そのインポートこそがテストの実際のコストです。

プールと分離の設定

Vitestはテストファイルをワーカープール(スレッドまたはフォークprocess)で実行します。その選択と分離の設定は、速度と安全性のトレードオフになります。

// vitest.config.ts
import { defineConfig } from "vitest/config";

export default defineConfig({
  test: {
    pool: "threads",     // or "forks" (safer with native modules)
    isolate: false,      // reuse the module graph between files; faster, riskier
  },
});
npx vitest run --pool=threads
npx vitest run --pool=forks
  • forksはネイティブアドオンやプロセスレベルのAPIとの互換性が高く、threadsは起動が速く、メモリ消費も少ない場合があります。
  • isolate: falseを指定すると、ファイルごとに共有インポートを再評価しなくなるため、インポートとワーカーの時間を大幅に減らせる場合があります。ただし、共有状態がファイル間で漏れるリスクがあるため、テストがモジュールレベルの状態やグローバルを変更しない場合にのみ有効にしてください。新しいバージョンでは、ファイル単位またはプロジェクト単位で分離設定を指定することもできます。
  • ワーカー数は、デフォルトで利用可能なコア数に従います。2 vCPUのランナーでは、ワーカーは1つか2つになるため、CIが遅く感じられるのです。コアが多い場合やメモリが少ない場合は、お使いのバージョンの最大ワーカー数オプションを設定してください。

一度に1つの設定だけを変更し、Durationの行で比較してください。

Vitest:遅いテストを見つける

verboseレポーターで所要時間を確認し、slowTestThresholdオプションで遅いテストにフラグを付けます(デフォルトは300ミリ秒)。

test: { slowTestThreshold: 500 }
npx vitest run --reporter=verbose
npx vitest run --reporter=json --outputFile=report.json

JSONを所要時間で並べ替えて、上位20件を確認します。多くの場合、最も遅いのは実際のタイマー、実際のネットワーク、実際のデータベースを使うテストです。フェイクタイマー(vi.useFakeTimers())やモックを使うか、別の統合テストプロジェクトに移してください。

特にCIでVitestが遅い

上記の設定に加えて、次の点も確認してください。

  • コア数が少ない:CIランナーはノートPCより小さいです。同じワーカー数でローカルと比較してください。
  • キャッシュが冷えている:依存関係をキャッシュしてください。Viteの変換キャッシュはnode_modules/.viteにあり、これを保持すると同じコードの再実行が速くなることがあります。
  • カバレッジ:カバレッジの計測により、実行が大幅に遅くなることがあります。カバレッジは、すべてのシャードではなく1つのジョブで実行してください。
  • 型チェック:メインのユニットテストジョブ内でtypecheckモードを実行しないでください。tsc --noEmitは独立したジョブで実行してください。

Vitestをジョブ間で分割実行する

Vitestは--shardをサポートしています。

strategy:
  fail-fast: false
  matrix:
    shard: [1, 2, 3]
steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-node@v4
    with: { node-version: 22, cache: npm }
  - run: npm ci
  - run: npx vitest run --shard=${{ matrix.shard }}/3 --reporter=blob

シャードのblobレポートはvitest --merge-reportsで統合でき、結合された出力やカバレッジを得られます。負荷分散とコストの詳細はテストの分割実行ガイドで、シャード数の目安はプランナーで確認できます。

コアを増やす

設定を調整したあとは、複数のファイルにまたがるスイートはコア数に応じてスケールします。選択肢については高速なGitHub Actionsランナーを参照してください。compiler.devは、GitHubの2コアランナーと比べて、18の計測済みスタック全体で中央値1.5倍高速でした(15件は高速、2件は同等、1件は低速)。比較モードでは、お使いのジョブを直接計測できます。パイプライン全体については、遅いCIのハブから始めてください。

よくある質問

Vitestが起動時に遅いのはなぜですか?

多くの場合、環境の作成(jsdom)、重いsetupFiles、またはファイルごとに繰り返される大規模なimportグラフが原因です。どれが原因かは、Durationの行を見て確認できます。

Vitestの実行がCIでは遅いのに、ローカルでは速いのはなぜですか?

CIはCPUコア数が少なく、キャッシュが空の状態で始まります。さらに、ローカルでは省いているカバレッジ計測や型チェックを実行している場合もあります。

Vitestで遅いテストを見つけるにはどうすればよいですか?

--reporter=verboseとslowTestThresholdを使うか、JSON形式で出力して実行時間順に並べ替えてください。

isolateをfalseに設定しても安全ですか?

テストが変更可能なモジュールの状態を共有していない場合に限り安全です。安全に設定できれば大幅な高速化につながります。ただし、ご使用のテストスイートで試し、実行順序に依存する失敗が起きないか確認してください。

compiler.devでこのVitestテストを実行 カード登録不要 · 200 無料分

無料で試す