Vue3架构分析(一)——从Vue单文件组件到浏览器中的DOM

🧪 本文配套交互式原理实验室 · Rust Wasm 驱动

Vue 3 编译三步曲 (Token → AST → PatchFlags & Block Tree) 交互式可视化器

实时输入或切换 Vue SFC 模板,基于 Rust Wasm 拆解词法 Token 流、Template AST、静态提升 (_hoisted) 与 PatchFlags 靶向更新位运算。

立即动手单步实验 →

时至今日,Vue3早已被广泛应用到各类线上业务项目。她能优雅地为我们解决数据流转、UI渲染和用户交互等前端数据层和视图层的问题。

虽然,我们对Vue的使用已经非常熟练,并且也能使用她解决日常工作中的各种问题,但是我们可能从未看清她的全貌。

那么,今天我们就尝试站在远处,从宏观的角度来看看她的全貌。

提示: 为了抓住故事主线,我们忽略了很多细节。

一、整体流程

首先,我们先抛开SSR这种的情况,就从.vue单文件组件,最终渲染成浏览器中的dom节点的整个过程进行一个宏观的分析。

大致流程应该是如下图所示的这样:

运行阶段(@vue/runtime-dom,@vue/runtime-core,@vue/reactivity)

应用启动

框架内部

挂载到DOM

创建根节点(createVNode)

将根节点渲染到容器中(render)

创建应用

获取/新建渲染器(ensureRenderer)

创建应用上下文(createAppContext)

用户代码

创建应用(createApp)

挂载到DOM中(mount)

编译阶段(运行环境:node.js)

组件脚本和样式(Component&style)

SomeComponent.js

__name: 'SomeComponent'

props: {}

setup(props): (ctx, cache) => VNode

单文件组件源码(.vue)

SomeComponent.vue

script

template

style

编译器

编译三步曲

parse

transform

generate

单文件组件编译器

@vue/compiler-sfc

@vue/compiler-core

@vue/compiler-dom

根据上图,我们基于vue单文件组件的工作流程大致描述分为如下两大步:

  1. 编译: 编译阶段是在nodejs环境中执行的,vue单文件组件代码被输入到编译器中,经过三个步骤:①语法分析(parse)得到抽象语法书AST;②修改抽象语法树(transform);③重新生成代码(generate),最终输出两部分内容——脚本和样式,大体流程如下图:

新抽象语法树

抽象语法树

.vue文件

语法解析器(Parser)

转换器(Transforms)

代码生成器

JS 和 CSS

  1. 运行: 运行阶段发生在浏览器上,我们通过执行createApp(SomeComponent).mount('#app')来将我们的组件渲染到id为app的DOM节点中。

二、源码分析

下面我们从用户侧代码入手,精简掉部分代码后,试着捋出应用启动的主流程相关代码:

(一)用户侧代码

import { createApp } from 'vue'
import './style.css'
import SomeComponent from './SomeComponent.vue'

createApp(SomeComponent).mount('#app');

我们通过createApp(SomeComponent).mount('#app');这行代码创建应用,并将根节点生成的dom对象挂载到id为app的节点上。

接下来,我们继续深入框架,看看上面的代码实际做了什么!

(二) 创建应用的入口函数

export const createApp = ((...args) => {
  // 通过ensureRenderer函数获得渲染器
  const app = ensureRenderer().createApp(...args)

  const { mount } = app
  app.mount = (containerOrSelector: Element | ShadowRoot | string): any => {
    ...
  }

  return app
}) as CreateAppFunction<Element>

createApp()函数会通过渲染器创建一个应用(查看源码),而ensureRenderer()会获得渲染器,创建应用之后,代码中还重写了app.mount函数,这里我们先跳过。

接下来,我们先看看渲染器是怎么获取的!

(三) 获取渲染器

ensureRenderer()函数首先判断闭包内是否存在renderer,如果存在则直接返回,不存在则新建renderer。这个renderer实例就是渲染器。查看源码

let renderer: Renderer<Element | ShadowRoot> | HydrationRenderer

function ensureRenderer() {
  return (
    renderer ||
    (renderer = createRenderer<Node, Element | ShadowRoot>(rendererOptions))
  )
}

如果点击源码链接,在下方还会看到createSSRApp函数,它会调用ensureHydrationRenderer返回一个渲染器。

这里,vue对渲染器进行了抽象,渲染器被抽象成了接口(查看源码),下面摘抄了相关源码:

export interface Renderer<HostElement = RendererElement> {
  render: RootRenderFunction<HostElement>
  createApp: CreateAppFunction<HostElement>
}

export interface HydrationRenderer extends Renderer<Element | ShadowRoot> {
  hydrate: RootHydrateFunction
}

