vue 配置多页面应用

前言: 本文基于vue 2.5.2, webpack 3.6.0（配置多页面原理类似，实现方法各有千秋，可根据需要进行定制化）

vue 是单页面应用。但是在做大型项目时，单页面往往无法满足我们的需求，因此需要配置多页面应用。

1. 新建 vue 项目

vue init webpack vue_multiple_test
cd vue_multiple_test
npm install

2. 安装 glob

npm i glob --save-dev

glob 模块用于查找符合要求的文件

3. 目标结构目录

.
├── README.md
├── build
│   ├── build.js
│   ├── check-versions.js
│   ├── logo.png
│   ├── utils.js
│   ├── vue-loader.conf.js
│   ├── webpack.base.conf.js
│   ├── webpack.dev.conf.js
│   └── webpack.prod.conf.js
├── config
│   ├── dev.env.js
│   ├── index.js
│   └── prod.env.js
├── generatePage.sh
├── index.html
├── package-lock.json
├── package.json
├── src
│   ├── assets
│   │   └── logo.png
│   └── pages
│       ├── page1
│       │   ├── App.vue
│       │   ├── index.html
│       │   └── index.js
│       └── page2
│           ├── App.vue
│           ├── index.html
│           └── index.js
└── static

其中，pages文件夹用于放置页面。 page1 和 page2用于分别放置不同页面，且默认均包含三个文档: App.vue, index.html, index.js, 这样在多人协作时，可以更为清晰地明确每个文件的含义。除此之外，此文件也可配置路由。

4. utils 增加下述代码:

const glob = require('glob')
const PAGE_PATH = path.resolve(__dirname, '../src/pages')
const HtmlWebpackPlugin = require('html-webpack-plugin')

其中：PAGE_PATH 为所有页面所在的文件夹路径，指向 pages文件夹。

exports.entries = function () {
    /*用于匹配 pages 下一级文件夹中的 index.js 文件 */
    var entryFiles = glob.sync(PAGE_PATH + '/*/index.js')
    var map = {}
    entryFiles.forEach((filePath) => {
        /* 下述两句代码用于取出 pages 下一级文件夹的名称 */
        var entryPath = path.dirname(filePath)
        var filename = entryPath.substring(entryPath.lastIndexOf('\/') + 1)
        /* 生成对应的键值对 */
        map[filename] = filePath
    })
    return map
}

该方法用于生成多页面的入口对象，例如本例，获得的入口对象如下：

{ 
    page1: '/Users/work/learn/vue/vue_multiple_test/src/pages/page1/index.js',
    page2: '/Users/work/learn/vue/vue_multiple_test/src/pages/page2/index.js',
 }

其中：key 为当前页面的文件夹名称， value 为当前页面的入口文件名称

exports.htmlPlugin = function () {
    let entryHtml = glob.sync(PAGE_PATH + '/*/index.html')
    let arr = []
    entryHtml.forEach((filePath) => {
        var entryPath = path.dirname(filePath)
        var filename = entryPath.substring(entryPath.lastIndexOf('\/') + 1)
        let conf = {
            template: filePath,
            filename: filename + `/index.html`,
            chunks: ['manifest', 'vendor', filename],
            inject: true
        }
        if (process.env.NODE_ENV === 'production') {
            let productionConfig = {
                minify: {
                  removeComments: true,         // 移除注释
                  collapseWhitespace: true,     // 删除空白符和换行符
                  removeAttributeQuotes: true   // 移除属性引号 
                },
                chunksSortMode: 'dependency'    // 对引入的chunk模块进行排序
            }
            conf = {...conf, ...productionConfig} //合并基础配置和生产环境专属配置
        }
        arr.push(new HtmlWebpackPlugin(conf))
    })
    return arr
}

5. webpack.base.conf.js修改入口如下：

entry: utils.entries()

6. webpack.dev.conf.js

在 devWebpackConfig 中的 plugins数组后面拼接上上面新写的htmlPlugin:

plugins: [
    new webpack.DefinePlugin({
      'process.env': require('../config/dev.env')
    }),
    new webpack.HotModuleReplacementPlugin(),
    new webpack.NamedModulesPlugin(), // HMR shows correct file names in console on update.
    new webpack.NoEmitOnErrorsPlugin(),
    new CopyWebpackPlugin([
      {
        from: path.resolve(__dirname, '../static'),
        to: config.dev.assetsSubDirectory,
        ignore: ['.*']
      }
    ])
  ].concat(utils.htmlPlugin())

并删除下述代码:

new HtmlWebpackPlugin({
    filename: 'index.html',
    template: 'index.html',
    inject: true
})

