vue-cli-multi-page: A JavaScript repository from cxh0312

Error in user YAML: (<unknown>): found character that cannot start any token while scanning for the next token at line 4 column 2

---
title: vue-cli + webpack 多页面实例配置方法
date: 2016-8-26
tags: 
-	vuejs
-	多页面
-	webpack

---

vue+webpack是否有多页面

目前使用vue来做项目，估计大部分都是单页面（SPA）应用，一个轻型的 MVVM 框架，谁用了MVVM框架，就再也回不去JQ时代了，哈哈。

在手机端的项目，使用vue + vue-router是high到爆，不仅仅是我们开发的而言，最主要的用户体检也是开足马力，体检感杠杠的。

那问题来了，使用vue+webpack的单页面是爽到爆，那如果是多页面也能不能high到爆呢？那当然呀，必须的必，vue、webpack的忠粉（哈哈，好像这忠粉不关系到多页面的）。

在谷歌找vue 多页面，实例还是比较少，功夫不负有心人，在yaoyao1987那找到了，具体可以到这个yaoyao1987 github，非常感谢yaoyao1987童鞋，今天要讲的内容是基于yaoyao1987童鞋的多页面实例上再优化的。

优化了点啥

demo、github地址

1、demo：http://v.lanchenglv.com/demo/vue-cli-multi-page/module/login.html 2、github：https://github.com/bluefox1688/vue-cli-multi-page

优化的内容

我们先来讲讲，具体我们优化了什么内容。

增加全局统一使用的模块Lib.js库，可能这里看不明白，不要紧，后面会讲到。
支持字体图标
增加干净的页面、组件的模板，复制即可以使用。
去掉多余的代码注释，坑了我的注释，别再坑人了
构建时，增加对css打包的支持
提取公共模块 ........

使用方法

# 安装
npm install

# 调试环境 serve with hot reload at http://localhost:8083/module/login.html
npm run dev

# 生产环境 build for production with minification
npm run build

本地默认访问端口为8083，需要更改的童鞋请到项目根目录文件config.js修改。

目录结构

webpack
 |---build
   |---src
     |---assets 资源
     	 |---css.css  css
         |---img  图片文件
         |---font/  字体图标
     |---components 组件
     	  |---Button.vue  按钮组件
          |---module-head.vue  head组件
     |---module各个页面模块
       |---login    登陆模块
         |---login.html
         |---login.js
         |---app.vue
       |---welcome       欢迎页模块
         |---welcome.html
         |---welcome.js
         |---app.vue

从目录结构上，各种组件、页面模块、资源等都按类新建了文件夹，方便我们储存文件。其实我们所有的文件，最主要都是放在module文件夹里，以文件夹名为html的名称。例如

 |---login    登陆模块
   |---login.html
   |---login.js
   |---app.vue

就是我们访问时的地址：

http://localhost:8083/module/login.html

这里一定要记住，在module里下级文件夹，一个文件夹就是一个html，js``vue template 都统一放在当前文件夹里，当然你也可以继续放其他的资源，例如css、图片等，webpack会打包到当前页面里。如果项目不需要这个页面了，可以直接把这个文件夹直接删除掉，干净项目，干活也开心。像以前我们传统开发项目，所有的图片都习惯放在images里，当项目有改动时，有些图片等资源用不上了，但还占着坑位，虽然现在的硬件容量大到惊人，但我们应该还是要养到一个良好的习惯。当前页面的开发在app.vue里，打开后你就会看到很熟悉的<template>、<script>、<style scoped>了。

全局统一公共模块

我们做多页面开发，那肯定会涉及到全局都能调用的公共库，或者是把别人封装的库也一起打包在全局公共模块里。

如果看过源码的童鞋，在*.vue页面里，我都统一import了一个文件

import Lib from 'assets/Lib.js'

这就是全局统一公共模块，我们先看看Lib.js里的代码

# 导入全局的css
import 'assets/css.css';
# 导入全局的站点配置文件
import C from 'assets/conf';
# 导入全局的共用事件
import M from 'assets/common';

var Rxports = {
	M,C
};

module.exports = Rxports

在上方代码的M、C都是什么鬼，聪明的小伙伴就知道我想干嘛了，省写少事呗。例如我们现在想调用APP的名称，在.vue里可以这么写

import Lib from 'assets/Lib.js'
Lib.C.appname;  # 蓝锅锅

只需要在*.vue里导入import Lib from 'assets/Lib.js'，就可以到处使用全局模块了。不再像传统的开发模式，需要一堆的<script>一个一个的来放到页面的底部。传统方式：

<script type='text/javascript' src='//g.alicdn.com/sj/lib/zepto/zepto.min.js' charset='utf-8'></script>
></script>
  <script type='text/javascript' src='//g.alicdn.com/msui/sm/0.6.2/js/sm.min.js' charset='utf-8'></script>
<script type="text/javascript" src="http://res.wx.qq.com/open/js/jweixin-1.0.0.js"></script>

这里就是我想讲的关于优化的第一点提到的全局模块库。当然也有童鞋问呀，会不会每个页面都会把这些全局模块库都打包在当前页面，那JS文件体积大到惊人。哎呀，你当webpack是二货的呀，webpack会自动帮你处理好的，会把在*.vue里的import Lib from 'assets/Lib.js'的库自动提取出来，放到一个全局的JS文件里，这就是自动构造的神奇呀，省心省电，妈妈再也不用担心我做重复的工作了。

