Vue.js 源码学习笔记

最近饶有兴致的又把最新版 Vue.js 的源码学习了一下,觉得真心不错,个人觉得 Vue.js 的代码非常之优雅而且精辟,作者本身可能无 (bu) 意 (xie) 提及这些。那么,就让我来吧:)

程序结构梳理

Vue 程序结构

Vue.js 是一个非常典型的 MVVM 的程序结构,整个程序从最上层大概分为

  1. 全局设计:包括全局接口、默认选项等
  2. vm 实例设计:包括接口设计 (vm 原型)、实例初始化过程设计 (vm 构造函数)

这里面大部分内容可以直接跟 Vue.js 的官方 API 参考文档对应起来,但文档里面没有且值得一提的是构造函数的设计,下面是我摘出的构造函数最核心的工作内容。

Vue 实例初始化

整个实例初始化的过程中,重中之重就是把数据 (Model) 和视图 (View) 建立起关联关系。Vue.js 和诸多 MVVM 的思路是类似的,主要做了三件事:

  1. 通过 observer 对 data 进行了监听,并且提供订阅某个数据项的变化的能力
  2. 把 template 解析成一段 document fragment,然后解析其中的 directive,得到每一个 directive 所依赖的数据项及其更新方法。比如 v-text="message" 被解析之后 (这里仅作示意,实际程序逻辑会更严谨而复杂):
    1. 所依赖的数据项 this.$data.message,以及
    2. 相应的视图更新方法 node.textContent = this.$data.message
  3. 通过 watcher 把上述两部分结合起来,即把 directive 中的数据依赖订阅在对应数据的 observer 上,这样当数据变化的时候,就会触发 observer,进而触发相关依赖对应的视图更新方法,最后达到模板原本的关联效果。

所以整个 vm 的核心,就是如何实现 observer, directive (parser), watcher 这三样东西


文件结构梳理

Vue.js 源代码都存放在项目的 src 目录中,我们主要关注一下这个目录 (事实上 test/unit/specs 目录也值得一看,它是对应着每个源文件的测试用例)。

src 目录下有多个并列的文件夹,每个文件夹都是一部分独立而完整的程序设计。不过在我看来,这些目录之前也是有更立体的关系的:

