Vue.js编译器本质是将template转为render函数,核心结构为导出含\_ctx等参数的render函数,内部用h或createElementVNode构建vnode;Runtime-Compiler模式在运行时编译模板,体积大、支持动态template;Runtime-Only模式在构建期预编译,体积小、性能高;开发模式注入调试信息,生产模式启用静态提升、PatchFlag等优化。

Vue.js 编译器生成的代码结构,本质上是把模板(template)转化为可执行的 JavaScript 渲染函数(render),而开发模式与生产模式的关键差异,不在于“是否编译”,而在于“何时编译”和“编译产物是否包含运行时解析能力”。
编译器输出的核心结构:render 函数模块
无论哪种构建方式,最终目标都是生成一个导出 render 函数的 JS 模块。典型结构如下:
- 函数签名形如
export function render(_ctx, _cache, $props, $setup, $data, $options),其中_ctx是组件上下文,含响应式数据、方法、插槽等 - 内部使用
createElementVNode(Vue 3)或h(兼容写法)逐层创建虚拟节点,嵌套结构直接映射模板层级 - 静态内容会被标记为
hoistStatic,提升至函数外层缓存,避免每次渲染重复创建 - 动态绑定(如
{{ msg }}、:id="id")转为访问_ctx.msg或_ctx.id的表达式 - 指令(
v-if、v-for)被展开为条件判断或循环调用,例如v-if变成三元表达式或if/else块
Runtime-Compiler 模式:运行时现场编译
该模式打包了完整编译器(compiler-dom),支持在浏览器中动态解析字符串模板。
递归分析 Vue 项目组件依赖,从入口文件生成组件层级图,支持 Vue 2/3,输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- 允许直接使用
new Vue({ template: '<div>{{ msg }}</div>' })或挂载到已有 DOM 元素并指定el+template - 执行流程:HTML 模板字符串 → 词法分析 → 生成 Token → 构建 AST → 转换为 JS AST → 生成
render函数 → 执行渲染 - 体积更大(约多 6–10KB gzip),启动略慢,且无法做静态提升等构建期优化
- 适用于开发调试、动态组件、CMS 内容渲染等需要运行时模板拼接的场景
Runtime-Only 模式:构建期预编译
该模式剔除了编译器,只保留运行时渲染逻辑,所有 template 必须在构建阶段完成转换。
立即学习“前端免费学习笔记(深入)”;
-
.vue文件中的<template>由@vue/compiler-sfc在构建时解析为render函数,直接写入最终 JS 模块 - 运行时跳过 AST 构建和代码生成,直接执行已生成的
render函数,性能更高、包体更小 - 不支持
template选项(如new Vue({ template: '...' })会报错),但支持render选项 - 现代项目默认采用此模式;Vue CLI、Vite 默认构建产物均为 runtime-only
开发模式 vs 生产模式对编译的影响
两者共享同一套编译逻辑,但行为有明显侧重:
- 开发模式下,编译器会注入 dev-only 信息:如节点位置源码映射(source map)、组件名提示、
withBlock包裹用于错误定位、devtools支持钩子 - 生产模式下,移除所有调试逻辑,启用更多优化:静态树提升(hoistStatic)、PatchFlag 标记(减少 diff 范围)、内联事件处理函数、删除注释与空白字符
- 关键区别不在编译器本身,而在构建工具链配置:
process.env.NODE_ENV === 'production'触发不同插件行为,例如@vue/compiler-dom的isProd参数控制是否生成 dev 信息

















