依存関係の最適化オプション ​

• 関連: 依存関係の事前バンドル

optimizeDeps.entries ​

• 型: string | string[]

デフォルトでは、Vite はすべての .html ファイルをクロールして、事前にバンドルする必要のある依存関係を検出します（node_modules, build.outDir, __tests__ および coverage は無視します）。build.rollupOptions.input が指定されている場合、Vite は代わりにそれらのエントリポイントをクロールします。

これらのいずれもニーズに合わない場合、このオプションを使ってカスタムエントリを指定することができます。値は Vite プロジェクトルートからの相対的な fast-glob パターン か、パターンの配列でなければいけません。これによりデフォルトのエントリの推論が上書きされます。optimizeDeps.entries が明示的に定義されている場合、デフォルトでは node_modules と build.outDir フォルダのみが無視されます。他のフォルダを無視したい場合は、最初の ! でマークした無視パターンをエントリリストの一部として使用できます。

optimizeDeps.exclude ​

• 型: string[]

事前バンドルから除外する依存関係。

export default defineConfig({
  optimizeDeps: {
    include: ['esm-dep > cjs-dep'],
  },
})

optimizeDeps.include ​

• 型: string[]

デフォルトでは、リンクされたパッケージのうち node_modules の外にあるものは事前バンドルされません。このオプションを使用してリンクされたパッケージを強制的に事前バンドルします。

実験的機能: 多くのディープインポートを持つライブラリを使用している場合、末尾に glob パターンを指定して、すべてのディープインポートを一度に事前バンドルすることもできます。これにより、新たにディープインポートが使用されるたびに常に事前バンドルされることを避けることができます。例:

export default defineConfig({
  optimizeDeps: {
    include: ["my-lib/components/**/*.vue"],
  },
});

optimizeDeps.esbuildOptions ​

• 型: EsbuildBuildOptions

依存関係のスキャンと最適化の際、 esbuild に渡すオプション。

いくつかのオプションは、変更すると Vite の依存関係の最適化と互換性がなくなるため、省略されています。

• external も省略されています。Vite の optimizeDeps.exclude オプションを使用してください
• plugins は Vite の依存関係プラグインとマージされます

optimizeDeps.force ​

• 型: boolean

true に設定すると、前にキャッシュされた最適化された依存関係を無視して、依存関係の事前バンドルをするよう強制します。

optimizeDeps.disabled ​

• 実験的機能: フィードバックをしてください
• 型: boolean | 'build' | 'dev'
• デフォルト: 'build'

依存関係の最適化を無効にします。true はビルド時とデバッグ時にオプティマイザを無効にします。'build' または 'dev' を渡すと、どちらか一方のモードでのみオプティマイザを無効にできます。依存関係の最適化は、デフォルトでは開発時にのみ有効です。

optimizeDeps.needsInterop ​

• 実験的機能
• 型: string[]

依存関係をインポートする際に、ESM の相互作用を強制します。Vite は依存関係が相互作用を必要とする場合に適切に検出することができるため、このオプションは一般的には必要ありません。しかし、依存関係の組み合わせが異なると、いくつかのパッケージが異なる形で事前にバンドルされる可能性があります。これらのパッケージを needsInterop に追加すると、全ページの再読み込みを回避してコールドスタートを高速化することができます。依存関係のあるパッケージがそうである場合、警告が表示され、パッケージ名を設定内のこの配列に追加するよう提案されます。