できない.dev

Vite を 7 から 8 に上げると動かなくなること

Vite を 7 から 8 に上げると、Rolldown と Oxc への置き換えで manualChunks のオブジェクト形式や *zoom を含む CSS の build が止まり、CommonJS の default import も変わる。
打ち比べた 8 つの変更点と直し方をまとめる。

公開: 更新:

vite@7 を入れたプロジェクトと、同じファイルのまま vite@8 に上げたプロジェクトを並べ、同じコマンドを打ち比べた。
各節の出力は「v7 では」「v8 に上げると」「v8 で直すと」の 3 段で並ぶ。

8 の中心の変更は、build に使っていた Rollup と、変換・圧縮・依存の事前バンドルに使っていた esbuild が、Rolldown と Oxc に置き換わったことである。
公式の発表によると、build.rollupOptions や esbuild の設定は互換の層が Rolldown と Oxc の設定へ読み替えるので、多くのプロジェクトは設定を変えずに動く。
読み替えが効かないのは、Rolldown に無い書き方と、esbuild そのものを使う設定である。
このページでは manualChunks のオブジェクト形式と build.minify: "esbuild" がこれに当たった。
必要な Node.js の版は 7 と同じ 20.19 以上・22.12 以上で、公式の発表に書かれている。

8 つのうち、install か build がエラーで止まるのは plugin-react・manualChunks・esbuild・CSS の圧縮の 4 つである。
CommonJS の変更点は build が通り、できたファイルを動かしたときに TypeError になる。
残りの 3 つは警告が出るか、出力の中身だけが変わる。

公式の発表は、大きなプロジェクトや複雑なプロジェクトなら、7 のまま vite を rolldown-vite に差し替える段を挟むよう勧めている。
rolldown-vite は 7 のままバンドラだけを Rolldown にしたパッケージで、問題がバンドラから来たのか、それ以外の変更から来たのかを分けやすい。
公式の移行ガイドも、rolldown-vite を途中の段として使えると書いている。

このページで打っていない変更点は、公式の移行ガイドに一覧がある。
import.meta.hot.accept に URL を渡す書き方と、output.format の system と amd が無くなり、JavaScript API の build() は BundleError を投げるようになった。
Oxc はネイティブのデコレーターを古い構文に変換しないので、変換が要るなら Babel か SWC のプラグインを足す。
build.commonjsOptions は非推奨になり、書いても何も起きない。

@vitejs/plugin-react 5.1 以前のままだと npm install が止まる

@vitejs/plugin-react の peerDependencies は、4.7.0 と 5.1.4 では vite の ^7.0.0 までで、8 を含まない。
vite だけを 8 に上げると、その npm install は警告を出して終了コード 0 で終わる。
止まるのは、そのあとに打つ npm install である。
版を上げたときの install は通るので、次に npm install を打つまで気付かない。

v7 では

$ cat vite.config.js
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
 
export default defineConfig({
  plugins: [react()],
});
$ npm ls vite @vitejs/plugin-react
react@1.0.0 /work/react
+-- @vitejs/plugin-react@4.7.0
| `-- vite@7.3.7 deduped
`-- vite@7.3.7
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 26 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                  0.15 kB │ gzip:  0.14 kB
dist/assets/index-C-9Lz4S6.js  222.53 kB │ gzip: 69.30 kB
✓ built in 661ms
$ echo $?
0

v8 に上げると

$ npm install -D vite@8
npm warn ERESOLVE overriding peer dependency
npm warn While resolving: react@1.0.0
npm warn Found: vite@7.3.7
npm warn node_modules/vite
npm warn   peer vite@"^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" from @vitejs/plugin-react@4.7.0
npm warn   node_modules/@vitejs/plugin-react
npm warn     dev @vitejs/plugin-react@"^4.7.0" from the root project
npm warn   1 more (the root project)
npm warn
npm warn Could not resolve dependency:
npm warn peer vite@"^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" from @vitejs/plugin-react@4.7.0
npm warn node_modules/@vitejs/plugin-react
npm warn   dev @vitejs/plugin-react@"^4.7.0" from the root project
 