那么,这么做有什么好处呢? 这样做,可以将渲染器与具体实现进行分离,渲染器只需要包含render和createApp两个方法,而对于HydrationRenderer接口,也就需要多实现一个hydrate方法。

对于 “可以将渲染器与具体实现进行分离” 我想再细致地说一下:

  1. Renderer接口很抽象地描述了,对于一个渲染器,首先,要提供一个createApp方法来创建一个应用, 其次,需要提供一个render方法来执行渲染。

  2. 至于具体如何创建应用如何渲染,并没有做细节规定,只要根据接口声明的方法签名进行实现即可。

  3. 这样一来,我们在dom运行环境的渲染器和SSR环境的渲染器就可以各自按照自己的需要实现即可。

拓展一下: 这样设计的好处就是,假设我们要基于vue3实现类似ReactNative那样的将vue3的组件渲染成NativeUI应该怎么做呢?没错,为它实现一个新的渲染器即可,实现之后前端应用入口代码大概会改成这样:

import { createNativeApp } from 'vue'
import './style.css'
import SomeComponent from './SomeComponent.vue'

createNativeApp(SomeComponent).mount('appContainer');

扯远了,我们继续回来看渲染器究竟是怎么被创建出来的呢?

(四) 创建渲染器

渲染器最终是通过baseCreateRenderer函数来实现的(查看源码),这个函数特别长,函数体就有600多行,那么这个函数究竟做了什么呢?

为了方便分析,我们将无关代码都先省略掉:

function baseCreateRenderer(
  options: RendererOptions,
  createHydrationFns?: typeof createHydrationFunctions,
): any {
  ... // 这里省略了几百行代码
  return {
    render,
    hydrate,
    createApp: createAppAPI(render, hydrate),
  }
}

虽然baseCreateRenderer函数很长,但是我们可以看到,最后只是返回了一个符合渲染器接口的对象,而这个对象就是最终的渲染器实例。

除了返回值,我们再看它的第一个入参options,其类型是RendererOptions,下面是其类型信息:

export interface RendererOptions<
  HostNode = RendererNode,
  HostElement = RendererElement,
> {
  patchProp(
    el: HostElement,
    key: string,
    prevValue: any,
    nextValue: any,
    namespace?: ElementNamespace,
    prevChildren?: VNode<HostNode, HostElement>[],
    parentComponent?: ComponentInternalInstance | null,
    parentSuspense?: SuspenseBoundary | null,
    unmountChildren?: UnmountChildrenFn,
  ): void
  insert(el: HostNode, parent: HostElement, anchor?: HostNode | null): void
  remove(el: HostNode): void
  createElement(
    type: string,
    namespace?: ElementNamespace,
    isCustomizedBuiltIn?: string,
    vnodeProps?: (VNodeProps & { [key: string]: any }) | null,
  ): HostElement
  createText(text: string): HostNode
  createComment(text: string): HostNode
  setText(node: HostNode, text: string): void
  setElementText(node: HostElement, text: string): void
  parentNode(node: HostNode): HostElement | null
  nextSibling(node: HostNode): HostNode | null
  querySelector?(selector: string): HostElement | null
  setScopeId?(el: HostElement, id: string): void
  cloneNode?(node: HostNode): HostNode
  insertStaticContent?(
    content: string,
    parent: HostElement,
    anchor: HostNode | null,
    namespace: ElementNamespace,
    start?: HostNode | null,
    end?: HostNode | null,
  ): [HostNode, HostNode]
}

初看起来可能有点不理解,但是仔细看接口中的这些方法签名就能明白这些函数描述的都是如何处理一个具体的节点,这些节点其实是抽象的本地节点,并未规定一定是浏览器上的节点,比如insert方法,描述的是如何插入一个元素,那么在实现不同平台的渲染器的时候,我们就可以根据不同的平台特性进行实现了。

这样的设计同样是为了让渲染器的设计与实现解耦。

(五) 创建App

之前我们看到ensureRenderer().createApp(...args)代码,而这里的createApp函数正是我们上面看到的通过createAppAPI(render, hydrate)函数创建出来的。查看源码

为了便于理解,精简后的代码如下:

