enforce 和 apply 分别控制插件执行顺序与生效环境:enforce 取值 'pre'/'normal'/'post' 决定插件在内置插件前/中/后运行;apply 取值 'build'/'serve' 或函数,限定插件仅在构建或开发时启用。

在 Vite 中,enforce 和 apply 是插件配置中两个关键字段,它们分别控制插件的**执行顺序**和**生效环境**,配合使用能精准调度自定义插件的行为。
enforce: 'pre' —— 提前介入构建流程
设置 enforce: 'pre' 表示该插件会在 Vite 内置的核心插件(如 @vitejs/plugin-vue、vite:css 等)之前运行。这适用于需要在源码被其他插件处理前就做预处理的场景。
- 比如:注入全局常量、重写入口路径、解析特殊语法前拦截文件内容
- 常见用途:添加构建 Banner、实现虚拟模块(virtual module)、修改原始
.vue文件结构 - 注意:
enforce: 'post'则相反,在内置插件之后运行;不设时默认为'normal',即在核心插件之后、构建插件之前
apply: 'build' —— 限定仅在生产构建时生效
apply: 'build' 表示该插件只在执行 vite build 命令时加载并运行,开发服务器(vite 或 vite dev)完全跳过它。
- 适合用于生产专属优化:资源压缩增强、HTML 注入分析脚本、生成 sourcemap 验证逻辑等
- 也可以用函数形式更精细控制,例如:
apply: (config, env) => env.command === 'build' && env.mode === 'production' - 对应值还有
'serve'(仅开发阶段),未配置则默认全环境启用
组合使用:enforce + apply 的典型配置
当两者同时出现,Vite 会先判断是否满足 apply 条件,再按 enforce 排序执行。例如:
{
name: 'my-build-banner',
enforce: 'pre',
apply: 'build',
transform(code, id) {
if (id.endsWith('.js')) {
return `/* Built on ${new Date().toISOString()} */\n${code}`;
}
}
}
- 这个插件不会出现在开发热更新中,避免干扰 HMR
- 在打包阶段最早一批执行,确保 Banner 出现在所有 JS 文件最顶部
- 若误设为
apply: 'serve',则开发时能看到 Banner,但构建时反而失效
实际调试建议
验证插件是否按预期触发,可在插件钩子中加 console.log 并观察终端输出时机:
- 开发启动时看到日志 →
apply: 'serve'生效 - 执行
npm run build时才打印 →apply: 'build'正确 - 对比其他插件日志顺序,确认是否早于
vite:vue或vite:css→enforce: 'pre'起效











