前言: 本文基於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
}

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

entry: utils.entries()

5. 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
})

6. 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'
})

7. 構建結果

【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

8.【懶人福利】使用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腳本的內容寫入路由等，以實現定制需求。

原文地址：https://segmentfault.com/a/1190000016758185

vue 配置多頁面應用