Vite als Build-Tool: Vom Entwicklungsserver zum Produktions-Build

Was beim Befehl vite build passiert, wie Assets, Umgebungsvariablen und TypeScript behandelt werden und was Vite 8 mit Rolldown verändert hat
Aktualisiert:
Abstract
- #Vite
- #Build-Tool
- #Webentwicklung
- #Produktions-Builds
- #Rolldown
- #Hot Module Replacement
- #TypeScript
- #Umgebungsvariablen
- #JavaScript
- #Vue.js
Ein Werkzeug, zwei Betriebsarten: Warum Vite in der Entwicklung anders arbeitet als im Build und worauf Teams beim Ausliefern achten sollten
Auf dem Laptop läuft die Anwendung tadellos, auf dem Testserver fehlen plötzlich Bilder, ein API-Schlüssel steht im Klartext im ausgelieferten JavaScript, und das Hauptpaket ist drei Megabyte groß. Solche Überraschungen entstehen selten im Code selbst, sondern zwischen Entwicklung und Auslieferung. Genau dort arbeitet ein Build-Tool.
Vite ist heute das verbreitetste Werkzeug dieser Art im Frontend. Bekannt wurde es vor allem durch seinen schnellen Entwicklungsserver. Wie der funktioniert, erklärt unser Überblick Vite: Warum das Build-Tool die Frontend-Entwicklung beschleunigt. Dieser Beitrag widmet sich der anderen Hälfte: dem Produktions-Build, der Konfiguration und den Stellen, an denen Projekte in der Praxis häufig stolpern.
Zwei Betriebsarten mit unterschiedlichen Aufgaben
Vite arbeitet in zwei klar getrennten Modi. Im Entwicklungsmodus (vite oder npm run dev) liefert ein lokaler Server den Quellcode als einzelne ES-Module aus, also in der standardisierten import-/export-Form, die alle aktuellen Browser direkt verstehen. Jede Datei wird erst übersetzt, wenn der Browser sie anfordert. Änderungen landen per Hot Module Replacement (HMR) im laufenden Browser, ohne dass die Seite neu lädt.
Im Build-Modus (vite build) gilt eine andere Logik. Hunderte einzelne Module wären für Nutzerinnen und Nutzer über ein Mobilfunknetz zu langsam. Deshalb bündelt Vite den Code zu wenigen Dateien, entfernt ungenutzten Code (Tree Shaking), verkleinert alles (Minifizierung) und versieht die Dateinamen mit einem Hash aus dem Inhalt. Ändert sich eine Datei, ändert sich ihr Name, und der Browser lädt sie neu. Unveränderte Dateien darf er beliebig lange aus dem Cache nehmen.
Der dritte Befehl, vite preview, startet einen einfachen Server für das fertige Ergebnis im Ordner dist. Er ersetzt keinen Produktionsserver, zeigt aber, ob der Build so funktioniert wie die Entwicklungsfassung. Standardmäßig läuft der Entwicklungsserver auf Port 5173, die Vorschau auf Port 4173.
Daraus folgt eine wichtige Regel: Was im Entwicklungsmodus funktioniert, ist noch nicht getestet. Angenommen, ein Team baut ein Bestellformular für einen Webshop und prüft es nur mit npm run dev. Ein Fehler beim Bündeln, etwa ein falscher Pfad zu einer Schriftdatei, fällt erst nach dem Deployment auf. Wer vor jedem Release einmal vite build und vite preview ausführt oder das in der CI-Pipeline automatisiert, erspart sich solche Abende.
Was sich mit Vite 8 und Rolldown geändert hat
Bis Version 7 arbeiteten unter der Haube zwei Werkzeuge: esbuild, ein in Go geschriebener Bundler, für die Vorbereitung der Abhängigkeiten und die Übersetzung im Entwicklungsmodus, und Rollup, ein ausgereifter JavaScript-Bundler, für den Produktions-Build. Diese Arbeitsteilung war schnell, hatte aber einen Haken: Zwei Werkzeuge verhalten sich nie ganz gleich. In seltenen Fällen lief Code im Entwicklungsmodus anders als nach dem Build.
Seit Vite 8, erschienen im März 2026, übernimmt der in Rust geschriebene Bundler Rolldown beide Aufgaben. Für das Übersetzen von TypeScript und JSX sowie für die Minifizierung kommt Oxc zum Einsatz, eine ebenfalls in Rust geschriebene Sammlung von JavaScript-Werkzeugen. Beides entsteht im Umfeld von VoidZero, dem Unternehmen, das Vite-Erfinder Evan You 2024 gegründet hat. Rolldown unterstützt die Plugin-Schnittstelle von Rollup, sodass die meisten bestehenden Plugins weiter funktionieren.
Für die meisten Projekte bedeutet das: schnellere Builds und ein einheitlicheres Verhalten, ohne dass am eigenen Code etwas zu ändern ist. Wer allerdings viele Spezialeinstellungen für den Bundler gesetzt hat, sollte die Migrationshinweise lesen. Die Optionen unter build.rollupOptions heißen seit Vite 8 build.rolldownOptions. Wer von einer Version vor Vite 7 umsteigt, braucht außerdem mindestens Node.js 20.19 oder 22.12. Unsere Empfehlung: Den Umstieg in einem eigenen Branch durchführen und die Größe und Anzahl der erzeugten Dateien vor und nach dem Update vergleichen.
Die Konfiguration im Überblick
Vite kommt ohne Konfiguration aus, solange die Standardwerte passen. Sobald eine Anwendung in einem Unterverzeichnis liegt, ältere Browser bedienen muss oder Fehler im Produktivbetrieb nachvollziehbar sein sollen, lohnt sich eine vite.config.ts:
import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
export default defineConfig({
plugins: [vue()],
// Die Anwendung wird unter https://example.com/portal/ ausgeliefert
base: '/portal/',
build: {
outDir: 'dist',
// Quellkarten erleichtern die Fehlersuche im Produktivbetrieb
sourcemap: true,
// Warnung erst ab 800 kB pro Datei statt ab dem Standardwert
chunkSizeWarningLimit: 800,
},
});
Die Option base wird oft vergessen. Liegt die Anwendung nicht im Wurzelverzeichnis der Domain, zeigen ohne sie alle Verweise auf Skripte und Bilder ins Leere. Mit build.target lässt sich festlegen, für welche Browser der Code übersetzt wird. Standardmäßig zielt Vite auf Browser, die moderne JavaScript-Funktionen breit unterstützen. Für ältere Browser gibt es das offizielle Plugin @vitejs/plugin-legacy.
Quellkarten (Source Maps) verbinden den verkleinerten Code mit dem ursprünglichen Quelltext. Ob sie öffentlich ausgeliefert werden sollen, ist eine Abwägung: Sie erleichtern die Fehlersuche, machen den Quelltext aber für jeden lesbar. Viele Teams laden sie deshalb nur in ihr Fehler-Monitoring hoch und liefern sie nicht mit aus.
Assets: src oder public
Bilder, Schriften und andere Dateien behandelt Vite auf zwei Wegen, und die Wahl entscheidet über das Caching.
Dateien, die im Code importiert werden, etwa aus src/assets, durchlaufen den Build. Sie erhalten einen Hash im Dateinamen, und Vite ersetzt den Import durch die endgültige URL. Sehr kleine Dateien bettet Vite direkt als Base64-Daten in den Code ein und spart so eine Anfrage an den Server. Die Grenze liegt standardmäßig bei 4 KiB und lässt sich über build.assetsInlineLimit ändern.
import logoUrl from './assets/logo.svg';
// Inhalt einer Datei als Text, etwa für Vorlagen
import agb from './texte/agb.md?raw';
document.querySelector('img#logo')?.setAttribute('src', logoUrl);
Dateien im Ordner public kopiert Vite dagegen unverändert in das Ausgabeverzeichnis. Sie behalten ihren Namen und werden im Code über einen absoluten Pfad wie /robots.txt angesprochen. Das passt für Dateien, deren Adresse feststehen muss: robots.txt, Favicons oder Dateien, auf die externe Systeme verweisen. Für alles andere ist der Weg über src besser, weil Vite fehlende Dateien dann schon beim Build meldet statt erst im Browser.
Umgebungsvariablen und die Sicherheitsfrage
Vite liest Umgebungsvariablen aus Dateien wie .env, .env.local und .env.production. Im Code stehen sie unter import.meta.env bereit, ergänzt um eingebaute Werte wie MODE, DEV, PROD und BASE_URL.
# .env.production
VITE_API_URL=https://api.example.com
# Ohne Präfix: nur für Build-Skripte, nicht für den Browser
DATENBANK_PASSWORT=geheim
Im Client-Code landen nur Variablen mit dem Präfix VITE_. Das ist eine Schutzmaßnahme, aber keine Verschlüsselung: Vite ersetzt import.meta.env.VITE_API_URL beim Build durch den Wert, und dieser steht danach im Klartext in der ausgelieferten JavaScript-Datei. Jeder, der die Seite öffnet, kann ihn lesen. API-Schlüssel mit Schreibrechten, Datenbankzugänge oder Tokens für Bezahldienste gehören deshalb nie in eine VITE_-Variable, sondern auf einen Server, der die Anfrage stellvertretend ausführt.
Damit TypeScript die eigenen Variablen kennt, lassen sie sich in einer Deklarationsdatei beschreiben:
// src/vite-env.d.ts
/// <reference types="vite/client" />
interface ImportMetaEnv {
readonly VITE_API_URL: string;
}
interface ImportMeta {
readonly env: ImportMetaEnv;
}
TypeScript: übersetzt, aber nicht geprüft
Vite versteht TypeScript ohne zusätzliche Einrichtung. Es entfernt allerdings nur die Typangaben und prüft sie nicht. Das ist eine bewusste Entscheidung für Geschwindigkeit: Die Typprüfung eines großen Projekts dauert Sekunden, die Übersetzung einer einzelnen Datei Millisekunden. Ein Typfehler bricht den Entwicklungsserver deshalb nicht ab.
Die Typprüfung übernehmen der Editor und ein eigener Schritt vor dem Build. Die meisten offiziellen TypeScript-Vorlagen erledigen das bereits im Build-Skript, etwa die für React:
{
"scripts": {
"dev": "vite",
"build": "tsc -b && vite build",
"preview": "vite preview"
}
}
Wer ein bestehendes JavaScript-Projekt umstellt, kann schrittweise vorgehen: zuerst tsconfig.json und Deklarationsdatei anlegen, dann einzelne Dateien von .js auf .ts umbenennen und typisieren. Vite verarbeitet beide Dateiarten nebeneinander. Wie ein solcher Umstieg in größeren Codebasen geplant werden kann, beschreibt der Leitfaden JavaScript zu TypeScript migrieren.
Von Webpack oder Create React App zu Vite
Viele Teams kommen nicht mit einem neuen Projekt zu Vite, sondern mit einer älteren Anwendung. Das React-Team hat Create React App Anfang 2025 für neue Projekte abgekündigt, und viele Webpack-Konfigurationen stammen aus einer Zeit, in der niemand mehr weiß, warum jede Zeile darin steht.
Eine Migration betrifft meist dieselben Stellen:
- Einstiegspunkt: Bei Vite liegt
index.htmlim Projektwurzelverzeichnis und bindet den Code als Modul ein. Webpack erzeugt die HTML-Datei dagegen oft aus einer Vorlage. - Umgebungsvariablen: Aus
process.env.REACT_APP_…wirdimport.meta.env.VITE_…. Hier lohnt eine projektweite Suche. - Modulsystem: Vite erwartet ES-Module. Aufrufe von
require()im Anwendungscode müssen zuimportwerden; an die Stelle vonrequire.contexttrittimport.meta.glob. - Loader: Was bei Webpack ein Loader für SVG, Markdown oder Spezialformate war, ist bei Vite ein Plugin. Für verbreitete Fälle gibt es fertige Lösungen.
<!-- index.html im Projektwurzelverzeichnis -->
<div id="app"></div>
<script type="module" src="/src/main.ts"></script>
Bei kleinen bis mittleren Anwendungen ist die Umstellung oft in wenigen Tagen erledigt. Aufwendiger wird es, wenn Webpack-Spezialitäten wie Module Federation für Micro-Frontends im Einsatz sind oder Bibliotheken noch im alten CommonJS-Format ausgeliefert werden. Solche Fälle sollten vorab an einem Prototyp geprüft werden.
Plugins mit Bedacht auswählen
Vite hält seinen Kern schlank. Framework-Unterstützung, Kompatibilität mit älteren Browsern oder die Erzeugung eines Service Workers kommen über Plugins hinzu. Neben den offiziellen Plugins wie @vitejs/plugin-vue und @vitejs/plugin-react gibt es eine große Zahl aus der Community, etwa vite-plugin-pwa für Progressive Web Apps.
Jedes Plugin ist allerdings eine Abhängigkeit, die gepflegt werden muss und bei großen Versionssprüngen wie dem auf Vite 8 zum Hindernis werden kann. Vor der Aufnahme lohnt ein Blick darauf, wann das Plugin zuletzt aktualisiert wurde und ob es die aktuelle Vite-Version unterstützt. Für einfache Aufgaben genügt oft ein eigenes Plugin aus wenigen Zeilen oder eine eingebaute Funktion wie der Import mit ?raw.
Was das für Ihr Team bedeutet
Für neue Frontend-Projekte ohne Meta-Framework ist Vite die naheliegende Wahl, und wer Nuxt, SvelteKit oder Astro nutzt, arbeitet ohnehin bereits damit. Die eigentliche Arbeit liegt weniger in der Einrichtung als in einigen Regeln, die das ganze Team kennen sollte: den Build vor jedem Release lokal oder in der CI prüfen, Assets bewusst zwischen src und public aufteilen, keine Geheimnisse in VITE_-Variablen ablegen und die Typprüfung als eigenen Schritt behandeln.
Überschätzt wird dagegen oft der Geschwindigkeitsgewinn im Produktions-Build. Ob ein Build 20 oder 60 Sekunden dauert, spielt für die meisten Teams eine kleinere Rolle als eine überschaubare Konfiguration und wenige, gut gepflegte Plugins. Bestehende Webpack-Projekte, die zuverlässig laufen, müssen nicht sofort umgestellt werden. Ein Wechsel lohnt sich, wenn ohnehin größere Umbauten anstehen oder die alte Konfiguration zum Wartungsproblem geworden ist.
Wer Vite in einem bestehenden Projekt einführen, eine Migration planen oder ein Team schulen möchte, findet auf unserer Seite zu Vite-Beratung, Coaching und Seminaren die passenden Angebote.
Häufige Fragen zum Build mit Vite
Warum ist das Hauptpaket nach dem Build so groß?
Meist steckt eine große Bibliothek darin, die überall importiert wird. Dynamische Importe mit import() teilen selten genutzte Bereiche, etwa einen Administrationsbereich, in eigene Dateien auf, die erst bei Bedarf geladen werden. Ein Analyse-Plugin zeigt, welche Pakete wie viel Platz belegen.
Kann Vite auch Bibliotheken statt Anwendungen bauen?
Ja. Im sogenannten Bibliotheksmodus (build.lib) erzeugt Vite Pakete für die Veröffentlichung auf npm, etwa eine interne Komponentenbibliothek. Abhängigkeiten wie Vue oder React werden dabei üblicherweise als extern markiert, damit sie nicht doppelt im Paket landen.
Ist Vite nur für Vue.js gedacht?
Nein. Vite stammt zwar vom Vue-Erfinder, ist aber seit Version 2 unabhängig von einem Framework. Es gibt offizielle Vorlagen für React, Svelte, Solid, Lit und reines JavaScript, jeweils auch mit TypeScript.
Brauchen wir neben Vite noch ein Testwerkzeug?
Vite selbst testet nichts. Naheliegend ist Vitest, ein Testframework, das dieselbe Konfiguration und dieselben Plugins nutzt wie die Anwendung. So entfällt eine zweite, abweichende Build-Konfiguration nur für Tests.
Kategorien