在 vite 项目中启用 legacy 插件需要安装 @vitejs/plugin-legacy,并在 vite.config.js 中将其加入 plugins 数组。该插件会自动处理 es5/es6+ 语法转换、polyfill 注入以及动态导入的兼容打包,从而让构建产物支持旧版浏览器。

如何配置 legacy 插件以支持 IE11
要支持 IE11,必须将 targets 选项设置为包含 'ie 11',并显式引入 @babel/preset-env 来提供必要的 Polyfill。配置完成后,Vite 会生成额外的兼容性 chunk,确保旧浏览器能正确解析代码。

import { defineConfig } from 'vite';
import legacy from '@vitejs/plugin-legacy';
export default defineConfig({
plugins: [
legacy({
targets: ['ie 11'],
polyfills: true,
}),
],
});运行 npx vite build 后,输出目录中将包含针对 IE11 优化的 JS 文件,且 HTML 入口会自动插入对应的 script 标签。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
legacy 插件如何处理动态导入
legacy 插件会将动态导入(dynamic imports)转换为传统的同步加载脚本,避免旧版浏览器不支持 ES Module 动态加载的问题。它会在构建时分析路由或懒加载模块,生成独立的兼容性 bundle。

// 原始代码
const Home = () => import('./Home.vue');
// 构建后(IE11 环境)
// 生成 home.chunk.legacy.js
// 通过 script 标签动态插入这种转换确保了即使在不支持 Promise 和 import() 的环境中,懒加载功能也能正常工作。
启用 legacy 插件后构建产物结构有何变化
启用 legacy 插件后,构建产物会增加一个 legacy 目录或带有 .legacy 后缀的文件。这些文件包含经过 Babel 转译的代码和注入的 Polyfill,而主 bundle 仍保持现代 JavaScript 格式供新浏览器使用。

