export function createAppAPI<HostElement>(
  render: RootRenderFunction<HostElement>,
  hydrate?: RootHydrateFunction,
): CreateAppFunction<HostElement> {
  return function createApp(rootComponent, rootProps = null) {
    ...
    const context = createAppContext()
    const installedPlugins = new WeakSet()

    let isMounted = false

    const app: App = (context.app = {
      _uid: uid++,
      _component: rootComponent as ConcreteComponent,
      _props: rootProps,
      _container: null,
      _context: context,
      _instance: null,

      version,

      use(plugin: Plugin, ...options: any[]) {
        ...
        return app
      },

      mixin(mixin: ComponentOptions) {
        ...
        return app
      },

      component(name: string, component?: Component): any {
        ...
        return app
      },

      directive(name: string, directive?: Directive) {
        ...
        return app
      },

      mount(
        rootContainer: HostElement,
        isHydrate?: boolean,
        namespace?: boolean | ElementNamespace,
      ): any {
        ...
      },

      unmount() {
        ...
      },

      provide(key, value) {
        ...
        return app
      },

      runWithContext(fn) {
        ...
      },
    })

    return app
  }
}

从代码中可以看到,创建应用的时候,首先通过const context = createAppContext()先创建了一个应用上下文,然后再通过const app: App = (context.app = {...,_context: context,...});将应用上下文和我们新建的app对象关联起来,返回给外部,同时,我们还看到上面的很多我们常用的方法的实现,比如:mount、component、directive等。

下面我们贴出这个createAppContext函数(查看源码)的源码,其实很简单,就是创建了一个空的App上下文,这个上下文的主要作用的保存App实例的状态,源码如下:

export function createAppContext(): AppContext {
  return {
    app: null as any,
    config: {
      isNativeTag: NO,
      performance: false,
      globalProperties: {},
      optionMergeStrategies: {},
      errorHandler: undefined,
      warnHandler: undefined,
      compilerOptions: {},
    },
    mixins: [],
    components: {},
    directives: {},
    provides: Object.create(null),
    optionsCache: new WeakMap(),
    propsCache: new WeakMap(),
    emitsCache: new WeakMap(),
  }
}

(六) 挂载

我们省略掉很多代码之后,挂载方法如下,我们可以看出,mount主要做了以下几件事:

  1. 根据应用根组件创建应用的VNode根节点
  2. 给根节点加上应用上下文
  3. 将根节点渲染到rootContainer容器中,这个rootContainer容器也就是我们应用的挂载点
  4. 返回应用的代理
mount(
  rootContainer: HostElement,
  isHydrate?: boolean,
  namespace?: boolean | ElementNamespace,
): any {
  if (!isMounted) {
    const vnode = createVNode(rootComponent, rootProps)
    // store app context on the root VNode.
    // this will be set on the root instance on initial mount.
    vnode.appContext = context

    if (namespace === true) {
      namespace = 'svg'
    } else if (namespace === false) {
      namespace = undefined
    }

    if (isHydrate && hydrate) {
      hydrate(vnode as VNode<Node, Element>, rootContainer as any)
    } else {
      render(vnode, rootContainer, namespace)
    }
    isMounted = true
    app._container = rootContainer
    // for devtools and telemetry
    ;(rootContainer as any).__vue_app__ = app

    return getExposeProxy(vnode.component!) || vnode.component!.proxy
  }
},

首先,值得注意的是,在将节点渲染到容器的时候有一个判断条件,isHydrate && hydrate,这个是当我们的页面是通过SSR初始化的时候,这时候,应用已经在服务端渲染过了,因此我们需要将虚拟节点与DOM节点水合,这个水合的过程以及渲染的核心逻辑我们就留着后续再分析吧。

另外,值得注意的是,我们的在第二步处忽略的一行代码app.mount = (containerOrSelector: Element | ShadowRoot | string): any => {...},这里重写了此处返回的mount方法,那么我们来看看之前被我们省略掉的代码:

 app.mount = (containerOrSelector: Element | ShadowRoot | string): any => {
    const container = normalizeContainer(containerOrSelector)
    if (!container) return

    const component = app._component
    if (!isFunction(component) && !component.render && !component.template) {
      component.template = container.innerHTML
    }

    // clear content before mounting
    container.innerHTML = ''
    const proxy = mount(container, false, resolveRootNamespace(container))
    if (container instanceof Element) {
      container.removeAttribute('v-cloak')
      container.setAttribute('data-v-app', '')
    }
    return proxy
  }

可以看到,这里主要是在挂载之前对目标容器做了处理,最后还是调用了createAppAPI函数生成的mount函数。

三、总结

vue单文件组件经过编译器编译成js和css文件,并通过vue提供的渲染器根据组件新建应用,执行渲染并挂载到dom容器中。

由于笔者的水平所限,文章可能存在不足和谬误,还请大家不吝指正。