added 7 packages, removed 5 packages, and changed 1 package in 1s
$ echo $?
0
$ npm install
npm error code ERESOLVE
npm error ERESOLVE could not resolve
npm error
npm error While resolving: @vitejs/plugin-react@4.7.0
npm error Found: vite@8.3.6
npm error node_modules/vite
npm error   dev vite@"^8.3.6" from the root project
npm error
npm error Could not resolve dependency:
npm error peer vite@"^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" from @vitejs/plugin-react@4.7.0
npm error node_modules/@vitejs/plugin-react
npm error   dev @vitejs/plugin-react@"^4.7.0" from the root project
npm error
npm error Conflicting peer dependency: vite@7.3.7
npm error node_modules/vite
npm error   peer vite@"^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" from @vitejs/plugin-react@4.7.0
npm error   node_modules/@vitejs/plugin-react
npm error     dev @vitejs/plugin-react@"^4.7.0" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry this command with --force or --legacy-peer-deps to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error /root/.npm/_logs/2026-11-08T03_35_47_738Z-eresolve-report.txt
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-11-08T03_35_47_738Z-debug-0.log
$ echo $?
1
$ npx vite build
3:35:48 AM [vite] warning: `esbuild` option was specified by "vite:react-babel" plugin. This option is deprecated, please use `oxc` instead.
`optimizeDeps.rollupOptions` / `ssr.optimizeDeps.rollupOptions` is deprecated. Use `optimizeDeps.rolldownOptions` instead. Note that this option may be set by a plugin. Set VITE_DEPRECATION_TRACE=1 to see where it is called.
[vite:react-babel] We recommend switching to `@vitejs/plugin-react-oxc` for improved performance. More information at https://vite.dev/rolldown
vite v8.3.6 building client environment for production...
transforming...
✓ 14 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                  0.15 kB │ gzip:  0.13 kB
dist/assets/index-wPUFvkvZ.js  219.51 kB │ gzip: 68.59 kB
 
✓ built in 137ms
$ echo $?
0
$ npm view @vitejs/plugin-react@5.1.4 peerDependencies.vite
^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0
$ npm view @vitejs/plugin-react@5.2.0 peerDependencies.vite
^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0

v8 で直すと

$ npm install -D @vitejs/plugin-react@6
removed 47 packages, and changed 2 packages in 1s
$ echo $?
0
$ npm install
up to date in 170ms
$ echo $?
0
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 14 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                  0.15 kB │ gzip:  0.13 kB
dist/assets/index-wPUFvkvZ.js  219.51 kB │ gzip: 68.59 kB
 
✓ built in 113ms
$ echo $?
0

v8 の上で 4.7.0 を動かすと、build は通ったが警告が 3 つ出た。
1 つ目は 4.7.0 の中の vite:react-babel が esbuild の設定を使っているという非推奨の警告である。
2 つ目は optimizeDeps.rollupOptions が非推奨だという警告で、設定ファイルには書いていないのでプラグインが足したものである。
3 つ目は、@vitejs/plugin-react-oxc に切り替えるよう勧める 4.7.0 自身の警告である。
公式の発表では、Oxc を使う版として @vitejs/plugin-react 6 が Vite 8 と同時に出ている。

@vitejs/plugin-react を 6 に上げると、npm install が通り、build の警告も消えた。
6 は Babel に依存しなくなり、上げたときの npm install で 47 個のパッケージが消えた。

CHANGELOG によると、6 では react({ babel: { plugins: [...] } }) のような Babel の設定が使えない。
Babel のプラグインや React Compiler を使っているなら、@rolldown/plugin-babel を別のプラグインとして並べる。

6 は Vite 7 以前をサポートしないので、先にプラグインだけを上げたいときは、8 を peerDependencies に含む 5.2.0 以降の 5 系を入れる。

manualChunks のオブジェクト形式が使えなくなった

build.rollupOptions.output.manualChunks に { vendor: ["lodash-es"] } のようなオブジェクトを渡すと、7 では指定したパッケージが vendor という別のチャンクに分かれた。
Rolldown はオブジェクト形式を持たず、8 では設定の検査で警告が出たあと、TypeError で build が止まる。

v7 では

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        manualChunks: {
          vendor: ["lodash-es"],
        },
      },
    },
  },
});
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 643 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                 0.23 kB │ gzip: 0.18 kB
dist/assets/index-BXGFO8Mz.js   0.78 kB │ gzip: 0.45 kB
dist/assets/vendor-qjYRiskB.js  1.80 kB │ gzip: 0.91 kB
✓ built in 489ms
$ echo $?
0

v8 に上げると

$ npx vite build
vite v8.3.6 building client environment for production...
Warning: Invalid output options (1 issue found)
- For the "manualChunks". Invalid type: Expected Function but received Object. 
transforming...
✓ 644 modules transformed.
✗ Build failed in 95ms
error during build:
Build failed with 1 error:
 
