在 vite 项目中忽略外部依赖,需要在 vite.config.js 中配置 build.rollupoptions.external 选项。该选项接受一个数组或函数,用于指定哪些模块不应被打包进最终产物,而是保留为运行时依赖(如通过全局变量或 cdn 引入)。配置后,vite 构建时会跳过这些模块的解析和打包,直接将其视为外部引用。

external 配置数组的具体用法是什么
将需要忽略的包名放入 build.rollupOptions.external 数组中即可生效。例如,若希望忽略 lodash 和 moment,只需在配置文件中添加这两个字符串。Vite 基于 Rollup 构建,因此该配置直接传递给 Rollup 的 external 选项。当代码中 import 了这些包时,Vite 不会尝试从 node_modules 中读取并转换它们,而是假设它们在浏览器环境中已可用。

import { defineConfig } from 'vite';
export default defineConfig({
build: {
rollupOptions: {
external: ['lodash', 'moment'],
},
},
});上述配置中,external 数组包含两个字符串:'lodash' 和 'moment'。构建时,任何对这两个包的导入都会被标记为外部依赖。确保在 HTML 入口文件中通过 <script></script> 标签正确加载这些库,否则运行时会报错。
立即学习“Java免费学习笔记(深入)”;
如何根据条件动态决定哪些依赖被忽略
除了使用数组,还可以向 external 传递一个函数,该函数接收模块 ID 和父模块 ID,返回布尔值以决定是否忽略。这种方式适用于需要根据路径、正则匹配或特定逻辑来排除依赖的场景。例如,可以忽略所有以 @/utils/ 开头的本地模块,或者忽略所有第三方包但保留特定包。

import { defineConfig } from 'vite';
export default defineConfig({
build: {
rollupOptions: {
external: (id) => {
if (id.startsWith('lodash')) return true;
if (id.includes('/moment/')) return true;
return false;
},
},
},
});在上面的示例中,external 是一个函数,它检查传入的 id。如果 id 以 'lodash' 开头,或者包含 '/moment/',则返回 true,表示该模块应被视为外部依赖。其他模块则正常打包。这种动态判断提供了更灵活的控制能力,适合复杂的项目结构。
当 external 中包含未安装的包时会发生什么
如果在 build.rollupOptions.external 中配置了一个未在 package.json 中声明或未安装在 node_modules 中的包,Vite 构建过程本身不会报错,因为 Rollup 会信任你的配置,认为该模块将在运行时提供。然而,在浏览器中运行应用时,如果对应的脚本未加载,会导致 ReferenceError 或 Module not found 错误。因此,必须确保所有外部依赖都在 HTML 中正确引入,且版本兼容。


















