Webpack3.0配置

1. 代码分割(Code Splitting)

1.1 CommonsChunkPlugin

  1. CommonsChunkPlugin可以进行同步代码分割。
  2. 代码结构

src/page/pageA.js

import './subPageA'
import './subPageB'
import lodash from 'lodash'
console.log('this is pageA')

src/page/pageB.js

import './subPageA'
import './subPageB'
import lodash from 'lodash'
console.log('this is pageB')

src/page/subPageA.js

import './module'
console.log('this is subPageA')
export default 'subPageA'

src/page/subPageB.js

import './module'
console.log('this is subPageB')
export default 'subPageB'

src/page/module.js

console.log('this is module')
export default "Module"
  1. 打包配置
//...
  entry: {
    pageA: './src/page/pageA',
    pageB: './src/page/pageB',
    vendor: ['lodash']
  },
//...
  plugins: [
    //将pageA和pageB中公共代码提出
    new webpack.optimize.CommonsChunkPlugin({ 
      name: 'common',
      minChunks: 2,
      chunks: ['pageA', 'pageB']
    }),
    //将lodash和webpack代码分别提出
    new webpack.optimize.CommonsChunkPlugin({ 
      names: ['vendor', 'manifest'],
      minChunks: Infinity
    })
  ]

CommonsChunkPlugin可以将pageApageB这两个入口文件中共同引入超过minChunks次的模块拆分出来,将webpack打包代码拆分出来,将第三方依赖模块(lodash)拆分出来,但不能对单个入口文件内部多次引入的模块进行拆分。因为需要设置多个入口文件,因此CommonsChunkPlugin没有webpack4.X中的SplitChunksPlugin好用。

1.2 异步代码分割和懒加载

1.2.1 require.ensure

  1. 语法
    require.ensure([dependencies], callback, errorCallback, chunkName)
    引入模块并可以执行。

require.ensure依赖Promise。如果浏览器不支持Promise,需要添加polyfill垫片。

  1. 编辑打包配置文件
    webpack.config.js
  entry: {
    pageA: './src/page/pageA'
  },
  output: {
    filename: '[name].[hash:5].bundle.js',
    path: path.resolve(__dirname, 'dist'),
    chunkFilename:'[name].[hash:5].js'
  },
  plugins: []

入口文件只有pageA
需要配置chunkFilename之后,require.ensure中的第四个参数chunkName才会生效。

  1. 编辑代码
    src/page/pageA.js
var page = 'pageA'
if(page === 'pageA') {
  require.ensure([], function () {
    const subPageA = require('./subPageA')
  }, 'subPageA');
} else {
  require.ensure([], function () {
    //require('./subPageB') 如果外部也引入了subPageB,则subPageB不会被单独打包
    const subPageB = require('./subPageB')
  }, 'subPageB');
}

require.ensure([], function () {
  const _ = require('lodash');
  console.log(_.join([1,2,3], '-'))
}, 'vendor')

此时,subPageAsubPageB以及lodash会被分割打包成单独的包。
虽然subPageAsubPageB都被分割单独打包,但是subPageB不会被加载到页面中。

如果外部也引入了require.ensure方法中通过require引入的模块,则该模块不会分割单独打包。
此时,由于subPageAsubPageB都引入了module,因此module被同时打包进了subPageAsubPageB。可通过require.include解决此问题。

1.2.2 require.include

  1. 语法
    require.include([dependencies])
    如果两个子模块都引入一个第三方模块,可在父模块中使用require.include()。这样这个第三方模块就不会同时打包进两个子模块中了。
  2. 编辑代码
    src/page/pageA.js
require.include('./module')

var page = 'pageA'
if(page === 'pageA') {
  require.ensure([], function () {
    const subPageA = require('./subPageA')
  }, 'subPageA');
} else {
  //require('./subPageB') 如果外部也引入了subPageB,则subPageB不会被单独打包
  require.ensure([], function () {
    const subPageB = require('./subPageB')
  }, 'subPageB');
}

require.ensure([], function () {
  //会将lodash拆分打包成单独的包(除非外部已经引入了lodash)
  const _ = require('lodash');
  console.log(_.join([1,2,3], '-'))
}, 'vendor')
export default 'pageA'
  1. 此时代码打包会将subPageAsubPageB中引入的module打包进pageA中。

1.2.3 import()

  1. 语法
