Webpack重要知识点

最近在系统整理知识点,现将Webpack的一些重要知识点罗列出来,方便快速查阅。

Tree Shaking

为了使用tree shaking,须要知足如下条件:css

  • 使用ES2015语法(即importexport)
  • 在项目package.json文件中,添加sideEffects入口
  • 引入一个可以删除未引用代码(dead code)的压缩工具(minifier)(例如:UglifyJSPlugin)

将文件标记为无反作用(side-effect-free)

这种方式是经过package.jsonsideEffects属性来实现的。node

{
  "sodeEffects": false
}

「反作用」的定义是,在导入时会执行特殊行为的代码,而不是仅仅暴露一个export或多个export。举例说明,例如polyfill,它影响全局做用域,而且一般不提供export

注意,任何导入的文件都会受到tree shaking的影响。这意味着,若是在项目中使用相似css-loader并导入CSS文件,则须要将其添加到 side effect 列表中,以避免在生产模式中无心中将它删除:webpack

{
  "sideEffects": ['*.css']
}

压缩输出

从 webpack 4 开始,也能够经过 "mode" 配置选项轻松切换到压缩输出,只需设置为 "production"。

也能够在命令行接口中使用--optimize-minimize标记,来使用UglifyJSPlugingit

Code Splitting

code splitting的必要性github

  • 不进行code splitting,打包后单文件提交较大,加载时长较长,影响用户体验
  • 不进行code splitting,常常修改业务代码,从新打包后,浏览器不能进行缓存,致使性能较差,影响用户体验

code splitting的配置

同步代码方式web

import _ from 'lodash';

webpack.common.js配置以下:npm

....
optimization: {
  splitChunks: {
    chunks: 'all'
  }
}
....

配置后,会将公用类库进行打包,生成一个vendors~main.js文件。json

异步代码方式segmentfault

function getComponent() {
  return import('lodash').then(({ default: _ }) => {
    var element = document.createElement('div');
    element.innerHTML = _.join(['Clear', 'love'], '');
    return element;
  })
}

getComponent().then(element => {
  document.body.appendChild(element);
})

SplitChunksPlugin 配置参数详解

魔法注释(magic comment)修改打包动态组件名称

1. 使用@babel/plugin-syntax-dynamic-import支持动态引入插件浏览器

.babelrc中引用该插件

....
plugins: ['@babel/plugin-syntax-dynamic-import']
....

2. 添加魔法注释

function getComponent() {
  return import(/* webpackChunkName:"lodash" */'lodash').then(({ default: _ }) => {
    var element = document.createElement('div');
    element.innerHTML = _.join(['Clear', 'love'], '');
    return element;
  })
}

getComponent().then(element => {
  document.body.appendChild(element);
})

关键是注释:webpackChunkName: "lodash".。打包后的文件名为vendors~lodash.js
若想打包事后的文件名不带vendors~前缀,能够修改webpack.common.jsoptimization配置项:

....
optimization: {
  splitChunks: {
    chunks: "all",
    cacheGroups: {
      venders: false,
      default: false
    }
  }
}
....

splitChunks配置详解

splitChunks: {
      chunks: 'async', // all async initial 是否对异步代码进行的代码分割
      minSize: 30000,  // 引入模块大于30kb才进行代码分割
      maxSize: 0, // 引入模块大于Xkb时,尝试对引入模块二次拆分引入
      minChunks: 1, // 引入模块至被使用X次后才进行代码分割
      maxAsyncRequests: 5, // 
      maxInitialRequests: 3,
      automaticNameDelimiter: '~',
      name: true,
      cacheGroups: {
        vendors: {
          test: /[\\/]node_modules[\\/]/,
          priority: -10, // 优先级 
          filename: 'vendors.js' // 打包文件名称
        },
        default: {
          minChunks: 2,
          priority: -20,
          reuseExistingChunk: true // 是否复用已打包代码
        }
      }
    }
  }

Lazy Loading && Chunk

import 动态引入组件

