ツール
Vite
Vue.js 作者の Evan You による次世代フロントエンドビルドツール。開発時は ESM ベース、本番は Rollup でバンドルする。
バージョン移行
メジャーバージョンを上げたときに動かなくなることを、旧版と新版で同じコマンドを打ち比べて確かめた。
Vite 7 → 8・変更点 8 つ
Vite を 7 から 8 に上げると動かなくなることVite 6 → 7・変更点 8 つ
Vite を 6 から 7 に上げると動かなくなること
問題一覧(10)
Vite で path alias(@/)が効かない
Vite で path alias(@/)が効かないときは、resolve.alias と tsconfig の paths を両方設定すれば直る。片方だけだと、型か実行時のどちらかで解決に失敗する。
更新: 2026-11-20、タグ: alias、paths、tsconfig
Vite ビルドで chunk size warning(500kB 超過)を消せない
Vite の chunk size warning は、ベンダーを manualChunks で分けるか閾値を上げれば消える。閾値は chunkSizeWarningLimit で変える。Vite 8 では分割の設定が codeSplitting に変わる。
更新: 2026-10-18、タグ: build、chunk、rollup
Vite で CSS Modules のクラスが適用されない
Vite で CSS Modules が効かないときは、ファイル名を *.module.css にし、styles.foo 経由でクラス名を渡せば直る。ケバブケースを camelCase で取るなら localsConvention を設定する。
更新: 2026-09-18、タグ: css-modules、css、postcss
Vite で環境変数(import.meta.env)が読み込めない
Vite は VITE_ プレフィックスを付けた変数のみをクライアントへ公開する。.env を置いたのに undefined になる典型例と、サーバー専用変数の扱いを整理する。
更新: 2026-11-19、タグ: env、import-meta-env、vite-prefix
Vite で HMR (Hot Module Replacement) が反映されない
Vite の HMR は ESM 経由のモジュール置換で動く。ファイル監視・WebSocket 接続・Fast Refresh の更新境界・副作用モジュールのいずれかでつまずくと反映されない。DevTools の Console と Network タブで状態を確認し、原因を順に切り分ける。
更新: 2026-10-19、タグ: hmr、hot-reload、dev-server
vite preview がブランク(真っ白)で表示できない
vite preview がブランクになる原因の大半は base 設定漏れによるアセットの 404。GitHub Pages 等のサブパス配信時は vite.config.ts の base を本番値に揃える必要がある。
更新: 2026-10-08、タグ: preview、build、base
Vite「process is not defined」の原因と直し方
Vite の process is not defined は、ブラウザで Node の process を参照すると出る。自分のコードは import.meta.env に書き換え、ライブラリ由来なら define で補えば直る。
更新: 2026-11-04、タグ: env、process、browser
Vite の dev server proxy が機能しない
Vite の server.proxy が効かないときは、リクエストのパスをキーに合わせ、changeOrigin: true を付ければたいてい直る。絶対 URL を叩くと proxy を通らないので、Network タブで実際の URL を確かめる。
更新: 2026-11-01、タグ: proxy、dev-server、cors
Vite で「Rollup failed to resolve import」がビルドで消えない
Rollup failed to resolve import は、vite build で import 先を解決できないと出る。パッケージの install、パスの修正、external への追加のどれかで直る。
更新: 2026-10-05、タグ: rollup、build、resolve
Vite「Failed to load transformWithEsbuild」の原因と直し方
Vite 8 の Failed to load transformWithEsbuild は、esbuild を別に入れるか esbuild を使う設定を外せば直る。8 から esbuild は Vite の任意の依存になり、一緒には入らなくなった。
更新: 2026-11-18、タグ: vite8、esbuild、minify