在Lib.js里，我们也看到有两个导入的JS文件，主要来做什么的呢？为了更好的在全局调用模块里，知道哪个模块的作用是什么，另外在写代码时更能快速查找到JS文件，我区分了配置文件和共用事件文件，即conf、common，下面说下具体的用途。

# 储存站点的配置，例如web的名称、LOGO地址等
import C from 'assets/conf';
# 导入全局的共用事件，例如在微信的JS SDK初始化，每个页面都要分享，都需要初始化的，一次调用，全局使用，棒！！
import M from 'assets/common';

当然，你也可以不像这样区分不同的JS文件，删除也没有影响的，具体也要看项目的需要而定，不能死读书。

另外，如果想要干净的页面模块模板，可以到根目录的tpl里复制module_tpl整个文件夹，然后粘贴到src/module目录下马上就可以进行开发了，开发之前记得在cmd里npm run dev跑一遍，新增页面都要重新dev一遍。

module我们就讲到这里，下面我们来讲讲组件的调用，最爱组件了。

组件的使用

组件（Component）是 vue.js 最强大的功能之一，当你发现使用组件可以减少造轮子里，你会深深的爱上它。我们的组件都是放在components目录下的，调用组件的方法也很简单。

import Button from 'components/Button';

然后记得在*.vue注册导入的组件，要不然会影响使用。

import Button from 'components/Button';
export default {
  data() {
    return {
    	
    }
  },
  components: {
   # 在这里注册组件，不注册组件的话，是无法使用的。
	Button	
  } 
}

如果想要干净的组件模板，可以到根目录的tpl里找到components_tpl的Hello.vue文件，复制粘贴到components目录下马上就可以进行开发了。

图标字体

在yaoyao1987童鞋里，是没有打包构造图标字体的代码逻辑，这也是我优化上去的一部分，建议使用iconfont图标（http://www.iconfont.cn），强大到无所不能，可以到iconfont下载自己想要的图标字体，记得是把文件放到\src\assets\font文件夹里。

webpack会自动打包的，无需理会，另外还有一点，iconfont提供的css文件，复制到\src\assets\css.css文件即可，要不然没有效果哈。在*.vue里使用调用就行了。

<i class="iconfont">&#33</i>

构建代码说明

那我们使用的是vue-cli的手脚架，用过vue+cli的朋友知道主要构建代码都放在根目录build下，vue多页面主要修改了这三个JS文件webpack.base.conf.js、webpack.dev.conf.js、webpack.prod.conf.js

# 【webpack.base.conf.js】主要是构建的全局设置，主要是增加了以下代码，已经增加在JS文件里，这里只是做一个补充说明，具体请看`build/webpack.base.conf.js`。

var entries = getEntry('./src/module/**/*.js'); // 获得入口js文件
var chunks = Object.keys(entries);

plugins: [
   // 提取公共模块
    new webpack.optimize.CommonsChunkPlugin({
      name: 'vendors', // 公共模块的名称
      chunks: chunks, // chunks是需要提取的模块
      minChunks: chunks.length
    }),
   // 配置提取出的样式文件
    new ExtractTextPlugin('css/[name].css')
 ]

function getEntry(globPath) {
  var entries = {},
    basename, tmp, pathname;

  glob.sync(globPath).forEach(function (entry) {
    basename = path.basename(entry, path.extname(entry));
    tmp = entry.split('/').splice(-3);
    pathname = tmp.splice(0, 1) + '/' + basename; // 正确输出js和html的路径
    entries[pathname] = entry;
  });
  
  return entries;
}

这里还要做一个特别说明，我们每次更新资源文件，为了去缓存，都会给文件生成hash值，例如：

<script type='text/javascript' src='vendors.61714a310523a3df9869.js' charset='utf-8'></script>
<script type='text/javascript' src='vendors.js?f3aaf25de220e214f84e' charset='utf-8'></script>

这两者都是为了去缓存，唯一的区别的生成的文件名不一样，有些项目，为了可以能出严重BUG时第一时间回滚，以文件名+hash的方式储存，每次生成都不会覆盖之前的代码，以方便查BUG或者回滚。另一种方式，就是以文件名+?hash的方式储存，每次都会覆盖之前生成的资源，方便在某些特殊项目使用。我在webpack.base.conf.js也已经注释说明了。

module.exports = {
  entry: entries,
  output: {
    path: config.build.assetsRoot,
    publicPath: config.build.assetsPublicPath,
	/* ---- 生成的例子 vendors.61714a310523a3df9869.js --- */
    //filename: '[name].[hash].js'
	/* ---- 生成的例子 vendors.js?f3aaf25de220e214f84e --- */
    filename: '[name].js'
  }
}

结束言

不知不觉时间又过去，啰嗦一堆堆的，每个项目需求都不一样，配置也会有许不同，也希望更多的朋友分享自己的代码和想法出来哈，也可以一起交流。有需要一起交流的可以加我的微信，amwhuang，记得备注技术交流哈。

首发博客地址：http://lanchenglv.com/article/2016/0826/vue-cli_webpack_multi-page.html

cxh0312/vue-cli-multi-page