7. webpack.prod.conf.js

做 webpack.dev.conf.js 中的类似处理:

plugins: [
    new webpack.DefinePlugin({
      'process.env': env
    }),
    new UglifyJsPlugin({
      uglifyOptions: {
        compress: {
          warnings: false
        }
      },
      sourceMap: config.build.productionSourceMap,
      parallel: true
    }),
    new ExtractTextPlugin({
      filename: utils.assetsPath('css/[name].[contenthash].css'),
      allChunks: true,
    }),
    new OptimizeCSSPlugin({
      cssProcessorOptions: config.build.productionSourceMap
        ? { safe: true, map: { inline: false } }
        : { safe: true }
    }),
    new webpack.HashedModuleIdsPlugin(),
    new webpack.optimize.ModuleConcatenationPlugin(),
    new webpack.optimize.CommonsChunkPlugin({
      name: 'vendor',
      minChunks (module) {
        return (
          module.resource &&
          /\.js$/.test(module.resource) &&
          module.resource.indexOf(
            path.join(__dirname, '../node_modules')
          ) === 0
        )
      }
    }),
    new webpack.optimize.CommonsChunkPlugin({
      name: 'manifest',
      minChunks: Infinity
    }),
    new webpack.optimize.CommonsChunkPlugin({
      name: 'app',
      async: 'vendor-async',
      children: true,
      minChunks: 3
    }),
    new CopyWebpackPlugin([
      {
        from: path.resolve(__dirname, '../static'),
        to: config.build.assetsSubDirectory,
        ignore: ['.*']
      }
    ])
  ].concat(utils.htmlPlugin())

并删除下述代码:

new HtmlWebpackPlugin({
    filename: config.build.index,
    template: 'index.html',
    inject: true,
    minify: {
        removeComments: true,
        collapseWhitespace: true,
        removeAttributeQuotes: true
    },
    chunksSortMode: 'dependency'
})

8. 构建结果

【dev】开发环境下，执行 npm run dev 访问:

 http://localhost:8080/page1/index.html
 http://localhost:8080/page2/index.html

 即为访问不同的页面


【production】生产环境下，执行 npm run build, 生成的文件目录如下所示:

│   ├── dist
│   ├── page1
│   │   └── index.html
│   ├── page2
│   │   └── index.html
│   └── static
│       ├── css
│       │   ├── page1.86a4513a3e04c0dcb73e6d6aea4580e4.css
│       │   ├── page1.86a4513a3e04c0dcb73e6d6aea4580e4.css.map
│       │   ├── page2.86a4513a3e04c0dcb73e6d6aea4580e4.css
│       │   └── page2.86a4513a3e04c0dcb73e6d6aea4580e4.css.map
│       └── js
│           ├── manifest.0c1cd46d93b12dcd0191.js
│           ├── manifest.0c1cd46d93b12dcd0191.js.map
│           ├── page1.e2997955f3b0f2090b7a.js
│           ├── page1.e2997955f3b0f2090b7a.js.map
│           ├── page2.4d41f3b684a56847f057.js
│           ├── page2.4d41f3b684a56847f057.js.map
│           ├── vendor.bb335a033c3b9e5d296a.js
│           └── vendor.bb335a033c3b9e5d296a.js.map

9.【懒人福利】使用shell脚本自动构建基础页面

在项目文件下新建shell脚本generatePage.sh, 并在脚本中写入下述代码：

#!/bin/bash
# 打开 pages 文件夹，并创建文件
cd src/pages
for file in $(ls)
do
  if [ $file == $1 ];then
      echo $1' 文件已存在, 请使用其他名字'
      exit
  fi
done
mkdir $1
cd $1
# 生成 index.html
echo "" > index.html
echo '<!DOCTYPE html>
  <html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1.0">
    <title></title>
  </head>
  <body>
    <div id="app"></div>
    <!-- built files will be auto injected -->
  </body>
</html>' > index.html

# 生成 App.vue
echo "" > App.vue
echo '<template>
  <div id="app">
  </div>
</template>

<script>
export default {
  name: "App"
}
</script>

<style>
#app {}
</style>' > App.vue

# 生成 index.js
echo "" > index.js
echo "import Vue from 'vue'
import App from './App'

Vue.config.productionTip = false

/* eslint-disable no-new */
new Vue({
  el: '#app',
  components: { App },
  template: '<App/>'
})" > index.js

之后在项目路径下输入下述命令:

bash generatePage.sh page4

即可在pages文件夹下生成一个名为page4的新页面。还可以通过自定义shell脚本的内容写入路由等，以实现定制需求。