• 从入口开始
    • Vue 的入口
      • Vue 的定义
      • initGlobalAPI
    • 总结

    从入口开始

    我们之前提到过 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