webpack解惑：多入口文件打包策略

本文是我用webpack进行项目构建的实践心得，场景是这样的，项目是大型类cms型，技术选型是vue，只支持chrome，有诸多子功能模块，所有打包在一块儿的话会有好几MB，因此最佳方式是进行多入口打包。文章包含我探索的过程以及webpack在使用中的一些技巧，但愿能给你们带来参考价值。

首先，项目打包策略遵循如下几点原则：

1. 选择合适的打包粒度，生成的单文件大小不要超过500KB
2. 充分利用浏览器的并发请求，同时保证并发数不超过6
3. 尽量让浏览器命中304，频繁改动的业务代码不要与公共代码打包
4. 避免加载太多用不到的代码，层级较深的页面进行异步加载

基于以上原则，我选择的打包策略以下：

1. 第三方库如vue、jquery、bootstrap打包为一个文件
2. 公共组件如弹窗、菜单等打包为一个文件
3. 工具类、项目通用基类打包为一个文件
4. 各个功能模块打包出本身的入口文件
5. 各功能模块做用一个SPA，子页面进行异步加载

 

各入口文件的打包

因为项目不适宜总体做为一个SPA，因此各子功能都有一个本身的入口文件，个人源码目录结构以下：

apps目录下放置各个子功能，如question和paper，下面是各自的子页面。components目录放置公共组件，这个后面再说。

因为功能模块是随时会增长的，我不能在webpack的entry中写死这些入口文件，因此用了一个叫作glob的模块，它可以用通配符来取到全部的文件，就像咱们用gulp那样。动态获取子功能入口文件的代码以下：

/**
* 动态查找全部入口文件
*/
var files = glob.sync('./public/src/apps/*/index.js');
var newEntries = {};

files.forEach(function(f){
   var name = /.*\/(apps\/.*?\/index)\.js/.exec(f)[1];//获得apps/question/index这样的文件名
   newEntries[name] = f;
});

config.entry = Object.assign({}, config.entry, newEntries);

webpack打包后的目录是很乱的，若是你入口文件的名字取为question,那么会在dist目录下直接生成一个question.xxxxx.js的文件。可是若是把名字取为apps/question/index这样的，则会生成对应的目录结构。我是比较喜欢构建后的目录也有清晰的结构的，多是习惯gulp的后遗症吧。这样也便于咱们在前端路由中进行统一操做。也是一个小技巧吧，我生成的各入口文件的目录以下：

 

第三方库的打包

项目中用到了一些第三方库，如vue、vue-router、jquery、boostrap等。这些库咱们基本上是不会改动源代码的，而且项目初期就基本肯定了，不会再添加。因此把它们打包在一块儿。固然这个也是要考虑大小不超过500KB的，若是是用到了像ueditor这样的大型工具库，仍是要单独打包的。

配置文件的写法是很简单的，在entry中配一个名为vendor的就好，好比：

entry: {
    vendor: ['vue', 'vue-router', './public/vendor/jquery/jquery']
},

不论是用npm安装的仍是本身放在项目目录中的库都是能够的，只要路径写对就行。

为了把第三方库拆分出来（用<script>标签单独加载），咱们还须要用webpack的CommonsChunkPlugin插件来把它提取一下，这样他就不会与业务代码打包到一块儿了。代码：

new webpack.optimize.CommonsChunkPlugin('vendor');

 

公共组件的打包

这部分代码的处理我是纠结了很久的，由于webpack的打包思想是以模块的依赖树为标准来进行分析的，若是a模块使用了loading组件，那么loading组件就会被打包进a模块，除非咱们在代码中用require.ensure或者AMD式的require加回调，显式声明该组件异步加载，这样loading组件会被单独打包成一个chunk文件。

以上二者都不是我想要的，理由参见文章开头的打包原则，把全部公共组件打包在一块儿是一个天然合理的选择，但这又与webpack的精神相悖。

一开始我想到了一招曲线救国，就是在components目录下建一个main.js文件，该文件引用全部的组件，这样打包main.js的时候全部组件都会被打包进来，main.js的代码以下：

import loading from './loading.vue';
import topnav from './topnav.vue';
import centernav from './centernav.vue';

