Zum Inhalt springen

Vitest langsam in CI? Start, Imports und Pools optimieren

Zuletzt aktualisiert

Wenn Vitest langsam ist, liegt die Ursache fast immer an einem von vier Punkten: Erstellung der Umgebung, langsame Importe, Overhead durch Testisolation oder zu wenige Worker in CI. Dieser Leitfaden erklärt, warum Vitest beim Start und in CI langsam ist, wie Sie langsame Importe beheben, langsame Tests finden und die Tests sharden. Er ist ein Schwesterleitfaden von Jest langsam und Teil des Clusters langsame E2E-Tests.

Vitest ändert Optionsnamen zwischen Hauptversionen, besonders bei Pools. Wo ein Name wichtig ist, prüfen Sie die Konfigurationsreferenz für Ihre Version.

Zuerst profilieren: die Duration-Zeile

Die Zusammenfassungszeile von Vitest zeigt, wo die Zeit verbraucht wurde:

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

Die Prozentwerte sind Anteile der erfassten Zeit über alle Worker, nicht der Wanduhrzeit. Lesen Sie sie als Diagnose:

  • environment hoch: Erstellung von jsdom oder happy-dom für jede Datei. Lösung: wo möglich node verwenden.
  • import / transform hoch: langsame Importe oder Transformationen. Lösung: siehe unten.
  • tests hoch: die Tests selbst sind langsam. Die Tests optimieren.
  • setup / worker hoch: setupFiles oder Isolations-Overhead pro Datei.

Langsamer Vitest-Start

Der Startaufwand fällt pro Lauf und bei aktiver Isolation pro Testdatei an. So reduzieren Sie ihn:

  • Standardmäßig die Umgebung node verwenden und jsdom pro Datei mit // @vitest-environment jsdom aktivieren.
  • setupFiles schlank halten. Aufwendiges Setup (Starten von Servern, Laden von Fixtures) gehört in globalSetup, das nur einmal läuft.
  • In CI vitest run statt Watch-Modus verwenden und node_modules mit dem setup-node-Cache zwischenspeichern. Siehe Caching in GitHub Actions.

Langsame Vitest-Importe

Vitest wertet in jeder isolierten Testdatei jedes importierte Modul aus. Importieren viele Dateien denselben großen Graphen, zahlt jede ihn erneut. Die häufigste Ursache sind Barrel-Dateien: import { x } from "@/components" lädt jede Komponente.

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

Weitere Lösungen: große Module, die der Test nicht braucht, mit vi.mock mocken, das Importieren ganzer Icon- oder Utility-Bibliotheken vermeiden und, sofern Ihre Version es bietet, die Importaufschlüsselung in der Vitest-UI prüfen. Importiert eine Datei 2.000 Module, um eine Funktion zu testen, ist der Import die eigentliche Testkost.

Pool- und Isolationseinstellungen

Vitest führt Testdateien in Worker-Pools aus (Threads oder geforkte Prozesse). Die Wahl und die Isolationseinstellung tauschen Geschwindigkeit gegen Sicherheit:

// 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 ist kompatibler mit nativen Addons und prozessbezogenen APIs; threads startet oft schneller und benötigt weniger Speicher.
  • isolate: false verhindert, dass gemeinsame Importe für jede Datei neu ausgewertet werden, was Import- und Worker-Zeit stark senken kann. Das Risiko: gemeinsamer Zustand wandert zwischen Dateien. Aktivieren Sie es nur, wenn Ihre Tests keinen modulweiten Zustand oder keine globalen Variablen verändern. Neuere Versionen erlauben zudem Isolationseinstellungen pro Datei oder pro Projekt.
  • Die Anzahl der Worker richtet sich standardmäßig nach den verfügbaren Kernen. Auf einem Runner mit 2 vCPUs haben Sie ein oder zwei Worker, weshalb sich CI langsam anfühlt. Setzen Sie die Option für die maximale Workeranzahl für Ihre Version, wenn Sie mehr Kerne oder weniger Speicher haben.

Ändern Sie jeweils nur eine Einstellung und vergleichen Sie die Duration-Zeile.

Vitest: langsame Tests finden

Der verbose-Reporter zeigt die Dauern, die Option slowTestThreshold markiert langsame Tests (Standard 300 ms):

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

Sortieren Sie das JSON nach Dauer, um Ihre Top 20 zu erhalten. Oft sind die langsamsten Tests solche mit echten Timern, echtem Netzwerk oder echten Datenbanken. Verwenden Sie Fake Timers (vi.useFakeTimers()) und Mocks oder verschieben Sie diese Tests in ein separates Integrationsprojekt.

Vitest langsam speziell in CI

Neben den oben genannten Einstellungen:

  • Weniger Kerne: CI-Runner sind kleiner als Laptops. Lokal mit derselben Workeranzahl vergleichen.
  • Kalte Caches: Abhängigkeiten cachen; der Transform-Cache von Vite liegt in node_modules/.vite, und ihn zu persistieren hilft bei Wiederholungsläufen auf demselben Code.
  • Coverage: Coverage-Instrumentierung kann Läufe deutlich verlangsamen. Coverage in einem Job ausführen, nicht in jedem Shard.
  • Typprüfung: den Modus typecheck nicht im Haupt-Unit-Test-Job ausführen, sondern tsc --noEmit in einem eigenen Job.

Vitest über Jobs verteilen

Vitest unterstützt --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-Reports der Shards lassen sich mit vitest --merge-reports zusammenführen, für kombinierte Ausgabe und Coverage. Details zu Lastverteilung und Kosten stehen im Leitfaden zum Test-Sharding, und der Planer schlägt eine Shard-Anzahl vor.

Mehr Kerne

Sobald die Einstellungen angepasst sind, skalieren Test-Suites, die sich über mehrere Dateien erstrecken, mit der Anzahl der Kerne. Die Optionen finden Sie unter schnellere GitHub Actions Runner. compiler.dev war über 18 gemessene Stacks hinweg im Median 1,5× schneller (15 schneller, 2 gleich, 1 langsamer) als der 2-Kern-Runner von GitHub. Der Vergleichsmodus misst Ihre eigenen Jobs. Für die gesamte Pipeline starten Sie beim Hub für langsame CI.

FAQ

Warum ist Vitest beim Start langsam?

Meist liegt es an der Erstellung der Umgebung (jsdom), an aufwendigen setupFiles oder an einem großen Importgraphen, der für jede Datei wiederholt wird. Die Zeile „Duration“ zeigt, welcher Grund zutrifft.

Warum ist Vitest in der CI langsam, lokal aber schnell?

Die CI hat weniger Kerne, einen kalten Cache und führt womöglich Coverage- oder Typprüfungen aus, die Sie lokal überspringen.

Wie finde ich langsame Tests in Vitest?

Verwenden Sie --reporter=verbose und slowTestThreshold, oder schreiben Sie die Ausgabe als JSON und sortieren Sie nach der Dauer.

Ist es sicher, isolate auf false zu setzen?

Nur, wenn die Tests keinen veränderlichen Modulzustand teilen. Bei sicherem Einsatz bringt es einen großen Geschwindigkeitsgewinn. Testen Sie es an Ihrer Suite und achten Sie auf reihenfolgeabhängige Fehlschläge.

Lassen Sie diese Vitest-Tests auf compiler.dev laufen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen