Vuejs 的 dist 文件使用指南

问题

项目里几个 Vuejs 版本都遇到过 vue.runtime.common.js 的报错提示：

vue 2.0.7

vue.runtime.common.js:519 [Vue warn]: Failed to mount component: template or render function not defined.

vue 2.1.0

vue.runtime.common.js:511 [Vue warn]: Failed to mount component: template or render function not defined.

vue 2.2.6

vue.runtime.common.js:556 [Vue warn]: You are using the runtime-only build of Vue where the template compiler is not available. Either pre-compile the templates into render functions, or use the compiler-included build.

缘由

查了 Vuejs 的 Release log 和 Readme 等，找出缘由是 Vuejs 区分 Full 与 Runtime-only 版本。平时的 Vue Single File Component （即 .vue 后缀文件）不须要 Full 版本，直接 import Vue from 'vue' 便可。

而若是用到 Vue.extend({}) 手动构造 Vue 组件的， import Vue from 'vue' 会报上面的错误。要换成 vue/dist/vue.js 或 vue/dist.common.js 或 vue/dist/vue.esm.js （更多可看 : Vue Github/Explanation of Build Files ）。

个人各项目的 Vue 版本由于某些缘由暂时没对齐，因此要把各版本的整理下。

解决方案

这里使用 Webpack 配置 Vuejs 的 alias 为例，整理为 3 个版本的配置。使用时 import vue from 'fullVue' 加载 Full 版本。

module.exports = {
  // ...
  resolve: {
    alias: {
      'fullVue': 'vue/dist/vue.esm.js' // vue 2.2.0 及之后并使用 webpack 2.0
    }
  }
}

module.exports = {
  // ...
  resolve: {
    alias: {
      'fullVue': 'vue/dist/vue.common.js' // vue 2.1.0 及之后，vue 2.2.0 之前, 或者 vue 2.2.0 之后但使用 webpack 1.0
    }
  }
}

module.exports = {
  // ...
  resolve: {
    alias: {
      'fullVue': 'vue/dist/vue.js' // vue 2.1.0 之前
    }
  }
}

后记

Vuejs 是个很潮的框架，各类新东西都被做者引入进来。好比 2.2.0 的 Release log 介绍：

The default export used by Webpack 2 will now point to an ES module build (dist/vue.runtime.esm.js). This means without any alias configuration, require('vue') in webpack 2 will give you an object ({ __esModule: true, default: Vue }) instead. You should only use import Vue from 'vue' with webpack 2.

还有 vue-loader 史无前例的 style 块新语法，让 Vue Single File Component 支持覆盖子组件样式问题：

.foo >>> .bar { color: red; }

vue-loader 最近的 release 表示能够用 /deep/ 代替 >>>

<style scoped> now support "deep" selectors that can affect child components using the >>> combinator:

用这么潮的框架，就是累人啊啊啊啊。