⚡ 站长自研 · 极客在线工具箱 (Rust + WebAssembly) 查看全部工具 →
🔥 爆款 · 视频转GIF 视频转 GIF 动图在线制作工作台(支持帧率调节、色彩量化压缩与无水印导出) 📸 逐帧截图 · 台词拼图 视频高清逐帧截图、批量抽帧提取与九宫格故事板/台词长图拼接器 🎞️ 格式转换 · 音频提取 本地视频格式转换、码率瘦身压缩与无损音频 (WAV) 一键提取工作台 🔒 100% 本地 · 隐私级 100% 本地隐私级 WebP / AVIF / PNG / JPEG 批量转换压缩与 EXIF 擦除工作台 🎭 表情包 · 拆帧倒放 GIF 动图拆帧提取、一键倒放、变速抽帧瘦身与表情包字幕合成工坊 🪪 证件照 · 精准控KB 隐私级证件照/考试报名照换底色、精准控制 KB 大小与六寸冲印排版器 🛡️ 证件防盗 · 纯本地 身份证/营业执照/房产证防盗用隐私平铺水印相机与正反面 A4 拼版工具 🎵 音频剪辑 · 铃声截取 纯本地可视化音频波形剪辑、淡入淡出、变速变调与手机铃声截取器 🏠 提前还贷 · 省息决策 房贷(商贷/公积金/组合贷)与提前还贷划算度决策计算器(缩短年限 vs 减少月供) 🚗 买车避坑 · 油电对比 购车全款落地价、4S店车贷费率转真实年化 (IRR) 与油车 vs 电车 5 年回本计算器 🔍 利率照妖镜 · 真实IRR 信用卡分期 / 网贷 / 融资租赁真实年化利率 (IRR) 照妖镜与砍头息穿透计算器 💰 个税筹划 · 年终奖盲区 薪资五险一金税后到手 & 年终奖个税“多发1元多交数千税”临界盲区筹划计算器 🛒 凑单退货 · 外卖拼单AA 电商大促凑单满减退货实付分摊 & 多人点外卖/聚餐红包运费公平 AA 计算器 📈 复利定投 · FIRE退休 复利定投收益、通胀购买力折现与 FIRE(4%法则提前退休/养老金)财务自由模拟器 🏁 永久活码 · 扫码识别 全能艺术二维码生成工坊(WiFi连接码/挪车码/名片码)与本地批量扫码解码器 🏷️ 电商仓储 · A4批量排印 电商/仓储条形码 (EAN-13 / Code128 / UPC-A) 批量生成、校验位计算与 A4 不干胶排版打印 📄 零上传PDF · 转长图/合成 100% 本地零上传 PDF 页面提取、PDF 转高清长图与多图排版合成 A4 PDF 工作台 ✍️ 透明签名 · 扫描件漂白 手写签名照一键抠出透明背景电子签名 (PNG/SVG) & 手机拍文档去黑底阴影漂白器 🖥️ 屏幕坏点 · 键鼠双击验机 显示器屏幕坏点/漏光/高刷帧率 (Hz) & 鼠标微动双击故障/键盘全键无冲在线验机台 🏮 亲戚称呼 · 人生900格 中国三姑六婆亲戚称呼计算器 & 精确周岁虚岁/节气星座/人生 900 个月格子可视化 🎨 自媒体 · 爆款排版 自媒体爆款社交分享卡片与金句排版生成工坊 💼 自由职业 · 商务单据 自由职业者极速隐私报价单、服务确认函与商业发票生成器 💳 跨境支付 · 汇损穿透 全球跨境支付渠道真实手续费、隐性汇损与到账净额精算器 📊 独立开发 · SaaS 沙盘 独立开发与 Micro-SaaS 核心单元经济学、现金流推演与并购估值沙盘 🔥 热门 · Rust Wasm 全球大模型 (LLM API) Token 分词可视化与成本对比计算器 🔄 全栈多语言 · 离线转换 全栈多语言类型与数据结构转换工场 (JSON / YAML / SQL DDL / cURL) 📱 移动开发 · 博客联动 App 唤醒 (DeepLink / Universal Links / App Links) 配置生成与扫码调试器 🛡️ 免连钱包 · 离线安全 多链 RPC 节点真实延迟测速 & 交易 Calldata / ABI 离线安全解码器 🧪 原理实验室 · Vue3 编译 Vue 3 编译三步曲 (Token → AST → PatchFlags & Block Tree) 交互式可视化器 🧪 原理实验室 · 事件循环 JavaScript 事件循环 (Event Loop) 全队列单步推演沙盒(光杆站长模型) 🧪 原理实验室 · 快速 Diff Vue 3 响应式依赖收集 (Track/Trigger) 与快速 Diff (最长递增子序列 LIS) 步进推演器 🧪 原理实验室 · HTTP/3 HTTP/2 (TCP) vs HTTP/3 (QUIC) 0-RTT 握手与丢包队头阻塞 (HoL) 对比模拟器