TypeError: manualChunks is not a function
    at name (file:///work/v8/node_modules/rolldown/dist/shared/create-bundler-option-BDjYxIaE.mjs:2051:11)
    at file:///work/v8/node_modules/rolldown/dist/shared/bindingify-input-options-CM8bmcLg.mjs:2146:21
    at file:///work/v8/node_modules/rolldown/dist/shared/create-bundler-option-BDjYxIaE.mjs:2140:19
    at aggregateBindingErrorsIntoJsError (file:///work/v8/node_modules/rolldown/dist/shared/error-BJ9uQLIS.mjs:50:18)
    at unwrapBindingResult (file:///work/v8/node_modules/rolldown/dist/shared/error-BJ9uQLIS.mjs:20:128)
    at #build (file:///work/v8/node_modules/rolldown/dist/shared/rolldown-DWd2aEL4.mjs:146:34)
    at async buildEnvironment (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:34764:66)
    at async Object.build (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:35185:19)
    at async Object.buildApp (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:35182:153)
    at async CAC.<anonymous> (file:///work/v8/node_modules/vite/dist/node/cli.js:789:3) {
  errors: [Getter/Setter]
}
$ echo $?
1

v8 で直すと

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    rolldownOptions: {
      output: {
        codeSplitting: {
          groups: [{ name: "vendor", test: /node_modules[\\/]lodash-es/ }],
        },
      },
    },
  },
});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 644 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                 0.22 kB │ gzip: 0.17 kB
dist/assets/index-BdgyjUUv.js   0.73 kB │ gzip: 0.44 kB
dist/assets/vendor-Dvd9G-NC.js  2.39 kB │ gzip: 1.15 kB
 
✓ built in 95ms
$ echo $?
0

Rolldown の output.codeSplitting に書き換える。
groups の 1 つ 1 つに、チャンクの名前を name に、入れるモジュールのパスに当たる正規表現を test に書く。
書き換えたあとも、vendor のチャンクは別のファイルとして出た。
公式の移行ガイドによると、manualChunks の関数形式は 8 でも動くが非推奨になった。
build.rollupOptions も build.rolldownOptions に名前が変わったので、書き換えるときに合わせて直しておく。

esbuild が vite の依存から外れた

7 は esbuild を依存として入れていた。
公式の移行ガイドによると、8 は esbuild を直接使わなくなり、esbuild は任意の依存に下がった。
このプロジェクトはほかに esbuild を入れる依存を持たないので、npm install -D vite@8 のあとには esbuild が無い。
その状態で build.minify: "esbuild" のように esbuild を名指しした設定があると、build が止まる。

v7 では

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    minify: "esbuild",
  },
});
$ npm ls esbuild
v7@1.0.0 /work/v7
`-- vite@7.3.7
  `-- esbuild@0.28.2
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 3 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.14 kB
dist/assets/index-Oi0r7DEU.js  0.74 kB │ gzip: 0.42 kB
✓ built in 47ms
$ echo $?
0

v8 に上げると

