From d2e0edfc49a921f8f9032884c339270f36445282 Mon Sep 17 00:00:00 2001 From: Matteo Stelbrink <147656301+mstelbrink@users.noreply.github.com> Date: Mon, 3 Nov 2025 11:57:22 +0100 Subject: [PATCH] feat: use module runner to import the config (#602) --- docs/config/index.md | 4 +++ docs/guide/cli.md | 59 +++++++++++++++++++++++--------------------- 2 files changed, 35 insertions(+), 28 deletions(-) diff --git a/docs/config/index.md b/docs/config/index.md index 6e99b834..18ac9b16 100644 --- a/docs/config/index.md +++ b/docs/config/index.md @@ -22,6 +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. +::: + ## Intellisense-Konfiguration Da Vite mit TypeScript-Typisierungen ausgeliefert wird, können Sie die Intellisense Ihrer IDE mit jsdoc-Typ-Hinweisen nutzen: diff --git a/docs/guide/cli.md b/docs/guide/cli.md index d0d8f228..22fc3831 100644 --- a/docs/guide/cli.md +++ b/docs/guide/cli.md @@ -15,7 +15,7 @@ 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`) | @@ -48,7 +48,7 @@ vite build [root] #### Optionen | Optionen | | -| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| | `--target ` | Transpile-Ziel (Standard: `"modules"`) (`string`) | | `--outDir ` | Ausgabe Verzeichnis (Standard: `dist`) (`string`) | | `--assetsDir ` | Verzeichnis unter outDir, um Assets abzulegen (Standard: `"assets"`) (`string`) | @@ -64,6 +64,7 @@ vite build [root] | `--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 (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`) | @@ -85,17 +86,18 @@ vite optimize [root] #### Optionen -| Optionen | | -| ------------------------ | ------------------------------------------------------------------------------- | -| `--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`) | -| `-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 | +| Optionen | | +|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------| +| `--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 (Standard: `bundle`) | +| `-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 | ### `vite preview` @@ -111,18 +113,19 @@ vite preview [root] #### Optionen -| Optionen | | -| ------------------------ | -------------------------------------------------------------------------------- | -| `--host [host]` | Gibt den Hostnamen an (`string`) | -| `--port ` | Gibt den Port an (`number`) | -| `--strictPort` | Beendet den Vorgang, wenn der angegebene Port bereits verwendet wird (`boolean`) | -| `--open [path]` | Öffnet den Browser beim Starten (`boolean \| string`) | -| `--outDir ` | Ausgabe Verzeichnis (Standard: `dist`)(`string`) | -| `-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`) | -| `-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 | +| Optionen | | +|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------| +| `--host [host]` | Gibt den Hostnamen an (`string`) | +| `--port ` | Gibt den Port an (`number`) | +| `--strictPort` | Beendet den Vorgang, wenn der angegebene Port bereits verwendet wird (`boolean`) | +| `--open [path]` | Öffnet den Browser beim Starten (`boolean \| string`) | +| `--outDir ` | Ausgabe Verzeichnis (Standard: `dist`)(`string`) | +| `-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 (Standard: `bundle`) | +| `-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 |