import(
    /* webpackChunkName: async-chunk-name */
   /* webpackMode: lazy */
   module
)

webpack推荐使用import()语法,不推荐使用require.ensure

  1. 安装依赖
    npm i @babel/plugin-syntax-dynamic-import -D
  2. 编辑babel配置
"plugins": [
    "@babel/plugin-syntax-dynamic-import"
]
  1. 编辑代码
require.include('./module')

var page = 'pageA'
if(page === 'pageA') {
  import(/* webpackChunkName: 'subPageA' */ './subPageA').then(subPageA => {
    console.log(subPageA)
  });
} else {
  import(/* webpackChunkName: 'subPageB' */ './subPageB').then(subPageB => {
    console.log(subPageB)
  })
}

import(/* webpackChunkName: 'vendor' */ 'lodash').then(lodash => {
  console.log(lodash.join([1,2,3], '-'))
})

export default 'pageA'

只有配置chunkFilename之后,webpackChunkName才生效。
如果多个 import()的魔法注释webpackChunkName指定同一个名字,则这多个import()模块会打包成一个bundle
如果外部也引入了import()方法中引入的模块,则该模块不会分割单独打包。

require.ensure一样,由于subPageAsubPageB都引入了module,因此module被同时打包进了subPageAsubPageB。通过require.include解决此问题。

2. 加载样式

2.1 css-loader@1.X 配置项

  1. 安装依赖
    npm install --save-dev style-loader css-loader@1.0.1

css-loader@1.X版本配置与@2.X版本配置不同。

  1. 编辑打包配置文件
    webpack.dev.config.js
 {
   test: /\.css$/,
   use: [
     "style-loader",
     {
       loader: 'css-loader',
       options: {
         minimize: true, //压缩(失效)
         modules: true, //开启modules
         localIdentName: '[path][name]__[local]--[hash:base64:5]'
       }
     }
   ]
 }

2.2 提取CSS文件

  1. extract-text-webpack-plugin文档

webpack4版本中,应使用mini-css-extract-plugin

  1. 安装依赖
    npm i extract-text-webpack-plugin -D
  2. 编辑打包配置文件
    webpack.dev.config.js
const ExtractTextWebpackPlugin = require('extract-text-webpack-plugin');
//...
  module: {
    rules: [
      //...
      {
        test: /\.css$/,
        use: ExtractTextWebpackPlugin.extract({
          fallback: { loader: "style-loader"}, //应用于没有被提取的CSS使用的loader
          use: [ {loader: 'css-loader'}]
        })
      }
    ]
  },
  plugins: [
    new ExtractTextWebpackPlugin({
      filename: '[name].css', //提取的css文件名
      allChunks: false //异步加载的js模块中引入的css文件是否提取
    }),
    //...
 ]
}

使用模块热更新时,css-loader已经帮我们做了module.hot.accept监听CSS文件变化的代码。使用extract-text-webpack-plugin,则CSS模块自动热更新失效,需要手写module.hot.accept监听CSS文件变化的代码。
如果ExtractTextWebpackPlugin中的filename值为css/[name].css,则会将生成的css文件放入css文件夹中。

3. Tree Shaking

  1. 一个简单的打包示例

src/index.js

import { add } from './math'
add(1,5)

src/math.js

export const add = (a, b) => {
  console.log(a + b)
}

export const minus = (a, b) => {
  console.log(a - b)
}
  1. 编辑打包配置文件
    webpack.dev.config.js
const Webpack = require('webpack');
//...
module.exports = {
  //...
  plugins: [
    //...
    new Webpack.optimize.UglifyJsPlugin()
  ]
}
  1. 打包输出
    npm run bundle
    add方法被打包,minusTree Shaking过滤掉了。

Tree Shaking开启的关键在于JavaScript代码压缩。在webpack3.X版本中,通过UglifyJsPlugin插件进行JavaScript代码压缩。在webpack4.X版本中,mode: production生产模式默认进行JavaScript代码压缩。

4. mode

  1. 不支持--mode development/production或配置文件中的{mode: development/production}定义开发模式和生产模式。

webpack3.X版本和webpack4.X版本都可以使用环境变量,且用法相同。
可参考:7. 环境变量

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,402评论 6 499
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,377评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,483评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,165评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,176评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,146评论 1 297
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,032评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,896评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,311评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,536评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,696评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,413评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,008评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,659评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,815评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,698评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,592评论 2 353