Vue 文件结构

  • 首先是 api/* 目录,这几乎是最“上层”的接口封装,实际的实现都埋在了其它文件夹里
  • 然后是 instance/init.js,如果大家希望自顶向下了解所有 Vue.js 的工作原理的话,建议从这个文件开始看起
    • instance/scope.js:数据初始化,相关的子程序 (目录) 有 observer/*watcher.jsbatcher.js,而 observer/dep.js 又是数据观察和视图依赖相关联的关键
    • instance/compile.js:视图初始化,相关的子程序 (目录) 有 compiler/*directive.jsparsers/*
  • 其它核心要素:directives/*element-directives/*filters/*transition/*
  • 当然还有 util/* 目录,工具方法集合,其实还有一个类似的 cache.js
  • 最后是 config.js 默认配置项

篇幅有限,如果大家有意“通读” Vue.js 的话,个人建议顺着上面的整体介绍来阅读赏析。

接下来是一些自己觉得值得一提的代码细节

一些不容错过的代码/程序细节

this._eventsCount 是什么?

一开始看 instance/init.js 的时候,我立刻注意到一个细节,就是 this._eventsCount = {} 这句,后面还有注释

eventsCount1

for $broadcast optimization

非常好奇,然后带着疑问继续看了下去,直到看到 api/events.js$broadcast 方法的实现,才知道这是为了避免不必要的深度遍历:在有广播事件到来时,如果当前 vm 的 _eventsCount0,则不必向其子 vm 继续传播该事件。而且这个文件稍后也有 _eventsCount 计数的实现方式。

eventsCount2

eventsCount3

这是一种很巧妙同时也可以在很多地方运用的性能优化方法。

数据更新的 diff 机制

前阵子有很多关于视图更新效率的讨论,我猜主要是因为 virtual dom 这个概念的提出而导致的吧。这次我详细看了一下 Vue.js 的相关实现原理。

实际上,视图更新效率的焦点问题主要在于大列表的更新和深层数据更新这两方面,而被热烈讨论的主要是前者 (后者是因为需求小还是没争议我就不得而知了)。所以这里着重介绍一下 directives/repeat.js 里对于列表更新的相关代码。

diff1

首先 diff(data, oldVms) 这个函数的注释对整个比对更新机制做了个简要的阐述,大概意思是先比较新旧两个列表的 vm 的数据的状态,然后差量更新 DOM。

diff2

第一步:遍历新列表里的每一项,如果该项的 vm 之前就存在,则打一个 _reused 的标 (这个字段我一开始看 init.js 的时候也是困惑的…… 看到这里才明白意思),如果不存在对应的 vm,则创建一个新的。

diff3

第二步:遍历旧列表里的每一项,如果 _reused 的标没有被打上,则说明新列表里已经没有它了,就地销毁该 vm。

diff4

第三步:整理新的 vm 在视图里的顺序,同时还原之前打上的 _reused 标。就此列表更新完成。

顺带提一句 Vue.js 的元素过渡动画处理 (v-transition) 也设计得非常巧妙,感兴趣的自己看吧,就不展开介绍了

组件的 [keep-alive] 特性

keepAlive1

keepAlive2

Vue.js 为其组件设计了一个 [keep-alive] 的特性,如果这个特性存在,那么在组件被重复创建的时候,会通过缓存机制快速创建组件,以提升视图更新的性能。代码在 directives/component.js

数据监听机制

如何监听某一个对象属性的变化呢?我们很容易想到 Object.defineProperty 这个 API,为此属性设计一个特殊的 getter/setter,然后在 setter 里触发一个函数,就可以达到监听的效果。

ob

不过数组可能会有点麻烦,Vue.js 采取的是对几乎每一个可能改变数据的方法进行 prototype 更改:

ob_array1

但这个策略主要面临两个问题:

  1. 无法监听数据的 length,导致 arr.length 这样的数据改变无法被监听
  2. 通过角标更改数据,即类似 arr[2] = 1 这样的赋值操作,也无法被监听

为此 Vue.js 在文档中明确提示不建议直接角标修改数据

ob_array2

同时 Vue.js 提供了两个额外的“糖方法” $set$remove 来弥补这方面限制带来的不便。整体上看这是个取舍有度的设计。我个人之前在设计数据绑定库的时候也采取了类似的设计 (一个半途而废的内部项目就不具体献丑了),所以比较认同也有共鸣。

path 解析器的状态机设计

首先要说 parsers 文件夹里有各种“财宝”等着大家挖掘!认真看一看一定不会后悔的

parsers/path.js 主要的职责是可以把一个 JSON 数据里的某一个“路径”下的数据取出来,比如:

var path = 'a.b[1].v'
var obj = {
  a: {
    b: [
      {v: 1},
      {v: 2},
      {v: 3}
    ]
  }
}
parse(obj, path) // 2

所以对 path 字符串的解析成为了它的关键。Vue.js 是通过状态机管理来实现对路径的解析的:

state1

咋一看很头大,不过如果再稍微梳理一下:

state graph

也许看得更清楚一点了,当然也能发现其中有一点小问题,就是源代码中 inIdent 这个状态是具有二义性的,它对应到了图中的三个地方,即 in ident 和两个 in (quoted) ident

实际上,我在看代码的过程中顺手提交了这个 bug,作者眼明手快,当天就进行了修复,现在最新的代码里已经不是这个样子了:

state2

而且状态机标识由字符串换成了数字常量,解析更准确的同时执行效率也会更高。

一点自己的思考

首先是视图的解析过程,Vue.js 的策略是把 element 或 template string 先统一转换成 document fragment,然后再分解和解析其中的子组件和 directives。我觉得这里有一定的性能优化空间,毕竟 DOM 操作相比之余纯 JavaScript 运算还是会慢一些。

然后是基于移动端的思考,Vue.js 虽确实已经非常非常小巧了 (min+gzip 之后约 22 kb),但它是否可以更小,继续抽象出常用的核心功能,同时更快速,也是个值得思考的问题。

第三我非常喜欢通过 Vue.js 进行模块化开发的模式,Vue 是否也可以借助类似 web components + virtual dom 的形态把这样的开发模式带到更多的领域,也是件很有意义的事情。

总结

Vue.js 里的代码细节还不仅于此,比如:

  • cache.js 里的缓存机制设计和场景运用 (如在 parsers/path.js 中)
  • parsers/template.js 里的 cloneNode 方法重写和对 HTML 自动补全机制的兼容
  • 在开发和生产环境分别用注释结点和不可见文本结点作为视图的“占位符”等等

自己也在阅读代码,了解 Vue.js 的同时学到了很多东西,同时我觉得代码实现只是 Vue.js 优秀的要素之一,整体的程序设计、API 设计、细节的取舍、项目的工程考量都非常棒!

总之,分享一些自己的收获和代码的细节,希望可以帮助大家开阔思路,提供灵感。

40 条早期评论

  • 姓名
    傅小黑
    评论日期
    2015/07/26 11:48:17
  • 姓名
    chaoren1641
    评论日期
    2015/07/28 11:32:03
    32个赞
  • 姓名
    评论日期
    2017/09/12 09:50:53
  • 姓名
    kid
    评论日期
    2015/08/07 11:05:05
    码下以后仔细看
  • 姓名
    comver
    评论日期
    2015/09/27 03:37:52
    学习了!
  • 姓名
    cxczy
    评论日期
    2015/11/16 05:27:36
    总结的很好,Vue如此小巧却又这么多优点
  • 姓名
    SimplyY
    评论日期
    2016/02/22 09:13:55
    文件结构梳理 标题下有错别字

    这些目录之前也是有更立体的关系的:

    之前应该是之间
  • 姓名
    评论日期
    2016/04/28 11:22:42
    恩,这篇文章写的挺好,去年收藏的,今天才看也是醉醉的。
  • 姓名
    Vue ES6 Jade Scss Webpack Gulp | 神刀安全网
    评论日期
    2016/05/09 02:30:48
    [...]Vue篇 Vue.js:轻量高效的前端组件化方案 来自Vue作者 尤雨溪 Vue官方教程 Vue.js 源码学习笔记 来自 囧克斯 vue-router文档 Vue 组件化开发实践 mvvm学习&vue实践小结[...]
  • 姓名
    张三
    评论日期
    2016/05/10 02:39:47
    看到代码里面一会儿 $,一会儿 _,我就再也没有兴趣学这个框架了
  • 姓名
    李思葱
    评论日期
    2016/05/18 05:55:47
    请问博主这么漂亮的图是如何画出来的?
  • 姓名
    coderYin
    评论日期
    2016/07/17 11:24:22
    思维导图
  • 姓名
    Colliot
    评论日期
    2018/02/24 01:10:04
    那对源码的批注图呢?
  • 姓名
    luobotang
    评论日期
    2016/07/20 05:23:37
    文章和Vue的作者都很棒!
  • 姓名
    轩辕Rowboat
    评论日期
    2016/08/22 12:43:25
    感谢博主,暂时还没到阅读源码的阶段。
  • 姓名
    Vue.js入门参考资料 R11; 鹏仔
    评论日期
    2016/08/29 06:12:26
    [...]Vue.js 源码学习笔记[...]
  • 姓名
    刘成
    评论日期
    2016/09/05 05:24:33
    阿姨的网站字好大,看得眼睛发胀。。。
  • 姓名
    睡觉
    评论日期
    2016/10/04 08:57:21
    底部after伪元素看着很烦。。要么黑色,要么删掉行么。。。
  • 姓名
    睡觉
    评论日期
    2016/10/04 11:03:22
    窗口没有滚动到底部的时候,那个fixed还是稍微影响阅读的。。
    不过,直接到底部看着确实不错
  • 姓名
    dodo
    评论日期
    2016/11/09 01:58:45
    感谢分享~
    请问,这篇博文是基于哪个版本的产出?
  • 姓名
    金山
    评论日期
    2016/11/28 03:56:17
    虽然对于我这种的初级程序来说。貌似很吊。点赞66666666666666666666666666666666666666666666666666666666666666666
  • 姓名
    yuguangde
    评论日期
    2016/11/29 09:56:28
    这是vue的哪个版本啊,感觉目录结构和我看的不一样
  • 姓名
    Nine
    评论日期
    2017/08/24 06:14:05
    vue官方github仓库切换branch就能看到了!
  • 姓名
    茄果
    评论日期
    2016/12/12 11:09:39
    文字好大,我猜现在四爷有点老花了?
  • 姓名
    nobrokenboy
    评论日期
    2017/02/20 04:05:35
    请问博主分析的是vue1.0的还是vue2.0的呢,博主写的好深奥,菜鸟表示看不懂,
  • 姓名
    x373241884y
    评论日期
    2017/06/02 12:33:06
    讲的不错!
  • 姓名
    Nine
    评论日期
    2017/08/24 06:07:53
    厉害!
  • 姓名
    frank
    评论日期
    2017/09/27 07:48:20
    厉害了
  • 姓名
    VueJS学习资料大全 | Worktle.com
    评论日期
    2017/11/24 11:28:56
    [...]Vue.js 源码学习笔记[...]
  • 姓名
    vuejs
    评论日期
    2017/12/05 10:59:06
    Vue.js视频教程www.it448.com/forum.php?mod=forumdisplay&fid=43
  • 姓名
    优质前端博客 R11; 小越越的blog
    评论日期
    2018/01/11 10:11:57
    [...]《Vue.js 源码学习笔记》[...]
  • 姓名
    zuank
    评论日期
    2018/02/02 11:54:30
    便利 -> 遍历
  • 姓名
    囧克斯
    评论日期
    2018/02/06 01:18:04
    @zuank

    已更正,感谢
  • 姓名
    阅夏
    评论日期
    2018/03/29 11:33:16
    请问,这篇文章分析的是v0.11版本吗?
  • 姓名
    Vue源码解读相关(读完后会做一些总结) R11; x
    评论日期
    2018/06/06 05:39:17
    [...]1.Vue.js 源码学习笔记 http://jiongks.name/blog/vue-code-review/[...]
  • 姓名
    Vue原始碼解讀相關(讀完後會做一些總結) - 程序員的後花園
    评论日期
    2018/06/08 09:16:49
    [...]1.Vue.js 原始碼學習筆記 http://jiongks.name/blog/vue-code-review/[...]
  • 姓名
    ja<x>vasc<x>ript 进阶之深入理解数据双向绑定 - 奇奇问答
    评论日期
    2018/06/12 09:15:29
    [...]Vue.js 源码学习笔记[...]
  • 姓名
    Vue.js资源分享 - 奇奇问答
    评论日期
    2018/06/13 02:32:56
    [...]Vue.js 源码学习笔记[...]
  • 姓名
    VueJS原始碼學習——專案結構&amp;目錄 | 程式前沿
    评论日期
    2018/06/23 06:33:41
    [...]囧克斯的一篇原始碼解析文章[...]
  • 姓名
    薛恒飞
    评论日期
    2018/07/24 10:07:24
    明人不说暗话 我真的看不懂,虽然我已经看了好几天vue了