できない.dev

Vite ビルドで chunk size warning(500kB 超過)を消せない

Vite の chunk size warning は、ベンダーを manualChunks で分けるか閾値を上げれば消える。
閾値は chunkSizeWarningLimit で変える。
Vite 8 では分割の設定が codeSplitting に変わる。

公開: 更新:

症状できない
npx vite build
…
- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.
✓ built in 109ms
解決後できた · exit 0
npx vite build
…
dist/assets/index-Ck0isTHW.js    0.87 kB │ gzip: 0.50 kB
dist/assets/big-a-CEfQYwxb.js  338.82 kB │ gzip: 8.80 kB
dist/assets/big-b-Dn672j3h.js  338.82 kB │ gzip: 8.80 kB
✓ built in 96ms

2026-09-17 に node:20(Node.js 20.20.2 / npm 10.8.2) で実際に打って取った出力。検証環境の詳細

要約

vite build の終わりに表示される Some chunks are larger than 500 kB after minification. の警告は、Vite が 1 チャンクの上限を 500kB(chunkSizeWarningLimit(新しいタブで開く) のデフォルト)に置いているために出ている。
実害があるなら manualChunks で分割し、無視してよいなら閾値を上げる。

実行例

vite v6.4.3 で約 340 kB のモジュール 2 つを分割指定なしで束ねると、678.39 kB の 1 チャンクになって Some chunks are larger than 500 kB after minification. が出るが、ビルド自体は終了コード 0 で完了する。
manualChunks で big-a / big-b に切り出すとチャンクが分かれて警告は消え、chunkSizeWarningLimit: 1000 にした版では同じ 678.39 kB の 1 チャンクのまま警告だけが出なくなった。

$ npx vite build
vite v6.4.3 building for production...
transforming...
✓ 5 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                  0.13 kB │ gzip:  0.12 kB
dist/assets/index-CuNmzgFm.js  678.39 kB │ gzip: 18.21 kB
 
(!) Some chunks are larger than 500 kB after minification. Consider:
- Using dynamic import() to code-split the application
- Use build.rollupOptions.output.manualChunks to improve chunking: https://rollupjs.org/configuration-options/#output-manualchunks
- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.
✓ built in 109ms
$ echo $?
0
$ npx vite build
vite v6.4.3 building for production...
transforming...
✓ 5 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                  0.27 kB │ gzip: 0.18 kB
dist/assets/index-Ck0isTHW.js    0.87 kB │ gzip: 0.50 kB
dist/assets/big-a-CEfQYwxb.js  338.82 kB │ gzip: 8.80 kB
dist/assets/big-b-Dn672j3h.js  338.82 kB │ gzip: 8.80 kB
✓ built in 96ms
$ echo $?
0
$ npx vite build
vite v6.4.3 building for production...
transforming...
✓ 5 modules transformed.
rendering chunks...
computing gzip size...
dist/index.html                  0.13 kB │ gzip:  0.12 kB
dist/assets/index-CuNmzgFm.js  678.39 kB │ gzip: 18.21 kB
✓ built in 113ms
$ echo $?
0

— 2026-09-17 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-09-17 検証(ほか 1 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5

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

解決策

1. manualChunks で vendor を分離

vite.config.ts で次のように設定する。

import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        manualChunks: {
          react: ["react", "react-dom"],
          vendor: ["lodash-es", "date-fns"],
        },
      },
    },
  },
});

react / vendor という別チャンクに切り出されるため、初期 JS のサイズが下がり警告も消える。
条件を細かく決めたい場合は関数版の manualChunks も使える(Rollup ドキュメント(新しいタブで開く))。

Vite 8 の場合: バンドラが Rolldown に替わり、上のオブジェクト形式の manualChunks はサポートされなくなった(関数形式も非推奨)。
そのまま vite build すると TypeError: manualChunks is not a function でビルドが失敗する。
build.rollupOptions も build.rolldownOptions に改名されているので、Vite 8 では codeSplitting の groups でチャンクを分ける(Vite の移行ガイド(新しいタブで開く))。

import { defineConfig } from "vite";
 
export default defineConfig({
  build: {
    rolldownOptions: {
      output: {
        codeSplitting: {
          groups: [
            { name: "react", test: /node_modules[\\/]react(-dom)?[\\/]/ },
            { name: "vendor", test: /node_modules[\\/](lodash-es|date-fns)[\\/]/ },
          ],
        },
      },
    },
  },
});

2. ルート単位の動的 import

React Router や Vue Router を使っているなら、ルートコンポーネントを lazy(() => import("./Foo")) に書き換えるだけで Rollup が自動分割してくれる。

import { lazy } from "react";
const Foo = lazy(() => import("./pages/Foo"));

3. 警告自体を上げる

ビルドサイズが要件を満たしているのに警告だけ目立つ場合は閾値を上げる(単位は kB)。

export default defineConfig({
  build: { chunkSizeWarningLimit: 1000 },
});

閾値を上げても警告が消えるだけで、パフォーマンスは改善しない。
実体が大きい場合は、まず manualChunks か lazy 化を検討する。

よくある原因

  1. vendor が 1 チャンクに巻き取られている。
    多くの依存を同じ箇所で import していると、Rollup が同じ初期チャンクにまとめてしまい、初回ロードが重くなる。
  2. chunkSizeWarningLimit を設定していない。
    Vite のデフォルト 500kB は小さめなので、SPA で十分許容できるサイズなら警告だけを消したいこともある。
  3. 動的 import を使っていない。
    ルート単位の import() が無いと Rollup の auto code-splitting が効かず、すべてが初期チャンクに入る。