在 vite 项目中配置 javascript 的编译目标,需要修改 vite.config.js 文件中的 build.target 选项。vite 默认将构建目标设为 'modules',这对应支持原生 es 模块的现代浏览器环境;若需兼容不支持 es module 的旧版浏览器(如 ie11),可将其改为 'es2015' 或更低的版本,此时 vite 会自动引入 polyfill 并将代码转换为 commonjs 格式。

如何针对特定浏览器版本调整构建输出?
要针对特定浏览器版本调整输出,必须使用 @vitejs/plugin-basic-ssl 之外的工具配合 browserslist 来确定目标范围,或者直接在 vite.config.js 中显式指定 build.target。Vite 本身不直接解析 .browserslistrc 来改变 build.target 的默认值,但可以通过设置 build.minify 和 build.cssTarget 来辅助。最核心的控制点依然是 build.target。如果设置为 'esnext',Vite 会尽可能保留现代语法;如果设置为 'es2015',则会转译箭头函数、类、模板字符串等特性。此外,为了真正支持旧浏览器,通常还需要搭配 @vitejs/pluginlegacy 插件,该插件会在构建后生成一份额外的兼容包。

// vite.config.js
import { defineConfig } from 'vite';
import legacy from '@vitejs/plugin-legacy';
export default defineConfig({
plugins: [
legacy({
targets: ['defaults', 'not ie 11'],
}),
],
build: {
// 核心配置:指定 JS 编译目标
target: 'es2015',
// 可选:同时指定 CSS 目标
cssTarget: 'chrome61'
}
});
上述配置中,target: 'es2015' 确保生成的 JS 代码不包含 ES2015+ 的新语法。配合 @vitejs/plugin-legacy,Vite 会生成两个构建产物:一个是面向现代浏览器的优化包,另一个是面向旧浏览器的兼容包。运行 vite build 后,检查 dist 目录,你会看到 index.html 中通过 <script type="module"></script> 引入现代包,并通过 <script nomodule></script> 引入兼容包。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
立即学习“Java免费学习笔记(深入)”;
不同 target 设置对打包体积和性能有何影响?
不同的 build.target 设置直接影响最终打包文件的体积和执行效率。当 target 设置为 'modules' 时,Vite 假设浏览器支持 ES Modules,因此不会进行大量的语法降级转换,生成的代码更接近源码,体积最小且执行速度最快。然而,一旦将 target 降低到 'es2015' 或更低,Babel 或 SWC 就需要注入大量的 Polyfill 和转换代码来处理异步函数、迭代器、类等特性,这会导致文件体积显著增加。例如,一个仅使用 fetch 和 Promise 的小应用,在 'modules' 目标下可能只有几 KB,而在 'es2015' 目标下可能膨胀至几十 KB,因为需要包含全局的 Promise 实现和 fetch polyfill。此外,较低的 target 还会导致代码无法利用浏览器的最新 JIT 编译器优化,从而略微降低运行时性能。因此,除非明确需要支持旧浏览器,否则应始终优先使用默认的 'modules' 目标。

// 对比测试:观察不同 target 下的输出差异
// 1. 创建 test.js
const fetchData = async () => {
const res = await fetch('/api/data');
return res.json();
};
// 2. 在 vite.config.js 中分别设置 target: 'modules' 和 target: 'es2015'
// 3. 运行 vite build
// 4. 比较 dist/assets/index-xxxx.js 的大小和内容
// 结果:es2015 版本会包含 _asyncToGenerator, _classCallCheck 等辅助函数
当 target 设置为 esnext 时,哪些特性会被保留?
当 build.target 设置为 'esnext' 时,Vite 会尽可能少地转换 JavaScript 代码,保留所有最新的 ECMAScript 特性。这意味着像可选链操作符(?.)、空值合并操作符(??)、管道操作符(|>,如果启用)以及最新的数组方法等都不会被转译。这种配置适用于开发阶段或确定所有用户都使用最新浏览器的场景。然而,需要注意的是,即使设置为 'esnext',Vite 仍然会根据 build.minify 选项进行压缩(默认为 Terser),Terser 可能会根据配置的 ecma 版本进行一些安全的简化,但不会进行语法降级。如果开发者使用了尚未被广泛支持的实验性特性,设置为 'esnext' 可能导致这些代码在非最新浏览器中直接报错。因此,在使用 'esnext' 时,务必确认目标环境的浏览器兼容性,或者结合 @vitejs/plugin-legacy 来提供回退方案。此外,esnext 目标下,Vite 的开发服务器(HMR)也能更快地响应代码变更,因为减少了转换步骤。

















