Migration von v5

Environment API

Als Teil der neuen experimentellen Environment API war ein großes internes Refactoring notwendig. Vite 6 ist bestrebt, brechende Änderungen zu vermeiden, um sicherzustellen, dass die meisten Projekte schnell auf die neue Hauptversion umsteigen können. Wir werden warten, bis sich ein großer Teil des Ökosystems stabilisiert hat, um dann die Verwendung der neuen APIs zu empfehlen. Es kann einige Randfälle geben, aber diese sollten nur die Nutzung auf niedriger Ebene durch Frameworks und Tools betreffen. Wir haben mit den Maintainern im Ökosystem zusammengearbeitet, um diese Unterschiede vor der Veröffentlichung abzumildern. Bitte öffnen Sie ein Problem, wenn Sie eine Regression entdecken.

Einige interne APIs wurden aufgrund von Änderungen an der Implementierung von Vite entfernt. Wenn Sie sich auf eine von ihnen verlassen haben, erstellen Sie bitte einen feature request.

Vite Runtime API

Die experimentelle Vite Runtime API entwickelte sich zur Module Runner API, die in Vite 6 als Teil der neuen experimentellen Environment API veröffentlicht wurde. Da es sich um eine experimentelle Funktion handelte, ist die Entfernung der früheren API, die in Vite 5.1 eingeführt wurde, keine einschneidende Änderung, aber die Benutzer müssen ihre Verwendung auf das Modul-Runner-Äquivalent im Rahmen der Migration auf Vite 6 aktualisieren.

Allgemeine Änderungen

JSON stringify

In Vite 5, wenn json.stringify: true gesetzt ist, war json.namedExports deaktiviert.

Ab Vite 6 wird json.namedExports auch dann nicht deaktiviert, wenn json.stringify: true gesetzt ist, und der Wert wird beibehalten. Wenn Sie das vorherige Verhalten erreichen wollen, können Sie json.namedExports: false setzen.

Vite 6 führt auch einen neuen Standardwert für json.stringify ein, nämlich 'auto', der nur große JSON-Dateien stringifizieren wird. Um dieses Verhalten zu deaktivieren, setzen Sie json.stringify: false.

Erweitert

Es gibt weitere Änderungen, die nur wenige Benutzer betreffen.

• [#15637] fix!: default build.cssMinify to 'esbuild' for SSR
  • build.cssMinify is now enabled by default even for SSR builds.
• [#18209] refactor!: bump minimal terser version to 5.16.0
  • Die minimal unterstützte Terser-Version für build.minify: 'terser' wurde von 5.4.0 auf 5.16.0 erhöht.
• [#18243] chore(deps)!: fast-glob nach tinyglobby migrieren
  • Bereichsklammern ({01..03} ⇒ ['01', '02', '03']) und inkrementelle Klammern ({2..8..2} ⇒ ['2', '4', '6', '8']) werden in Globs nicht mehr unterstützt.

Migration von v4

Schauen Sie sich zuerst den Migration from v4 Guide in den Vite v5 Docs an, um zu sehen, welche Änderungen notwendig sind, um Ihre Anwendung auf Vite 5 zu portieren, und fahren Sie dann mit den Änderungen auf dieser Seite fort.