从入口开始

我们之前提到过 Vue.js 构建过程，在 web 应用下，我们来分析 Runtime + Compiler 构建出来的 Vue.js，它的入口是 src/platforms/web/entry-runtime-with-compiler.js：

  1. /* @flow */
  3. import config from 'core/config'
  4. import { warn, cached } from 'core/util/index'
  5. import { mark, measure } from 'core/util/perf'
  7. import Vue from './runtime/index'
  8. import { query } from './util/index'
  9. import { compileToFunctions } from './compiler/index'
  10. import { shouldDecodeNewlines, shouldDecodeNewlinesForHref } from './util/compat'
  12. const idToTemplate = cached(id => {
  13.   const el = query(id)
  14.   return el && el.innerHTML
  15. })
  17. const mount = Vue.prototype.$mount
  18. Vue.prototype.$mount = function (
  19.   el?: string | Element,
  20.   hydrating?: boolean
  21. ): Component {
  22.   el = el && query(el)
  24.   /* istanbul ignore if */
  25.   if (el === document.body || el === document.documentElement) {
  26.     process.env.NODE_ENV !== 'production' && warn(
  27.       `Do not mount Vue to <html> or <body> - mount to normal elements instead.`
  28.     )
  29.     return this
  30.   }
  32.   const options = this.$options
  33.   // resolve template/el and convert to render function
  34.   if (!options.render) {
  35.     let template = options.template
  36.     if (template) {
  37.       if (typeof template === 'string') {
  38.         if (template.charAt(0) === '#') {
  39.           template = idToTemplate(template)
  40.           /* istanbul ignore if */
  41.           if (process.env.NODE_ENV !== 'production' && !template) {
  42.             warn(
  43.               `Template element not found or is empty: ${options.template}`,
  44.               this
  45.             )
  46.           }
  47.         }
  48.       } else if (template.nodeType) {
  49.         template = template.innerHTML
  50.       } else {
  51.         if (process.env.NODE_ENV !== 'production') {
  52.           warn('invalid template option:' + template, this)
  53.         }
  54.         return this
  55.       }
  56.     } else if (el) {
  57.       template = getOuterHTML(el)
  58.     }
  59.     if (template) {
  60.       /* istanbul ignore if */
  61.       if (process.env.NODE_ENV !== 'production' && config.performance && mark) {
  62.         mark('compile')
  63.       }
  65.       const { render, staticRenderFns } = compileToFunctions(template, {
  66.         shouldDecodeNewlines,
  67.         shouldDecodeNewlinesForHref,
  68.         delimiters: options.delimiters,
  69.         comments: options.comments
  70.       }, this)
  71.       options.render = render
  72.       options.staticRenderFns = staticRenderFns
  74.       /* istanbul ignore if */
  75.       if (process.env.NODE_ENV !== 'production' && config.performance && mark) {
  76.         mark('compile end')
  77.         measure(`vue ${this._name} compile`, 'compile', 'compile end')
  78.       }
  79.     }
  80.   }
  81.   return mount.call(this, el, hydrating)
  82. }
  84. /**
  85.  * Get outerHTML of elements, taking care
  86.  * of SVG elements in IE as well.
  87.  */
  88. function getOuterHTML (el: Element): string {
  89.   if (el.outerHTML) {
  90.     return el.outerHTML
  91.   } else {
  92.     const container = document.createElement('div')
  93.     container.appendChild(el.cloneNode(true))
  94.     return container.innerHTML
  95.   }
  96. }
  98. Vue.compile = compileToFunctions
  100. export default Vue

那么，当我们的代码执行 import Vue from 'vue' 的时候，就是从这个入口执行代码来初始化 Vue，那么 Vue 到底是什么，它是怎么初始化的，我们来一探究竟。

Vue 的入口

在这个入口 JS 的上方我们可以找到 Vue 的来源：import Vue from './runtime/index'，我们先来看一下这块儿的实现，它定义在 src/platforms/web/runtime/index.js 中：

  1. import Vue from 'core/index'
  2. import config from 'core/config'
  3. import { extend, noop } from 'shared/util'
  4. import { mountComponent } from 'core/instance/lifecycle'
  5. import { devtools, inBrowser, isChrome } from 'core/util/index'
  7. import {
  8.   query,
  9.   mustUseProp,
  10.   isReservedTag,
  11.   isReservedAttr,
  12.   getTagNamespace,
  13.   isUnknownElement
  14. } from 'web/util/index'
  16. import { patch } from './patch'
  17. import platformDirectives from './directives/index'
  18. import platformComponents from './components/index'
  20. // install platform specific utils
  21. Vue.config.mustUseProp = mustUseProp
  22. Vue.config.isReservedTag = isReservedTag
  23. Vue.config.isReservedAttr = isReservedAttr
  24. Vue.config.getTagNamespace = getTagNamespace
  25. Vue.config.isUnknownElement = isUnknownElement
  27. // install platform runtime directives & components
  28. extend(Vue.options.directives, platformDirectives)
  29. extend(Vue.options.components, platformComponents)
  31. // install platform patch function
  32. Vue.prototype.__patch__ = inBrowser ? patch : noop
  34. // public mount method
  35. Vue.prototype.$mount = function (
  36.   el?: string | Element,
  37.   hydrating?: boolean
  38. ): Component {
  39.   el = el && inBrowser ? query(el) : undefined
  40.   return mountComponent(this, el, hydrating)
  41. }
  43. // ...
  45. export default Vue

