在 vite 项目中配置浏览器兼容目标,需要在 vite.config.js 中设置 build.target 选项。vite 默认使用 'modules' 作为构建目标,这要求浏览器支持原生 es 模块,但不支持较新的 javascript 语法特性(如可选链、空值合并等)。通过将其修改为具体的浏览器版本数组(如 ['es2020', 'edge88', 'firefox78', 'chrome87', 'safari13.1']),vite 会自动调用 esbuild 将代码转译为兼容这些旧版浏览器的语法。

Vite 默认的构建行为与限制是什么
Vite 默认不转译 JavaScript,而是依赖现代浏览器对 ES Modules 的原生支持。这意味着如果你不配置 build.target,Vite 输出的代码会保留最新的 JS 语法,导致不支持 ESM 或新语法的旧浏览器无法运行该应用。

// vite.config.js
import { defineConfig } from 'vite';
export default defineConfig({
build: {
// 默认值为 'modules',仅保证 ESM 支持
// target: 'modules'
}
});
上述配置是 Vite 的默认行为。当 build.target 未显式设置时,Vite 假设你的目标用户使用的是支持 ES Modules 的现代浏览器。此时,代码中的 ?.、?? 等新特性不会被转换,如果用户在 IE11 或旧版 Safari 上访问,控制台会直接报错。
立即学习“Java免费学习笔记(深入)”;
在代码库出现结构漂移之前,扫描JS或TS代码库中的禁止导入、循环依赖、孤立模块和其他依赖规则违规情况。
如何配置以兼容非现代浏览器
要兼容旧版浏览器,需要安装 @vitejs/plugin-legacy 插件并配置 build.target。Vite 本身通过 esbuild 进行转换,但为了达到更广泛的兼容性(包括 IE11),通常结合 legacy 插件使用 Babel 进行二次转译和 Polyfill 注入。

// vite.config.js
import { defineConfig } from 'vite';
import legacy from '@vitejs/plugin-legacy';
import vue from '@vitejs/plugin-vue';
export default defineConfig({
plugins: [
vue(),
legacy({
targets: ['defaults', 'not ie 11'],
modernPolyfills: true
})
],
build: {
// 指定目标浏览器,esbuild 会根据此配置转译 JS
target: ['es2015', 'edge88', 'firefox78', 'chrome87', 'safari13.1']
}
});
在这个配置中,build.target 告诉 esbuild 将代码编译到指定的浏览器版本支持的最低语法水平。同时,@vitejs/plugin-legacy 会生成两份构建产物:一份是现代代码(供现代浏览器使用),另一份是传统代码(供旧浏览器使用)。传统代码包会包含必要的 Polyfill 和转译后的 JS,确保在旧环境中也能正常运行。
配置了具体浏览器版本后,代码中使用了可选链操作符会发生什么
当 build.target 设置为包含不支持可选链操作符(?.)的浏览器版本(如 safari13.1 或更低)时,Vite 在开发模式下会使用 esbuild 实时转译代码,在生产构建时也会执行相同的转译逻辑。可选链操作符会被转换为传统的逻辑与判断或临时变量赋值,从而避免语法错误。
// 源代码 const value = obj?.key?.nested; // 转译后 (针对 safari13.1) var _obj$key$neste, _obj$key; const value = ((_obj$key = obj === null || obj === void 0 ? void 0 : obj.key) !== null && _obj$key !== void 0 ? _obj$key : (_obj$key$neste = obj === null || obj === void 0 ? void 0 : obj.key.nested) !== null && _obj$key$neste !== void 0 ? _obj$key$neste : undefined);
在实际运行中,开发者无需手动修改源码。Vite 的构建流程会自动识别 build.target 中的约束,并将所有不符合目标浏览器能力的语法糖替换为等效的传统写法。如果目标浏览器支持该语法(如 chrome87 支持可选链),则代码保持原样,不进行额外转换,以保持代码体积最小化。

















