Skip to content

Befehlszeilen-Schnittstelle (CLI) ​

Prozess-Locks ​

Die Befehle vite, vite build und vite preview erstellen Lock-Dateien im Unterverzeichnis lock des cacheDir. Gehört ein Lock zu einem anderen laufenden Prozess mit demselben Befehl, demselben Projektstammverzeichnis, derselben Konfigurationsdatei und demselben Modus, beendet sich Vite. Um eine weitere Instanz auszuführen, übergeben Sie --bypass-lock.

Entwicklungs-Server ​

vite ​

Startet den Vite-Entwicklungs-Server im aktuellen Verzeichnis. vite dev und vite serve sind Aliasnamen für vite.

Verwendung ​

bash
vite [root]

Optionen ​

Optionen
--host [host]Gibt den Hostnamen an (string)
--port <port>Gibt den Port an (number)
--open [path]Öffnet den Browser beim Starten (boolean | string)
--corsAktiviert CORS (boolean)
--strictPortBeendet den Vorgang, wenn der angegebene Port bereits verwendet wird (boolean)
--forceZwingt den Optimierer, den Cache zu ignorieren und neu zu bündeln (boolean)
--experimentalBundleVerwendet den experimentellen Full-Bundle-Modus (hochgradig experimentell) (boolean)
--bypass-lockErlaubt die Ausführung parallel zu einem anderen Vite-Prozess für dieses Projekt (boolean)
-c, --config <file>Verwendet die angegebene Konfigurationsdatei (string)
--base <path>Öffentlicher Basispfad (Standard: /) (string)
-l, --logLevel <level>info | warn | error | silent (string)
--clearScreenErlaubt/deaktiviert das Löschen des Bildschirms beim Protokollieren (boolean)
--configLoader <loader>Verwenden Sie bundle, um die Konfiguration mit Rolldown zu bündeln, oder native, um sie mit der nativen Laufzeitumgebung zu laden (Standard: bundle)
--profile [name]Startet den integrierten Node.js-Inspector und schreibt das Profil nach <name>.cpuprofile (siehe Performance Engpässe) (boolean | string)
-d, --debug [feat]Zeigt Debug-Protokolle an (string | boolean)
-f, --filter <filter>Filtert Debug-Protokolle (string)
-m, --mode <mode>Setzt den Umgebungsmodus (string)
-h, --helpZeigt verfügbare CLI-Optionen an
-v, --versionZeigt die Versionsnummer an

Erstellen ​

vite build ​

Erstellt für die Produktion.

Verwendung ​

bash
vite build [root]

Optionen ​

Optionen
--target <target>Transpile-Ziel (Standard: "baseline-widely-available") (string)
--outDir <dir>Ausgabe Verzeichnis (Standard: dist) (string)
--assetsDir <dir>Verzeichnis unter outDir, um Assets abzulegen (Standard: "assets") (string)
--assetsInlineLimit <number>Schwellenwert für statische Asset-Base64-Inlines in Byte (Standard: 4096) (number)
--ssr [entry]Erstellt angegebenen Eintrag für das Server-seitige Rendern (string)
--sourcemap [output]Erzeugt Sourcemap-Dateien für das Build (Standard: false) (boolean | "inline" | "hidden")
--minify [minifier]Aktiviert/deaktiviert die Minifizierung oder gibt den Minifizierer an, der verwendet werden soll (Standard: "oxc") (boolean | "oxc" | "terser" | "esbuild")
--manifest [name]Erzeugt Build-Manifest JSON (boolean | string)
--ssrManifest [name]Erzeugt SSR-Manifest JSON (boolean | string)
--emptyOutDirLeert das Ausgabeverzeichnis, wenn es außerhalb des Stammverzeichnisses liegt (boolean)
-w, --watchErstellt erneut, wenn Module auf der Festplatte geändert wurden (boolean)
--bypass-lockErlaubt die Ausführung parallel zu einem anderen Vite-Prozess für dieses Projekt (boolean)
-c, --config <file>Verwendet die angegebene Konfigurationsdatei (string)
--base <path>Öffentlicher Basispfad (Standard: /) (string)
-l, --logLevel <level>info | warn | error | silent (string)
--clearScreenErlaubt/deaktiviert das Löschen des Bildschirms beim Protokollieren (boolean)
--configLoader <loader>Verwenden Sie bundle, um die Konfiguration mit Rolldown zu bündeln, oder native, um sie mit der nativen Laufzeitumgebung zu laden (Standard: bundle)
--profile [name]Startet den integrierten Node.js-Inspector und schreibt das Profil nach <name>.cpuprofile (siehe Performance Engpässe) (boolean | string)
-d, --debug [feat]Zeigt Debug-Protokolle an (string | boolean)
-f, --filter <filter>Filtert Debug-Protokolle (string)
-m, --mode <mode>Setzt den Umgebungsmodus (string)
-h, --helpZeigt verfügbare CLI-Optionen an
--appAlle Umgebungen bauen, wie bei builder.entireApp (boolean, experimentell)