$ npm ls esbuild
v8@1.0.0 /work/v8
`-- (empty)
$ echo $?
1
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
✗ Build failed in 33ms
error during build:
Build failed with 1 error:
 
[plugin vite:esbuild-transpile]
Error: Failed to load `transformWithEsbuild`. It is deprecated and it now requires esbuild to be installed separately. If you are a package author, please migrate to `transformWithOxc` instead.
    at transformWithEsbuild (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:7454:9)
    at async PluginContextImpl.renderChunk (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:7506:16)
    at async plugin (file:///work/v8/node_modules/rolldown/dist/shared/bindingify-input-options-CM8bmcLg.mjs:1844:16)
    at async plugin.<computed> (file:///work/v8/node_modules/rolldown/dist/shared/bindingify-input-options-CM8bmcLg.mjs:2343:12)
Caused by:
  Error: Cannot find package 'esbuild' imported from /work/v8/node_modules/vite/dist/node/chunks/node.js
  Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'esbuild' imported from /work/v8/node_modules/vite/dist/node/chunks/node.js
      at Object.getPackageJSONURL (node:internal/modules/package_json_reader:331:9)
      at packageResolve (node:internal/modules/esm/resolve:784:25)
      at moduleResolve (node:internal/modules/esm/resolve:873:18)
      at defaultResolve (node:internal/modules/esm/resolve:1006:11)
      at #cachedDefaultResolve (node:internal/modules/esm/loader:705:20)
      at #resolveAndMaybeBlockOnLoaderThread (node:internal/modules/esm/loader:725:38)
      at ModuleLoader.resolveSync (node:internal/modules/esm/loader:763:56)
      at #resolve (node:internal/modules/esm/loader:687:17)
      at ModuleLoader.getOrCreateModuleJob (node:internal/modules/esm/loader:607:35)
      at node:internal/modules/esm/loader:636:32
    at aggregateBindingErrorsIntoJsError (file:///work/v8/node_modules/rolldown/dist/shared/error-BJ9uQLIS.mjs:50:18)
    at unwrapBindingResult (file:///work/v8/node_modules/rolldown/dist/shared/error-BJ9uQLIS.mjs:20:128)
    at #build (file:///work/v8/node_modules/rolldown/dist/shared/rolldown-DWd2aEL4.mjs:146:34)
    at async buildEnvironment (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:34764:66)
    at async Object.build (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:35185:19)
    at async Object.buildApp (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:35182:153)
    at async CAC.<anonymous> (file:///work/v8/node_modules/vite/dist/node/cli.js:789:3) {
  errors: [Getter/Setter]
}
$ echo $?
1

v8 で直すと

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-Cy8tfTAW.js  0.69 kB │ gzip: 0.40 kB
 
✓ built in 34ms
$ echo $?
0
$ npm install -D esbuild
added 2 packages in 386ms
npm warn install-scripts 1 package has install scripts not yet covered by allowScripts:
npm warn install-scripts   esbuild@0.28.2 (postinstall: node install.js)
npm warn install-scripts
npm warn install-scripts Run `npm install-scripts ls` to review, or `npm install-scripts approve <pkg>` to allow.
$ echo $?
0
$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    minify: "esbuild",
  },
});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-BXBNYRFs.js  0.73 kB │ gzip: 0.41 kB
 
✓ built in 62ms
$ echo $?
0

エラー文に出る transformWithEsbuild は、Vite が esbuild で圧縮するときに中で呼ぶ関数である。
自分でこの関数を呼んでいなくても、minify: "esbuild" があればこの関数の読み込みで止まる。
build.minify の行を消すと、8 の既定の Oxc で圧縮された。
esbuild での圧縮を続けるなら、エラー文のとおり esbuild を devDependencies に入れる。
入れたあとは minify: "esbuild" のまま通った。

公式の移行ガイドによると、build.minify: "esbuild" は非推奨で、将来の版で無くなる。
CSS の圧縮を esbuild に戻す build.cssMinify: "esbuild" も、esbuild を別に入れる必要がある。
Vite のプラグインが transformWithEsbuild を呼んでいる場合も同じエラーになるので、プラグインを上げるか esbuild を入れる。

CSS の圧縮が Lightning CSS に替わった

8 は CSS の圧縮に esbuild の代わりに Lightning CSS を使う。
古い Internet Explorer 向けに書かれた *zoom: 1; のようなハック(star hack)を、7 の esbuild は警告だけで出力に残していた。
8 の Lightning CSS は構文エラーとして扱い、build が止まる。
公式の移行ガイドは、CSS が少し大きくなることがある点と、build.cssMinify: "esbuild" で esbuild の圧縮に戻せる点を書いているが、build が止まることには触れていない。

v7 では

$ cat src/style.css
.clearfix {
  *zoom: 1;
}
.clearfix::after {
  content: "";
  display: table;
  clear: both;
}
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 4 modules transformed.
[esbuild css minify]
▲ [WARNING] Expected identifier but found "*" [css-syntax-error]
 
    <stdin>:2:2:
      2 │   *zoom: 1;
        ╵   ^
 
rendering chunks...
computing gzip size...
dist/index.html                 0.23 kB │ gzip: 0.17 kB
dist/assets/index-BokZTg3j.css  0.07 kB │ gzip: 0.08 kB
dist/assets/index-Cxv1gleD.js   0.71 kB │ gzip: 0.40 kB
✓ built in 54ms
$ echo $?
0
$ cat dist/assets/index-BokZTg3j.css
.clearfix{*zoom: 1}.clearfix:after{content:"";display:table;clear:both}

v8 に上げると

$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 5 modules transformed.
✗ Build failed in 54ms
error during build:
Build failed with 1 error:
 
[plugin vite:css-post]
SyntaxError: [lightningcss minify] Unexpected token Semicolon.
This file contains star property hack (e.g. `*zoom`), which was used in the past to support old Internet Explorer versions. This is not a valid CSS syntax and will be ignored by modern browsers. 
While this is not supported by LightningCSS, you can set `css.lightningcss.errorRecovery: true` to strip these codes.
1  |  .clearfix {
2  |    *zoom: 1;
   |            ^
3  |  }
4  |  .clearfix::after {
    at Module.<anonymous> (/work/v8/node_modules/lightningcss/node/index.js:56:14)
    at minifyCSS (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:30800:59)
    at async finalizeCss (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:30642:36)
    at async Promise.all (index 1)
    at async Object.run (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:3051:22)
    at async PluginContextImpl.renderChunk (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:30150:19)
    at async plugin (file:///work/v8/node_modules/rolldown/dist/shared/bindingify-input-options-CM8bmcLg.mjs:1844:16)
    at async plugin.<computed> (file:///work/v8/node_modules/rolldown/dist/shared/bindingify-input-options-CM8bmcLg.mjs:2343:12)
    at aggregateBindingErrorsIntoJsError (file:///work/v8/node_modules/rolldown/dist/shared/error-BJ9uQLIS.mjs:50:18)
    at unwrapBindingResult (file:///work/v8/node_modules/rolldown/dist/shared/error-BJ9uQLIS.mjs:20:128)
    at #build (file:///work/v8/node_modules/rolldown/dist/shared/rolldown-DWd2aEL4.mjs:146:34)
    at async buildEnvironment (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:34764:66)
    at async Object.build (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:35185:19)
    at async Object.buildApp (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:35182:153)
    at async CAC.<anonymous> (file:///work/v8/node_modules/vite/dist/node/cli.js:789:3) {
  errors: [Getter/Setter]
}
$ echo $?
1

v8 で直すと

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  css: {
    lightningcss: { errorRecovery: true },
  },
});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 5 modules transformed.
[lightningcss minify] Unexpected token Semicolon
1  |  .clearfix {
2  |    *zoom: 1;
   |            ^
3  |  }
4  |  .clearfix::after {
rendering chunks...
computing gzip size...
dist/index.html                 0.22 kB │ gzip: 0.17 kB
dist/assets/index-BH-pVEHe.css  0.05 kB │ gzip: 0.07 kB
dist/assets/index-D8YjQhko.js   0.67 kB │ gzip: 0.38 kB
 
✓ built in 39ms
$ echo $?
0
$ cat dist/assets/index-BH-pVEHe.css
.clearfix:after{content:"";clear:both;display:table}

エラー文が勧めるとおり、css.lightningcss.errorRecovery: true を書くと、警告を出して先へ進んだ。
読めなかった .clearfix { *zoom: 1; } の規則は出力から消えた。
エラー文にもあるとおり今のブラウザはこの宣言を読まないので、見た目は変わらない。

自分の CSS なら、*zoom: 1; の行そのものを消してもよい(このページでは打っていない)。
node_modules にある古い CSS のライブラリから来た場合は、errorRecovery で読み飛ばすか、公式の移行ガイドにある build.cssMinify: "esbuild" で esbuild の圧縮に戻す。

このページの star hack は、7 の npx vite build でも [esbuild css minify] の警告として出ていた。
esbuild が警告するほかの書き方が 8 で止まるかどうかは打っていない。

CommonJS の default import が module.exports になった

legacy-greet は、TypeScript が CommonJS に変換して配っているパッケージの代わりにこのページで作ったもので、__esModule の印を付けて exports.default に関数を入れている。
package.json に "type": "module" があるプロジェクト(npm create vite の雛形もこれに当たる)で、この関数を default import して呼んだ。
ブラウザの代わりに node で build の結果を動かすため、document を使う modulepreload の polyfill を切り、エラーの行を読めるように圧縮も切ってある。

v7 では

$ npm pkg get type
"module"
$ cat node_modules/legacy-greet/index.js
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.default = greet;
function greet(name) {
  return "Hello, " + name;
}
$ cat src/main.js
import greet from "legacy-greet";
 
console.log(greet("Vite"));
$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    minify: false,
    modulePreload: { polyfill: false },
  },
});
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 6 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.14 kB
dist/assets/index-chjZnYOw.js  0.64 kB │ gzip: 0.33 kB
✓ built in 61ms
$ echo $?
0
$ node dist/assets/index-chjZnYOw.js
Hello, Vite
$ echo $?
0

v8 に上げると

$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-PvZm7cQx.js  1.45 kB │ gzip: 0.68 kB
 
✓ built in 38ms
$ echo $?
0
$ node dist/assets/index-PvZm7cQx.js
file:///work/cjs/v8/dist/assets/index-PvZm7cQx.js:31
console.log((0, import_legacy_greet.default)("Vite"));
                                            ^
 
TypeError: (0 , import_legacy_greet.default) is not a function
    at file:///work/cjs/v8/dist/assets/index-PvZm7cQx.js:31:45
    at ModuleJob.run (node:internal/modules/esm/module_job:561:25)
    at async node:internal/modules/esm/loader:647:26
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5)
 
Node.js v24.22.2
$ echo $?
1
$ node src/main.js
file:///work/cjs/v8/src/main.js:3
console.log(greet("Vite"));
            ^
 
TypeError: greet is not a function
    at file:///work/cjs/v8/src/main.js:3:13
    at ModuleJob.run (node:internal/modules/esm/module_job:561:25)
    at async node:internal/modules/esm/loader:647:26
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5)
 
Node.js v24.22.2
$ echo $?
1

v8 で直すと

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  legacy: {
    inconsistentCjsInterop: true,
  },
  build: {
    minify: false,
    modulePreload: { polyfill: false },
  },
});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-BICtWE-0.js  1.44 kB │ gzip: 0.68 kB
 
✓ built in 41ms
$ echo $?
0
$ node dist/assets/index-BICtWE-0.js
Hello, Vite
$ echo $?
0
$ cat src/main.js
import pkg from "legacy-greet";
 
const greet = pkg.default;
console.log(greet("Vite"));
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-2MKSZMlk.js  1.41 kB │ gzip: 0.66 kB
 
✓ built in 29ms
$ echo $?
0
$ node dist/assets/index-2MKSZMlk.js
Hello, Vite
$ echo $?
0
$ node src/main.js
Hello, Vite
$ echo $?
0

8 では build が通り、できたファイルを動かしたところで TypeError になった。
公式の移行ガイドによると、8 は次のどれかに当たると、default import を module.exports そのものにする。

  • 読み込む側のファイルが .mjs か .mts である。
  • いちばん近い package.json に "type": "module" がある。
  • module.exports.__esModule が true ではない。

7 の build は、module.exports.__esModule が true で module.exports.default があれば、そちらを返していた。
ここでは module.exports は default と __esModule を持つオブジェクトなので、関数として呼べない。
"type": "module" のこのプロジェクトでは、同じファイルを node src/main.js で直接動かしても同じ理由で止まった。

legacy.inconsistentCjsInterop: true を書くと 7 と同じ読み方に戻るが、公式の移行ガイドはこれを一時的な逃げ道としている。
コードを直すなら、legacy の設定を外し、default import で受け取ったオブジェクトから default を取り出す。
この書き方は 8 の build でも node src/main.js でも動いた。
パッケージが ESM の版を配っているなら、そちらを読ませる手もある(このページでは打っていない)。

tsconfig の paths を Vite が自分で解決するようになった

tsconfig.json の paths に書いた @/* のような別名を解決するのに、7 では vite-tsconfig-paths などのプラグインが要った。
8 は resolve.tsconfigPaths で自分で解決できるようになり、プラグインを入れたままだとそれを知らせるメッセージが出る。
build はそのまま通る。

v7 では

$ cat tsconfig.json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": ["src"]
}
$ cat vite.config.ts
import { defineConfig } from "vite";
import tsconfigPaths from "vite-tsconfig-paths";
 
export default defineConfig({
  plugins: [tsconfigPaths()],
});
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.14 kB
dist/assets/index-elWct6FW.js  0.76 kB │ gzip: 0.43 kB
✓ built in 63ms
$ echo $?
0

v8 に上げると

$ npx vite build
The plugin "vite-tsconfig-paths" is detected. Vite now supports tsconfig paths resolution natively via the resolve.tsconfigPaths option. You can remove the plugin and set resolve.tsconfigPaths: true in your Vite config instead.
vite v8.3.6 building client environment for production...
transforming...
✓ 5 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-DuZiu2Q5.js  0.71 kB │ gzip: 0.41 kB
 
✓ built in 34ms
$ echo $?
0

v8 で直すと

$ cat vite.config.ts
import { defineConfig } from "vite";
 
export default defineConfig({});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 5 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-DuZiu2Q5.js  0.71 kB │ gzip: 0.41 kB
 
✓ built in 32ms
$ echo $?
0
$ npx vite > vite.log 2>&1 &
$ curl -s -o /dev/null -w '%{http_code}\n' http://localhost:5173/src/main.ts
500
$ cat vite.log
  VITE v8.3.6  ready in 118 ms
 
  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose
(!) Failed to run dependency scan. Skipping dependency pre-bundling. Error: The following dependencies are imported but could not be resolved:
 
  @/utils/greet (imported by /work/v8/tsconfig-paths/src/main.ts)
 
Are they installed?
    at file:///work/v8/node_modules/vite/dist/node/chunks/node.js:28527:33
    at async file:///work/v8/node_modules/vite/dist/node/chunks/node.js:35879:15
3:36:00 AM [vite] Internal server error: Failed to resolve import "@/utils/greet" from "src/main.ts". Does the file exist?
  Plugin: vite:import-analysis
  File: /work/v8/tsconfig-paths/src/main.ts:1:22
  1  |  import { greet } from "@/utils/greet";
     |                         ^
  2  |  console.log(greet("Vite"));
  3  |  
      at TransformPluginContext._formatLog (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:8861:39)
      at TransformPluginContext.error (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:8858:14)
      at resolveId (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:26533:18)
      at async file:///work/v8/node_modules/vite/dist/node/chunks/node.js:26632:23
      at async Promise.all (index 0)
      at async TransformPluginContext.transform (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:26605:4)
      at async EnvironmentPluginContainer.transform (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:8632:14)
      at async loadAndTransform (file:///work/v8/node_modules/vite/dist/node/chunks/node.js:20108:26)
3:36:00 AM [vite] (client) Pre-transform error: Failed to resolve import "@/utils/greet" from "src/main.ts". Does the file exist?
  Plugin: vite:import-analysis
  File: /work/v8/tsconfig-paths/src/main.ts:1:22
  1  |  import { greet } from "@/utils/greet";
     |                         ^
  2  |  console.log(greet("Vite"));
  3  |
$ cat vite.config.ts
import { defineConfig } from "vite";
 
export default defineConfig({
  resolve: {
    tsconfigPaths: true,
  },
});
$ npx vite > vite.log 2>&1 &
$ curl -s -o /dev/null -w '%{http_code}\n' http://localhost:5173/src/main.ts
200
$ curl -s http://localhost:5173/src/main.ts | head -1
import { greet } from "/src/utils/greet.ts";

プラグインを外し、resolve.tsconfigPaths: true を書く。
公式の発表によると、この設定は解決に少し時間がかかるので既定では無効になっている。
8.3.6 では、プラグインを外して設定を書かなかったときに build は通ったが、dev サーバーは @/utils/greet を解決できずに 500 を返した。
build だけで確かめると見落とすので、設定は必ず書く。
書いたあとの dev サーバーは、@/utils/greet を /src/utils/greet.ts に書き換えて返した。

esbuild.banner が非推奨になり、圧縮した出力に残らなくなった

8 は esbuild の設定のほとんどを oxc の設定に読み替える。
公式の移行ガイドによると、banner と footer は transform フックを使うプラグインに読み替えられる。
8 で esbuild.banner を書くと非推奨の警告が出て、ライセンスの注記のような先頭のコメントは、既定の build の出力に残らなかった。
build は終了コード 0 で終わる。

v7 では

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  esbuild: {
    banner: "/*! (c) example */",
  },
});
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 3 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.14 kB
dist/assets/index-BXbioWUs.js  0.76 kB │ gzip: 0.43 kB
✓ built in 45ms
$ echo $?
0
$ grep -c "(c) example" dist/assets/index-BXbioWUs.js
1

v8 に上げると

$ npx vite build
`esbuild.banner` option was specified. But this option is deprecated and will be removed in future versions. This option can be achieved by using a plugin with transform hook, please use that instead.
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-Cy8tfTAW.js  0.69 kB │ gzip: 0.40 kB
 
✓ built in 32ms
$ echo $?
0
$ grep -c "(c) example" dist/assets/index-Cy8tfTAW.js
0
$ npx vite build --minify false
`esbuild.banner` option was specified. But this option is deprecated and will be removed in future versions. This option can be achieved by using a plugin with transform hook, please use that instead.
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-Csn4d2vY.js  1.22 kB │ gzip: 0.55 kB
 
✓ built in 38ms
$ echo $?
0
$ grep -c "(c) example" dist/assets/index-Csn4d2vY.js
0
$ mv src/main.js src/main.ts
$ sed -i s/main.js/main.ts/ index.html
$ npx vite build --minify false
`esbuild.banner` option was specified. But this option is deprecated and will be removed in future versions. This option can be achieved by using a plugin with transform hook, please use that instead.
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.14 kB
dist/assets/index-BROcUXLG.js  1.24 kB │ gzip: 0.56 kB
 
✓ built in 39ms
$ echo $?
0
$ grep -c "(c) example" dist/assets/index-BROcUXLG.js
1
$ npx vite build
`esbuild.banner` option was specified. But this option is deprecated and will be removed in future versions. This option can be achieved by using a plugin with transform hook, please use that instead.
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-Cy8tfTAW.js  0.69 kB │ gzip: 0.40 kB
 
✓ built in 33ms
$ echo $?
0
$ grep -c "(c) example" dist/assets/index-Cy8tfTAW.js
0

v8 で直すと

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    rolldownOptions: {
      output: { banner: "/*! (c) example */" },
    },
  },
});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-Cy8tfTAW.js  0.69 kB │ gzip: 0.40 kB
 
✓ built in 36ms
$ echo $?
0
$ grep -c "(c) example" dist/assets/index-Cy8tfTAW.js
0
$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    rolldownOptions: {
      output: { postBanner: "/*! (c) example */" },
    },
  },
});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.14 kB
dist/assets/index-DNVTPXZq.js  0.71 kB │ gzip: 0.42 kB
 
✓ built in 34ms
$ echo $?
0
$ grep -c "(c) example" dist/assets/index-DNVTPXZq.js
1

8 で src/main.js を build すると、圧縮してもしなくても、コメントは出力に入らなかった。
エントリーを src/main.ts に替えると、圧縮しない build では入り、既定の圧縮をかけると消えた。
互換の層は .ts のファイルにはコメントを付けるが .js のファイルには付けず、付けたコメントも圧縮で消える。
警告は「将来の版で無くなる」と書いているが、圧縮した出力には 8.3.6 でもう残らない。

Rolldown の出力の設定で付け直す。
直したあとの段は src/main.ts のまま打った。
output.banner に書いたコメントは、圧縮のあとの出力に残らなかった。
Rolldown のドキュメントによると、output.postBanner は圧縮のあとに付くので、こちらはコメントが残った。

警告の文は、transform フックを持つプラグインで付けるよう勧めている。
互換の層もその形の読み替えで、上の src/main.ts ではそのコメントが圧縮で消えた。
圧縮した出力に残すなら output.postBanner を使う。

既定のブラウザターゲットが Safari 16.4 などに上がった

build.target を書かないときの既定('baseline-widely-available')の中身が変わった。
公式の移行ガイドによると、Chrome と Edge は 107 から 111、Firefox は 104 から 114、Safari は 16.0 から 16.4 に上がった。
2026-01-01 の時点で Baseline Widely Available に入った機能に合わせたものである。
対象が新しくなった分だけ、古い書き方に変換されずに出るコードが増える。

v7 では

$ cat src/main.js
class Config {
  static {
    Config.ready = true;
  }
}
 
console.log(Config.ready);
$ npx vite build
vite v7.3.7 building client environment for production...
transforming...
✓ 3 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.14 kB
dist/assets/index-CjIEhRIY.js  0.77 kB │ gzip: 0.43 kB
✓ built in 56ms
$ echo $?
0
$ grep -o "class.*ready)" dist/assets/index-CjIEhRIY.js
class i{};i.ready=!0;let s=i;console.log(s.ready)

v8 に上げると

$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-B9iztMiB.js  0.72 kB │ gzip: 0.42 kB
 
✓ built in 38ms
$ echo $?
0
$ grep -o "class.*ready)" dist/assets/index-B9iztMiB.js
class e{static{e.ready=!0}};console.log(e.ready)

v8 で直すと

$ cat vite.config.js
import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    target: ["chrome107", "edge107", "firefox104", "safari16"],
  },
});
$ npx vite build
vite v8.3.6 building client environment for production...
transforming...
✓ 4 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                0.15 kB │ gzip: 0.13 kB
dist/assets/index-DaJqpEsH.js  0.74 kB │ gzip: 0.43 kB
 
✓ built in 35ms
$ echo $?
0
$ grep -o "class.*ready)" dist/assets/index-DaJqpEsH.js
class t{static#e=e=()=>(t.ready=!0,this)},e());console.log(t.ready)

7 では class の static ブロックが変換され、static ブロックを使わない形で出ていた。
8 では static ブロックがそのまま出た。
エラーは出ないので、古いブラウザでページを開くまで気付かない。

Safari 16.0〜16.3 などの古い版の利用者がいるなら、build.target に 7 の既定を書き戻す。
書き戻すと、Oxc は static ブロックを static の private フィールドに書き換えた。
7 の esbuild とは書き換え方が違うが、static ブロックの形では出なくなる。

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-08 検証(ほか 13 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • Vite(旧) 7.3.7
  • Vite(新) 8.3.6
  • Rollup(旧の同梱) 4.68.0
  • esbuild(旧の同梱) 0.28.2
  • Rolldown(新の同梱) 1.2.16
  • Lightning CSS(新の同梱) 1.33.0
  • vite-tsconfig-paths 6.1.1
  • lodash-es 4.18.1
  • React 19.3.1
  • @vitejs/plugin-react(旧) 4.7.0
  • @vitejs/plugin-react(新) 6.2.1
  • esbuild(新で追加) 0.28.2

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。