在 vite 中配置第三方库的 externals,核心方法是修改构建选项中的 commonjsoptions 或 optimizedeps,具体取决于你希望这些库是在打包阶段被排除还是仅在开发时不被预构建。通常的做法是将不需要打入最终 bundle 的库(如 jquery、lodash 等)通过 commonjsoptions.include 或 exclude 进行控制,或者使用 rollupoptions.external 来明确指定哪些模块应被视为外部依赖。这样做可以显著减小打包体积,并避免重复引入已在全局加载的库。

Vite 中如何排除特定库不打包进最终产物?
要排除特定库,最直接的方式是在 vite.config.js 中使用 build.rollupOptions.external。这会将指定的模块视为外部依赖,Vite 不会尝试解析或打包它们,而是假设它们在运行时环境中已经存在。例如,如果你希望排除 lodash,只需将其加入 external 数组即可。

import { defineConfig } from 'vite';
export default defineConfig({
build: {
rollupOptions: {
external: ['lodash', 'jquery'],
},
},
});
上述配置将导致 lodash 和 jquery 不会被打包进最终的 JS 文件中。当代码中引用这些模块时,Vite 会保留原始的 import 语句,并在运行时期望全局变量或模块加载器提供这些依赖。这种方式适用于那些已经通过 CDN 或全局脚本加载的大型库。
如何处理 CommonJS 格式的第三方库?
对于使用 CommonJS 格式(即 require 或 module.exports)的第三方库,Vite 默认会通过 esbuild 进行转换。但有时你可能希望完全跳过这种转换,或者确保某些 CJS 库不被优化预构建。这时可以使用 build.commonjsOptions 来精细控制。例如,你可以设置 include 为一个正则表达式,只包含特定的 CJS 库,或者使用 exclude 来排除它们。

import { defineConfig } from 'vite';
export default defineConfig({
build: {
commonjsOptions: {
include: [/node_modules/],
transformMixedEsModules: true,
},
},
});
在这个例子中,include: [/node_modules/] 表示只对 node_modules 目录下的模块应用 CommonJS 转换。如果某个库位于 node_modules 之外,它将不会被转换,可能导致运行时错误。因此,确保所有需要转换的 CJS 库都在 include 范围内是关键。此外,transformMixedEsModules: true 允许在 ES 模块项目中混合使用 CJS 模块,这在处理复杂依赖树时非常有用。
当 externals 配置了 lodash 时,运行时如何正确加载它?
当你在 rollupOptions.external 中配置了 lodash 后,Vite 打包后的代码中将不再包含 lodash 的实现。此时,你需要确保在 HTML 页面中通过 <script></script> 标签提前加载 lodash,并且其暴露的全局变量名与代码中引用的名称一致。例如,如果代码中使用 import _ from 'lodash',那么加载的 lodash 脚本必须将自身挂载到全局 _ 变量上。
<script src="https://cdn.jsdelivr.net/npm/lodash@4.17.21/lodash.min.js"></script><script type="module" src="/src/main.js"></script>
在上述 HTML 中,首先加载了 lodash.min.js,它会自动创建全局 _ 变量。然后加载你的 Vite 应用入口文件 main.js。这样,当 main.js 中执行 import _ from 'lodash' 时,Vite 生成的代码会尝试从全局作用域获取 _,从而成功引用 lodash。如果全局变量名不匹配,将会导致 ReferenceError。因此,确保全局变量名与 import 语句中的别名一致是至关重要的。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