这里关键的代码是 import Vue from 'core/index'，之后的逻辑都是对 Vue 这个对象做一些扩展，可以先不用看，我们来看一下真正初始化 Vue 的地方，在 src/core/index.js 中：

  1. import Vue from './instance/index'
  2. import { initGlobalAPI } from './global-api/index'
  3. import { isServerRendering } from 'core/util/env'
  4. import { FunctionalRenderContext } from 'core/vdom/create-functional-component'
  6. initGlobalAPI(Vue)
  8. Object.defineProperty(Vue.prototype, '$isServer', {
  9.   get: isServerRendering
  10. })
  12. Object.defineProperty(Vue.prototype, '$ssrContext', {
  13.   get () {
  14.     /* istanbul ignore next */
  15.     return this.$vnode && this.$vnode.ssrContext
  16.   }
  17. })
  19. // expose FunctionalRenderContext for ssr runtime helper installation
  20. Object.defineProperty(Vue, 'FunctionalRenderContext', {
  21.   value: FunctionalRenderContext
  22. })
  24. Vue.version = '__VERSION__'
  26. export default Vue

这里有 2 处关键的代码，import Vue from './instance/index' 和 initGlobalAPI(Vue)，初始化全局 Vue API（我们稍后介绍），我们先来看第一部分，在 src/core/instance/index.js 中：

Vue 的定义

  1. import { initMixin } from './init'
  2. import { stateMixin } from './state'
  3. import { renderMixin } from './render'
  4. import { eventsMixin } from './events'
  5. import { lifecycleMixin } from './lifecycle'
  6. import { warn } from '../util/index'
  8. function Vue (options) {
  9.   if (process.env.NODE_ENV !== 'production' &&
  10.     !(this instanceof Vue)
  11.   ) {
  12.     warn('Vue is a constructor and should be called with the `new` keyword')
  13.   }
  14.   this._init(options)
  15. }
  17. initMixin(Vue)
  18. stateMixin(Vue)
  19. eventsMixin(Vue)
  20. lifecycleMixin(Vue)
  21. renderMixin(Vue)
  23. export default Vue

在这里，我们终于看到了 Vue 的庐山真面目，它实际上就是一个用 Function 实现的类，我们只能通过 new Vue 去实例化它。

有些同学看到这不禁想问，为何 Vue 不用 ES6 的 Class 去实现呢？我们往后看这里有很多 xxxMixin 的函数调用，并把 Vue 当参数传入，它们的功能都是给 Vue 的 prototype 上扩展一些方法（这里具体的细节会在之后的文章介绍，这里不展开），Vue 按功能把这些扩展分散到多个模块中去实现，而不是在一个模块里实现所有，这种方式是用 Class 难以实现的。这么做的好处是非常方便代码的维护和管理，这种编程技巧也非常值得我们去学习。

initGlobalAPI

Vue.js 在整个初始化过程中，除了给它的原型 prototype 上扩展方法，还会给 Vue 这个对象本身扩展全局的静态方法，它的定义在 src/core/global-api/index.js 中：

  1. export function initGlobalAPI (Vue: GlobalAPI) {
  2.   // config
  3.   const configDef = {}
  4.   configDef.get = () => config
  5.   if (process.env.NODE_ENV !== 'production') {
  6.     configDef.set = () => {
  7.       warn(
  8.         'Do not replace the Vue.config object, set individual fields instead.'
  9.       )
  10.     }
  11.   }
  12.   Object.defineProperty(Vue, 'config', configDef)
  14.   // exposed util methods.
  15.   // NOTE: these are not considered part of the public API - avoid relying on
  16.   // them unless you are aware of the risk.
  17.   Vue.util = {
  18.     warn,
  19.     extend,
  20.     mergeOptions,
  21.     defineReactive
  22.   }
  24.   Vue.set = set
  25.   Vue.delete = del
  26.   Vue.nextTick = nextTick
  28.   Vue.options = Object.create(null)
  29.   ASSET_TYPES.forEach(type => {
  30.     Vue.options[type + 's'] = Object.create(null)
  31.   })
  33.   // this is used to identify the "base" constructor to extend all plain-object
  34.   // components with in Weex's multi-instance scenarios.
  35.   Vue.options._base = Vue
  37.   extend(Vue.options.components, builtInComponents)
  39.   initUse(Vue)
  40.   initMixin(Vue)
  41.   initExtend(Vue)
  42.   initAssetRegisters(Vue)
  43. }

这里就是在 Vue 上扩展的一些全局方法的定义，Vue 官网中关于全局 API 都可以在这里找到，这里不会介绍细节，会在之后的章节我们具体介绍到某个 API 的时候会详细介绍。有一点要注意的是，Vue.util 暴露的方法最好不要依赖，因为它可能经常会发生变化，是不稳定的。

总结

那么至此，Vue 的初始化过程基本介绍完毕。这一节的目的是让同学们对 Vue 是什么有一个直观的认识，它本质上就是一个用 Function 实现的 Class，然后它的原型 prototype 以及它本身都扩展了一系列的方法和属性，那么 Vue 能做什么，它是怎么做的，我们会在后面的章节一层层帮大家揭开 Vue 的神秘面纱。

原文: https://ustbhuangyi.github.io/vue-analysis/prepare/entrance.html