依赖优化选项
- 相关： 依赖预构建
除非另有说明，本节中的选项仅应用于依赖优化器，该优化器仅在开发模式下使用。
optimizeDeps.entries non-inherit
- 类型：
string | string[]
默认情况下，Vite 会爬取所有 .html 文件，以检测需要预构建的依赖项（忽略 node_modules、build.outDir、__tests__ 和 coverage）。如果指定了顶层的 input 或 build.rolldownOptions.input，Vite 则会改为爬取这些入口。
如果这些都不符合你的需求，你可以使用此选项指定自定义入口——值应该是相对于 Vite 项目根目录的 tinyglobby 模式 或模式数组。这将覆盖默认的入口推断。当显式定义 optimizeDeps.entries 时，默认情况下只有 node_modules 和 build.outDir 文件夹会被忽略。如果需要忽略其他文件夹，你可以使用忽略模式作为入口列表的一部分，以初始 ! 标记。对于显式包含字符串 node_modules 的模式，node_modules 不会被忽略。
optimizeDeps.exclude non-inherit
- 类型：
string[]
要从预打包中排除的依赖。
CommonJS
CommonJS 依赖不应被排除在优化之外。如果一个 ESM 依赖被排除在优化之外，但有一个嵌套的 CommonJS 依赖，则该 CommonJS 依赖应添加到 optimizeDeps.include 中。示例：
export default defineConfig({
optimizeDeps: {
include: ['esm-dep > cjs-dep'],
},
})optimizeDeps.include non-inherit
- Type:
string[]
By default, linked packages that are not inside node_modules are not pre-bundled. Use this option to force linked packages to be pre-bundled.
Experimental: If the library you use has many deep imports, you can also specify a trailing glob pattern to pre-bundle all deep imports at once. This avoids repeatedly pre-bundling whenever a new deep import is used. Provide feedback. For example:
export default defineConfig({
optimizeDeps: {
include: ['my-lib/components/**/*.vue'],
},
})optimizeDeps.rolldownOptions non-inherit
- 类型：
Omit<RolldownOptions, 'input' | 'logLevel' | 'output'> & { output?: Omit<RolldownOutputOptions, 'format' | 'sourcemap' | 'dir' | 'banner'> }
在依赖扫描和优化期间传递给 Rolldown 的选项。
某些选项被省略，因为更改它们将与 Vite 的依赖优化不兼容。
plugins与 Vite 的依赖插件合并
optimizeDeps.esbuildOptions non-inherit
- 类型：
Omit<EsbuildBuildOptions, 'bundle' | 'entryPoints' | 'external' | 'write' | 'watch' | 'outdir' | 'outfile' | 'outbase' | 'outExtension' | 'metafile'> - 已弃用
此选项在内部转换为 optimizeDeps.rolldownOptions。请改用 optimizeDeps.rolldownOptions。
optimizeDeps.force non-inherit
- 类型：
boolean
设置为 true 以强制依赖预打包，忽略之前缓存的优化依赖。
optimizeDeps.noDiscovery non-inherit
- 类型：
boolean - 默认值：
false
当设置为 true 时，将禁用自动依赖发现，只有 optimizeDeps.include 中列出的依赖会被优化。仅 CJS 的依赖在开发期间必须存在于 optimizeDeps.include 中。
optimizeDeps.holdUntilCrawlEnd non-inherit
- Experimental: Provide feedback
- Type:
boolean - Default:
true
When enabled, it holds the results of the first optimization until all static imports have been crawled during cold start. This avoids a full-page reload when new dependencies are discovered and new common chunks are generated. If the scanner has found all dependencies, as well as the dependencies explicitly defined in include, it is recommended to disable this option to allow the browser to process more requests in parallel.
optimizeDeps.disabled non-inherit
- 已弃用
- 实验性： 提供反馈
- 类型：
boolean | 'build' | 'dev' - 默认值：
'build'
此选项已弃用。从 Vite 5.1 开始，构建期间的依赖预打包已被移除。将 optimizeDeps.disabled 设置为 true 或 'dev' 会禁用优化器，配置为 false 或 'build' 则保持开发期间优化器启用。
要完全禁用优化器，请使用 optimizeDeps.noDiscovery: true 以不允许自动发现依赖，并将 optimizeDeps.include 留为 undefined 或空。
WARNING
构建期间优化依赖是一个实验性功能。尝试此策略的项目还使用 build.commonjsOptions: { include: [] } 移除了 @rollup/plugin-commonjs。如果你这样做了，警告将指导你重新启用它以在打包时支持仅 CJS 的包。
optimizeDeps.needsInterop non-inherit
- 实验性
- 类型：
string[]
导入这些依赖时强制 ESM 互操作。Vite 能够正确检测何时依赖需要互操作，因此通常不需要此选项。但是，不同的依赖组合可能导致其中一些被不同地预打包。将这些包添加到 needsInterop 可以通过避免全页刷新来加快冷启动速度。如果你的某个依赖属于这种情况，你将收到警告，建议在配置中将包名添加到此数组中。