export {loading, topnav, centernav}

有点像sass的main文件的感受。使用的时候这样写：

let components = require('./components/main');

export default {
    components: {
        loading: (resolve) =>{
            require(['./components/main'],function(components){
                resolve(components.loading);
            })
        }
    }
}

缺点是也得写成异步加载的，不然main.js仍是会被打包进业务代码。

不事后来我又一想，既然vendor能够，为何组件不能够用一样的方式处理呢？因而乎找到了最佳方法。 一样先用glob动态找到全部的components，而后写进entry，最后再用CommonsChunkPlugin插件剥离出来。代码以下：

/*动态查找全部components*/
var comps = glob.sync('./public/src/components/*.vue');
var compsEntry = {components: comps};
config.entry = Object.assign({}, config.entry, compsEntry);

要注意CommonsChunkPlugin是不能够new多个的，要剥离多个须要传数组进去，写法以下：

new webpack.optimize.CommonsChunkPlugin({
    names: ['vendor', 'components']
})

如此一来，components就和vendor同样能够用<script>标签引入页面了，使用的时候就能够随便引入了，不会再被重复打包进业务代码。如：

import loading from './components/loading';
import topnav from './components/topnav';

 

把这些文件塞进入口页面

以前说过咱们的子功能模块有各自的页面，因此咱们须要把这些文件都给引入进这些页面，webpack的HtmlWebpackPlugin能够作这件事情，咱们在动态查找入口文件的时候顺便把它作了就好了，代码以下：

/**
 * 动态查找全部入口文件
 */
var files = glob.sync('./public/src/apps/*/index.js');
var newEntries = {};

files.forEach(function(f){
    var name = /.*\/(apps\/.*?\/index)\.js/.exec(f)[1]; //获得apps/question/index 这样的文件名
    newEntries[name] = f;

    var plug =  new HtmlWebpackPlugin({
        filename: path.resolve(__dirname, '../public/dist/'+ name +'.html'),
        chunks: ['vendor', name, 'components'],
        template: path.resolve(__dirname, '../public/src/index.html'),
        inject: true
    });
    config.plugins.push(plug);
});

 

子页面的异步载入

每一个功能模块是做为一个SPA应用来处理的，这就意味着咱们会根据前端路由来动态加载相应子页面，使用官方的vue-router是很容易实现的，好比咱们在question/index.js中能够以下写：

router.map({
    '/list': {
        component: (resolve) => {
            require(['./list.vue'], resolve);
        }
    },
    '/edit': {
        component: (resolve) => {
            require(['./edit.vue'], resolve);
        }
    }
});

在webpack的配置文件中就无需再写什么了，它会自动打包出对应的chunk文件，此时个人dist目录就长这样了：

有一点让我疑惑的是，异步加载的chunk文件貌似没法输出文件名称，尽管我在output参数中这么配置：chunkFilename: '[name].[chunkhash].js'，[name]那里输出的仍是id，可能和webpack处理异步chunk的机制有关吧，猜想的。不过也无所谓的，反正可以正确加载，就是名字难看点。

--------更新于2016.10.11-------

为异步chunk命名的方法我找到了，须要两步。首先output中仍是应该这么配置：chunkFilename: '[name].[chunkhash].js'。而后，利用require.ensure的第三个参数，能够为chunk指定名字。上面的代码修改成以下：

router.map({
    '/list': {
        component: (resolve) => {
            // require(['./list.vue'], resolve);
            require.ensure([], function(){
                resolve(require('./list.vue'));
            }, 'list');
        }
    },
    '/edit': {
        component: (resolve) => {
            //require(['./edit.vue'], resolve);
            require.ensure([], function(){
                resolve(require('./edit.vue'));
            }, 'edit');
        }
    }
});

这样list和edit这两个组件生成的chunk就有名字了，以下：

 

我我的仍是偏好生成的chunk能带上名字，这样可读性好一些，便于调试和尽快发现错误。 

 

---

以上就是一个大概的架子了，因为我也是刚刚开始探索webpack（以前gulp党），一边 实践一边分享吧，还有不少细节的东西无法细讲，我在本系列文章中慢慢道来吧。