function getComponent() {
  return import(/* webpackChunkName:"lodash" */'lodash').then(({ default: _ }) => {
    var element = document.createElement('div');
    element.innerHTML = _.join(['Clear', 'love'], '');
    return element;
  })
}

document.addEventListener('click', () => {
  /* 当点击时才加载lodash */
  getComponent().then(element => {
    document.body.addChild(element);
  })
})

页面初始化时,不会加载lodash。当点击页面时才加载。
import引入动态组件实现的Lazy Loading,其实跟Webpack没什么关系。importES6的语法标准。而Webpack借助babel-profill能识别该语法。

Chunk

每一个打包的js文件都是一个chunk

打包分析 && Preloading && Prefetching

借助webpack analyse进行打包分析

package.jsonscripts项中进行配置:

....
scripts: {
  "dev-build": "webpack --profile --json > stats.json --config ./build/webpack.dev.js" 
}
....

打包后会生成stats.json,而后上传该文件至webpack/analyse进行分析

其余分析分工具

利用魔法注释实现Preload/Prefetch

document.addEventListener('click', () => {
  import(/* webpackPrefetch: true */ 'lodash').then(() => {
    ....
  })
})

PreloadPrefetch的区别:

  • preloaded chunk与主模块并行加载,而prefetched chunk是主模块加载完后再加载
  • preloaded chunk具备中等优先级,能够当即下载。而prefetched chunk是在浏览器空闲时下载。
  • 浏览器支持程度不一样

具体能够参考prefetching/preloading-modules

CSS文件的代码分割

若没有进行css的代码分割,经过import方式引入的样式文件,将会被看成普通的模块打包到.js文件中。
若须要对css进行代码分割,须要借助optimize-css-assets-webpack-plugin插件实现,具体以下:

// webpack.prod.js
const MiniCssExtractPlugin = require("mini-css-extract-plugin")

....
module: [{
  test: /\.scss$/,
  use: [
    MiniCssExtractPlugin.loader,
    {
      loder: 'css-loader',
      options: { importLoaders: 2 }
    },
    'saas-loader',
    'postcss-loaerd'
  ]
},
{
  test: /\.css$/,
  use: [
    MiniCssExtractPlugin.loader,
    'css-loader',
    'postcss-loader'
  ]
}],
plugins: [
  new MiniCssExtractPlugin({
    filename: '[name].css',  // 入口文件中直接引入css匹配该规则
    chunkFilename: '[name].chunk.css'  // 非入口文件中引入或嵌套引入匹配匹配该规则
  })
]
....

若须要对引入css进行合并、压缩,能够借助optimize-css-assets-webpack-plugin。,具体配置以下:

// webpack.prod.js
const OptimizeCSSAssetsPlugin = require("optimize-css-assets-webpack-plugin")
....
optimization: {
  minimizer: [new OptimizeCSSAssetsPlugin({})]
}
....

若以前有配置过tree shaking,则须要对如下文件进行修改:

  1. webpack.common.js
optimization: {
  usedExports: true
}
  1. package.json
"sideEffects": [
    "*.css"
  ]

Webpack与浏览器缓存

webpack实现浏览器缓存,主要是借助配置output中的contenthash来实现的。

// webpack.prod.js
....
output: {
  filename: '[name].[contenthash].js',
  chunkFilename: '[name].[contenthash].js'
}
....

旧版webpack进行打包时,虽然文件没有进行任何修改,但打包后生成的contenthash仍是会改变,这时须要再进行一些配置。

// webpack.common.js
....
optimization: {
  runtimeChunk: {
    name: 'runtime'
  }
}
....

构建性能

常规

保持版本最新

使用最新稳定版本的webpacknodenpm等,较新的版本更够创建更高效的模块树以及提升解析速度。

loaders

loaders应用于最少数的必要模块中,而不是:

// webpack.common.js
module: {
  rules: [
    {
      test: /\.jsx?$/,
      use: ['babel-loader']
    }
  ]
}

使用include字段仅将loader模块应用在实际须要用其转换的位置:

// webpack.common.js
module: {
  rules: [
    {
      test: /\.jsx?$/,
      include: path.resolve(__dirname, '../src'),
      use: ['babel-loader']
    }
  ]
}

Smaller = false

减小编译的总体大小,以提升构建性能。尽可能保持chunks小巧。

  • 使用更小/更少的库
  • 在多页面应用程序中使用CommonsChunksPlugin
  • 在多页面应用程序中以async模式使用CommonsChunksPlugin
  • 移除不须要的代码
  • 只编译你在开发的代码

Worker Pool

thread-loader能够将很是耗性能的loaders转存到worker pool中。<br/>
不要使用太多的 workers ,由于 Node.js 的 runtime 和 loader 有必定的启动开销。最小化 workers 和主进程间的模块传输。进程间通信(IPC)是很是消耗资源的。

持久化缓存

对于一些性能开销较大的loader以前能够添加cache-loader,启用持久化缓存。

使用package.json中的postinstall清楚缓存目录。

Dlls

使用DllPlugin将更新不频繁的代码进行单独编译。这将改善引用程序的编译速度。即便它增长了构建过程的复杂度。

解析(resolve)

如下几步能够提升解析速度:

  • 尽可能减小resolve.modulesresolve.extensionsresolve.mainFilesresolve.desciriptionsFiles中类目的数量,由于它们会增长文件系统的调用次数。
  • 若是你不使用symlinks,能够设置resolve.symlinks: false
  • 若是你使用自定义解析plugins,而且没有指定context信息,能够设置resolve.cacheWithContext: false

Development

在内存中编译

如下几个实用的工具经过在内存中进行代码的编译和资源的提供,但并不写入磁盘来提升性能:

  • webpack-dev-server
  • webpack-hot-middleware
  • webpack-dev-middleware

Devtool

须要注意在不一样的devtool的设置,会致使不一样的性能差别。

  • eval具备最好的性能,但不能帮你转义代码
  • 若是你能接受稍微差一些的mapping质量,你可使用cheap-source-map选择来提升性能
  • 使用eval-source-map配置进行增量编译 

在大多数状况下,cheap-module-eval-source-map是最好的选择

避免在生产环境在才会用到的工具

某些实用工具,pluginsloaders都只能在构建生产环境时才使用。例如,在开发时使用UglifyJsPlugin来压缩和修改代码是没有意义的。如下这些工具在开发中一般被排除在外:

  • UglifyJsPlugin
  • ExtractTextPlugin
  • [hash]/[chunkhash]
  • AggressiveSplittingPlugin
  • AggressiveMergingPlugin
  • ModuleConcatenationPlugin

最小化入口chunk

webpack只会在文件系统中生成已更新的chunk。应当在生成入口chunk时,尽可能减小入口chunk的体积,以提升性能。

Production

不要为了很是小的性能增益,牺牲了你应用程序的质量!!请注意,在大多数状况下优化代码质量,比构建性能更重要。

多个编译时

当进行多个编译时,如下工具能够帮助到你:

  • parallel-webpack: 它容许编译工做在woker池中进行。
  • cache-loader: 缓存能够在多个编译之间共享。

工具相关问题

Babel

项目中的preset/plugins数量最小化

TypeScript

  • 在单独的进程中使用fork-ts-checker-webpack-plugin进行类型检查
  • 配置loaders时跳过类型检查
  • 使用ts-loader时,设置happyPackMode: true以及 transpileOnly: true

Saas

node-sass中有个来自Node.js线程池的阻塞线程的bug。当使用thread-loader时,须要设置workParallelJobs: 2

其余

修改CleanWebpackPlugin根路径

webpack.config.js配置中,须要对plugins中的CleanWebpackPlugin的根路径进行修改,能够经过配置root参数。

....
plugins: [
  new CleanWebpackPlugin(['dist'], {
    root: path.resolve(__dirname, '../')
  })
]
....

原文http://www.noobyard.com/article/p-hptxujqb-t.html