Andere ​

vite optimize ​

Abhängigkeiten vorab bündeln.

Veraltet: Der Vorab-Bündelungsprozess läuft automatisch ab und muss nicht aufgerufen werden.

Verwendung ​

bash
vite optimize [root]

Optionen ​

Optionen
--forceZwingt den Optimierer, den Cache zu ignorieren und neu zu bündeln (boolean)
-c, --config <file>Verwendet die angegebene Konfigurationsdatei (string)
--base <path>Öffentlicher Basispfad (Standard: /) (string)
-l, --logLevel <level>info | warn | error | silent (string)
--clearScreenErlaubt/deaktiviert das Löschen des Bildschirms beim Protokollieren (boolean)
--configLoader <loader>Verwenden Sie bundle, um die Konfiguration mit Rolldown zu bündeln, oder native, um sie mit der nativen Laufzeitumgebung zu laden (Standard: bundle)
-d, --debug [feat]Zeigt Debug-Protokolle an (string | boolean)
-f, --filter <filter>Filtert Debug-Protokolle (string)
-m, --mode <mode>Setzt den Umgebungsmodus (string)
-h, --helpZeigt verfügbare CLI-Optionen an

vite preview ​

Lokale Vorschau der Produktionsversion. Verwenden Sie dies nicht als Produktions-Server, da es nicht dafür ausgelegt ist.

Dieser Befehlt startet einen Server im Build-Verzeichnis (standardmäßig dist). Führen Sie vite build zuvor aus, um sicherzustellen, dass das Build-Verzeichnis aktuell ist. Abhängig von der Projektkonfiguration für appType, wird bestimmte Middleware verwendet.

Verwendung ​

bash
vite preview [root]

Optionen ​

Optionen
--host [host]Gibt den Hostnamen an (string)
--port <port>Gibt den Port an (number)
--strictPortBeendet den Vorgang, wenn der angegebene Port bereits verwendet wird (boolean)
--open [path]Öffnet den Browser beim Starten (boolean | string)
--outDir <dir>Ausgabe Verzeichnis (Standard: dist) (string)
--bypass-lockErlaubt die Ausführung parallel zu einem anderen Vite-Prozess für dieses Projekt (boolean)
-c, --config <file>Verwendet die angegebene Konfigurationsdatei (string)
--base <path>Öffentlicher Basispfad (Standard: /) (string)
-l, --logLevel <level>info | warn | error | silent (string)
--clearScreenErlaubt/deaktiviert das Löschen des Bildschirms beim Protokollieren (boolean)
--configLoader <loader>Verwenden Sie bundle, um die Konfiguration mit Rolldown zu bündeln, oder native, um sie mit der nativen Laufzeitumgebung zu laden (Standard: bundle)
-d, --debug [feat]Zeigt Debug-Protokolle an (string | boolean)
-f, --filter <filter>Filtert Debug-Protokolle (string)
-m, --mode <mode>Setzt den Umgebungsmodus (string)
-h, --helpZeigt verfügbare CLI-Optionen an