基于vue-cli搭建一个多页面应用-原创手记-慕课网

上篇文章中，我们已经成功使用yarn创建了一个vue项目，但是项目模板是单页面应用，与多页面应用还有些差别，所以现在需要在此基础上做一些调整：
关于多页面应用调整的思路分为以下两个部分
一、项目目录结构调整

左一为项目目录原结构图，右一为修改过后的项目目录结构

1、在开发路径src下增加modules和pages文件夹，分别存放模块和页面。
2、有关页面的所有文件都放到同一文件夹下就近管理：
      index.html(页面模板)、
      main.js(页面入口文件)、
      App.vue(页面使用的组件，公用组件放到components文件夹下)、
      router(页面的路由配置)、
      assets(页面的静态资源)
      把这些列出的文件都移到index文件夹下，并把main.js改为index.js,保证页面的入口js文件和模板文件的名称一致。

二、webpack配置调整
项目目录调整好后，我们来进行webpack配置的调整，步骤如下：
1、在build/utils.js中添加两个方法：webpack多入口文件和多页面输出

var path = require('path')var glob = require('glob')var HtmlWebpackPlugin = require('html-webpack-plugin')  //对每个页面单独打包生成一个新页面的插件var PAGE_PATH = path.resolve(__dirname, '../src/pages')var merge = require('webpack-merge')//多入口配置exports.entries = function() {  var entryFiles = glob.sync(PAGE_PATH + '/*/*.js')  var map = {}
  entryFiles.forEach((filePath) => {    var filename = filePath.substring(filePath.lastIndexOf('\/') + 1, filePath.lastIndexOf('.'))
    map[filename] = filePath
  })  return map
}//多页面输出配置exports.htmlPlugin = function() {  let entryHtml = glob.sync(PAGE_PATH + '/*/*.html')  let arr = []
  entryHtml.forEach((filePath) => {    let filename = filePath.substring(filePath.lastIndexOf('\/') + 1, filePath.lastIndexOf('.'))    let conf = {      template: filePath,      filename: filename + '.html',      chunks: [filename],      inject: true
    }    if (process.env.NODE_ENV === 'production') {
      conf = merge(conf, {        chunks: ['manifest', 'vendor', filename],        minify: {          removeComments: true,          collapseWhitespace: true,          removeAttributeQuotes: true
        },        chunksSortMode: 'dependency'
      })
    }
    arr.push(new HtmlWebpackPlugin(conf))
  })  return arr
}

2、修改build/webpack.base.conf.js的入口配置
原单入口配置

module.exports = {
  entry: {
    app: './src/main.js'
  },
...

修改为多入口配置

module.exports = {
  entry: utils.entries(),
...

3、修改build/webpack.dev.conf.js和build/webpack.prod.conf.js的多页面配置：把原有的页面模板配置注释或删除，并把多页面配置添加到plugins
（开发环境下）webpack.dev.conf.js：

 plugins: [
    ......    //  new HtmlWebpackPlugin({
    //    filename: 'index.html',
    //    template: 'index.html',
    //    inject: true
    //  }),
    ......
  ].concat(utils.htmlPlugin())

（生产环境下）webpack.prod.conf.js：

  plugins: [
    ......    // new HtmlWebpackPlugin({
    //   filename: config.build.index,
    //   template: 'index.html',
    //   inject: true,
    //   minify: {
    //     removeComments: true,
    //     collapseWhitespace: true,
    //     removeAttributeQuotes: true
    //   },
    //   chunksSortMode: 'dependency'
    // }),
    ......
  ].concat(utils.htmlPlugin())

补充说明：

在上面多页面输出配置中有这样一行代码：
chunks: ['manifest', 'vendor', filename],
这是html-webpack-plugin插件对页面入口文件(即js文件)的限定，如果不设置则会把整个项目下的所有入口文件全部引入。
为什么要引入 'manifest' 和 'vendor'?
因为在build/webpack.prod.conf.js中有如下代码：

    // split vendor js into its own file
    new webpack.optimize.CommonsChunkPlugin({      name: 'vendor',      minChunks: function (module, count) {        // any required modules inside node_modules are extracted to vendor
        return (          module.resource &&          /\.js$/.test(module.resource) &&          module.resource.indexOf(
            path.join(__dirname, '../node_modules')
          ) === 0
        )
      }
    }),    // extract webpack runtime and module manifest to its own file in order to
    // prevent vendor hash from being updated whenever app bundle is updated
    new webpack.optimize.CommonsChunkPlugin({      name: 'manifest',      chunks: ['vendor']
    }),

vendor模块是指提取涉及node_modules中的公共模块
manifest模块是对vendor模块做的缓存
关于CommonsChunkPlugin插件的详细说明请阅读官方文档

关于html-webpack-plugin插件的配置还有一行代码：
chunksSortMode: 'dependency'
插件会按照模块的依赖关系依次加载，即：manifest，vendor，本页面入口，其他页面入口...

至此，多页面应用已经搭建完毕，只需要在pages文件夹创建相应的页面文件即可。

参考资料:
https://github.com/tonyfree/blog/issues/1

作者：IrisLong
链接：https://www.jianshu.com/p/00eb3fda290f