diff --git a/docs/config/index.md b/docs/config/index.md index 18ac9b16..f01a51e4 100644 --- a/docs/config/index.md +++ b/docs/config/index.md @@ -22,8 +22,10 @@ Sie können auch explizit eine Konfigurationsdatei angeben, die mit der CLI-Opti vite --config my-config.js ``` -::: Tipp: Bündeln der Konfiguration -Standardmäßig nutzt Vite `esbuild`, um die Konfiguration in einer temporären Datei zu bündeln. Dies kann zu Problemen beim Importieren von TypeScript-Dateien in einem Monorepo führen. Wenn Sie Probleme mit diesem Ansatz haben, können Sie stattdessen `--configLoader=runner` angeben, um den Modul-Runner zu verwenden - dieser erstellt keine temporäre Konfiguration und transformiert alle Dateien sofort. Beachten Sie, dass der Modul-Runner CJS in Konfigurationsdateien nicht unterstützt, externe CJS-Pakete sollten jedoch wie gewohnt funktionieren. +::: tip Laden der Konfiguration +Standardmäßig nutzt Vite `esbuild`, um die Konfiguration in einer temporären Datei zu bündeln. Dies kann zu Problemen beim Importieren von TypeScript-Dateien in einem Monorepo führen. Wenn Sie Probleme mit diesem Ansatz haben, können Sie stattdessen `--configLoader runner` angeben, um den [Modul-Runner](/guide/api-environment-runtimes.html#modulerunner) zu verwenden. Dieser erstellt keine temporäre Konfiguration und transformiert alle Dateien sofort. Beachten Sie, dass der Modul-Runner CJS in Konfigurationsdateien nicht unterstützt, externe CJS-Pakete sollten jedoch wie gewohnt funktionieren. + +Wenn Sie eine Umgebung mit TypeScript-Support nutzen (z. B. `node --experimental-strip-types`) oder wenn Sie nur schlichtes JavaScript verwenden, dann können Sie die Option `--configLoader native` angeben, um die native Laufzeitumgebung zum Laden der Konfiguration zu verwenden. Beachten Sie, dass Updates von Modulen, die von der Konfigurationsdatei importiert werden, nicht erkannt werden und daher der Vite-Server nicht automatisch neu gestartet wird. ::: ## Intellisense-Konfiguration diff --git a/docs/guide/cli.md b/docs/guide/cli.md index 22fc3831..76ad4cc3 100644 --- a/docs/guide/cli.md +++ b/docs/guide/cli.md @@ -14,24 +14,25 @@ vite [root] #### Optionen -| Optionen | | -|--------------------------|---------------------------------------------------------------------------------------------------------------------------| -| `--host [host]` | Gibt den Hostnamen an (`string`) | -| `--port ` | Gibt den Port an (`number`) | -| `--open [path]` | Öffnet den Browser beim Starten (`boolean \| string`) | -| `--cors` | Aktiviert CORS (`boolean`) | -| `--strictPort` | Beendet den Vorgang, wenn der angegebene Port bereits verwendet wird (`boolean`) | -| `--force` | Zwingt den Optimierer, den Cache zu ignorieren und neu zu bündeln (`boolean`) | -| `-c, --config ` | Verwendet die angegebene Konfigurationsdatei (`string`) | -| `--base ` | Öffentlicher Basispfad (Standard: `/`) (`string`) | -| `-l, --logLevel ` | info \| warn \| error \| silent (`string`) | -| `--clearScreen` | Erlaubt/deaktiviert das Löschen des Bildschirms beim Protokollieren (`boolean`) | -| `--profile` | Startet den integrierten Node.js-Inspector (siehe [Performance Engpässe](/guide/troubleshooting#performance-bottlenecks)) | -| `-d, --debug [feat]` | Zeigt Debug-Protokolle an (`string \| boolean`) | -| `-f, --filter ` | Filtert Debug-Protokolle (`string`) | -| `-m, --mode ` | Setzt den Umgebungsmodus (`string`) | -| `-h, --help` | Zeigt verfügbare CLI-Optionen an | -| `-v, --version` | Zeigt die Versionsnummer an | +| Optionen | | +|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `--host [host]` | Gibt den Hostnamen an (`string`) | +| `--port ` | Gibt den Port an (`number`) | +| `--open [path]` | Öffnet den Browser beim Starten (`boolean \| string`) | +| `--cors` | Aktiviert CORS (`boolean`) | +| `--strictPort` | Beendet den Vorgang, wenn der angegebene Port bereits verwendet wird (`boolean`) | +| `--force` | Zwingt den Optimierer, den Cache zu ignorieren und neu zu bündeln (`boolean`) | +| `-c, --config ` | Verwendet die angegebene Konfigurationsdatei (`string`) | +| `--base ` | Öffentlicher Basispfad (Standard: `/`) (`string`) | +| `-l, --logLevel ` | info \| warn \| error \| silent (`string`) | +| `--clearScreen` | Erlaubt/deaktiviert das Löschen des Bildschirms beim Protokollieren (`boolean`) | +| `--configLoader ` | Verwenden Sie `bundle`, um die Konfiguration mit esbuild zu bündeln oder `runner` (experimentell), um sie direkt zu verarbeiten oder `native` (experimentell), um sie mit der nativen Laufzeitumgebung zu laden (Standard: `bundle`) | +| `--profile` | Startet den integrierten Node.js-Inspector (siehe [Performance Engpässe](/guide/troubleshooting#performance-bottlenecks)) | +| `-d, --debug [feat]` | Zeigt Debug-Protokolle an (`string \| boolean`) | +| `-f, --filter ` | Filtert Debug-Protokolle (`string`) | +| `-m, --mode ` | Setzt den Umgebungsmodus (`string`) | +| `-h, --help` | Zeigt verfügbare CLI-Optionen an | +| `-v, --version` | Zeigt die Versionsnummer an | ## Erstellen