vue-next/runtime-core 源码阅读指南详解

首先，需要明确阅读 vue-next/runtime-core 源码的目的是为了深入理解 Vue 3 的核心概念及其实现细节。这篇指南将带领读者了解该源码库的组织结构、核心模块的职责和交互关系，并给出示例代码帮助读者理解。以下是该指南的主要内容：

一、源码结构

1. 入口文件：index.ts
2. renderer 目录：处理组件的编译和渲染
3. reactivity 目录：处理 Vue 3 中的响应式数据
4. runtime-core 目录：处理 Vue 3 中组件实例的创建和更新
5. shared 目录：包含多个模块均可使用的共享代码

二、核心模块

1. renderer

该模块的主要职责是将 Vue 3 中的 template，转换为可执行的渲染函数，然后把它们保存在组件对象中。这个模块包含下面几个文件：

• createRenderer.ts
• component.ts
• apiCreateApp.ts
• patchProp.ts

createRenderer.ts 通过判断用户环境，创建不同类型的渲染器。例如，如果用户使用 Vue 3 的运行时版本，那么它返回一个仅包括渲染组件的核心渲染器；如果用户使用 Vue 3 的编译器+运行时版本，那么它返回同时包含编译器和渲染器的渲染器，从而能够处理 template。

component.ts 包含了组件实例化的逻辑。它定义了 createComponentInstance 函数，该函数实现了一个组件实例的创建和初始化过程。同时，该文件还实现了一些装饰器函数。这些装饰器函数通过添加属性和方法扩展了组件的行为和能力。

apiCreateApp.ts 用于初始化 Vue 3 应用程序。它以及它所依赖的模块，负责处理用户传入的参数等。

patchProp.ts 定义了属性更新的逻辑。当渲染器执行时，每个组件实例的属性会根据自身状态的变化而发生变化。

2. reactivity

reactivity 模块是 Vue 3 中响应式系统的实现。该模块的主要文件包括：

• reactive.ts
• ref.ts
• effect.ts
• computed.ts

这些文件定义了 Vue 3 中响应式数据的基本 API，例如 reactive、ref、computed、watchEffect 等。

reactive.ts 中定义了 reactive、isReactive、isReadonly、isProxy 等方法，它们可以在代码中判断对象是否是响应式的、是否是只读的等。

ref.ts 中定义了 ref、isRef 等方法，用于处理含有单一状态值的响应式对象。例如：const count = ref(0)，count 将被绑定到一个响应式对象里，包含 value、__v_isRef 等属性。

effect.ts 中定义了 effect、isEffect、stop 等方法，用于观察响应式对象的变化，并在变化时执行指定的函数。

computed.ts 中定义了 computed、isComputed、stop 等方法。它允许我们定义可以根据其他响应式数据自动计算产生的数据，类似于 Vue 2 中的计算属性。

3. runtime-core

runtime-core 是 Vue 3 中组件创建和更新的核心模块。该模块的主要文件包括：

• component.ts
• vnode.ts
• lifecycle.ts
• renderer.ts
• componentRenderUtils.ts

component.ts 实现了组件实例的创建，以及 setup、watchEffect、onUnmounted 等生命周期函数的挂载。

vnode.ts 定义了组件和元素节点的 VNode 类型，并提供了一些辅助函数，例如 h 函数、cloneVNode 函数等。

lifecycle.ts 定义了组件生命周期的实现逻辑。该文件中还实现了一些辅助函数，例如 callWithErrorHandling、invokeDirectiveHook 等，用于在组件的生命周期函数以及自定义指令钩子函数中执行指定的函数。

renderer.ts 在 renderer 模块中已经讲解过。

componentRenderUtils.ts 中实现了一些组件渲染相关的实用函数。

三、示例

以下是两个示例，用于帮助读者更好地理解 runtime-core 模块：

1. 实现一个简单的响应式数据

import { reactive, effect } from '@vue/reactivity';

const obs = reactive({
  count: 0,
});

effect(() => {
  console.log(`obs.count: ${obs.count}`);
});

obs.count++; // 输出: obs.count: 1

在上面的代码中，我们使用了 reactive 函数包装了一个形如 {count: 0} 的对象，使之变成响应式的对象，即可以监听到其属性变化并触发响应函数。然后我们使用effect()函数，为 obs.count 添加监听函数，每次obs.count的值变化时，都将使用console.log查看其值，最后我们对 obs.count 进行自增操作，命令行输出： obs.count: 1。

2. 创建一个简单的组件

import { createApp, reactive, ref } from 'vue';
import { h } from 'vue/runtime-core';

const app = createApp({
  setup() {
    const count = ref(0);
    const state = reactive({
      message: 'Hello, Vue!',
    });
    const increment = () => {
      count.value++;
    };
    return { count, state, increment };
  },
  render() {
    return h('div', [
      h('h1', this.state.message),
      h('p', `The count is ${this.count}`),
      h('button', { onClick: this.increment }, 'Increment'),
    ]);
  },
});

app.mount('#app');

这个代码创建了一个简单的 Vue 3 组件，并把它挂载到了某个 ID 为 "app" 的 DOM 节点上。在组件的 setup 函数中，使用 ref 和 reactive 函数定义了一个响应式的状态和一个计数器变量。

在 render 函数中，使用 h 函数创建了一个 div 元素，并添加了一个 h1 标签、一个 p 标签和一个 button 按钮。为 button 绑定了一个点击事件，每次点击会执行 increment 函数，并把 count 的值自增。过程中页面会根据count的变化而重新渲染。