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
jsdomoderhappy-domfür jede Datei. Lösung: wo möglichnodeverwenden. - import / transform hoch: langsame Importe oder Transformationen. Lösung: siehe unten.
- tests hoch: die Tests selbst sind langsam. Die Tests optimieren.
- setup / worker hoch:
setupFilesoder 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
nodeverwenden undjsdompro Datei mit// @vitest-environment jsdomaktivieren. setupFilesschlank halten. Aufwendiges Setup (Starten von Servern, Laden von Fixtures) gehört inglobalSetup, das nur einmal läuft.- In CI
vitest runstatt Watch-Modus verwenden undnode_modulesmit 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
forksist kompatibler mit nativen Addons und prozessbezogenen APIs;threadsstartet oft schneller und benötigt weniger Speicher.isolate: falseverhindert, 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
typechecknicht im Haupt-Unit-Test-Job ausführen, sonderntsc --noEmitin 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.
Verwandt
- Docker-Build in der CI langsam? Ursache finden und behebenDocker-Build in CI zu langsam? Build-Kontext, .dockerignore, Layer-Reihenfolge, Cache-Misses und BuildKit prüfen und zuerst das größte Problem beheben.
- Cypress-Tests zu langsam? So beschleunigen Sie CypressCypress-Tests in CI langsam? Beschleunigen mit cy.session, Intercepts und ohne feste Wartezeiten sowie parallele Cypress-Tests in GitHub Actions.
- Jest langsam? Jest-Tests beschleunigen: Worker und --shardJest-Tests zu langsam? Beschleunigen Sie sie mit schnellerer TypeScript-Transformation, passender Worker-Anzahl und --shard in CI. Mit Konfiguration.
- Playwright-Tests langsam in CI? Mit Workern beschleunigenPlaywright-Tests in CI langsam? Beschleunigen mit mehr Workern, wiederverwendetem storageState, gecachten Browsern und --shard. Auch Python.