共计 7258 个字符，预计需要花费 19 分钟才能阅读完成。
前言
经常会有群友问起 webpack、react、redux、甚至 create-react-app 配置等等方面的问题，有些是我也不懂的，慢慢从大家的相互交流中，也学到了不少。
今天就尝试着一起来聊聊 Webpack 吧，旨在帮大家加深理解、新手更容易上路，都能从 0 到 1 搭建配置自定属于自己的脚手架，或对已封装好的脚手架有进一步的巩固，接下来苏南会详细讲解 webpack 中的每一个配置字段的作用(部分为 webpack4 新增)。
近两年，前端一直在以一个高速持续的过程发展，常常会有网友在调侃老了、学不动了，
虽是在调侃却又间接阐述着无奈，迫于生活的压力，不得不提速前行，
因为没有谁为你而停留，公司不会、社会不会、同伴不会……，停下可能将意味着淘汰 —— 理想很丰满，现实很骨感，所以让我们一起进步，共同加薪，奋斗吧骚年，加油。。
～～吐槽过了，接着聊正事～～。
原谅我控制不住自己，想问下各位，昨天刚刚过去的双十一你脱单了吗？
人生若只如初见，何事秋风悲画扇；
等闲变却故人心，却道故人心易变；
骊山语罢清宵半，夜雨霖铃终不怨。
各位大佬早安，这里是 @IT·平头哥联盟，我是首席填坑官∙苏南，用心分享 做有温度的攻城狮。公众号：honeyBadger8，群：912594095
entry
这个不用解释了，看名字就是知道，它就是通往天堂 / 地狱的入口，一切的苦难从这里开始，也从这里结束。
简单介绍几种写法：
// 方式一：单文件写法
entry: {
index: ‘./src/pages/route.js’,
//about: ‘./src/pages/about.js’,
//other:()=>{…} // 首席填坑官∙苏南的专栏, 公众号：`honeyBadger8`
}
// 方式二：多文件写法
entry: {
/*index:[// 首席填坑官∙苏南的专栏
‘webpack-hot-middleware/client’,
‘./src/root.js’
],*/
index: [‘./src/root.js’],
vendors : [‘react’,’react-dom’,’redux’,’react-router’,’classnames’],
}
output – 输出
它位于对象最顶级键(非常重要)，如果说 entry 是一扇门，output 就是审判官，决定着你是上天堂还是入地狱；
指示 webpack 如何去输出、以及在哪里输出、输出的格式等；
path: 输出文件的目录，
filename: 输出的文件名，它一般跟你 entry 配置相对应，如：js/[name].js name 在这里表示的是[index、vendors]，
chunkFilename：块，配置了它，非入口 entry 的模块，会帮自动拆分文件，也就是大家常说的按需加载，与路由中的 require.ensure 相互应
publicPath：文件输出的公共路径，
pathinfo：即保留相互依赖的包中的注释信息，这个基本不用主动设置它，它默认 development 模式时的默认值是 true，而在 production 模式时的默认值是 false，
主要的就是这些，还有一些其他的 library、libraryTarget、auxiliaryComment 等, 感兴趣的可自行了解，
output: {
path: path.resolve(__dirname, ‘../assets’),
filename: ‘js/[name].js’,
chunkFilename: ‘js/[name].[chunkhash:8].js’,
publicPath: ‘/_static_/’, // 最终访问的路径就是：localhost:3000/_static_/js/*.js
//pathinfo:true,
}
hash
常用的有三种：
模板
描述
hash
模块标识符的 hash, 一般应用于 filename：'[name].[hash].js’
chunkhash
按需分块内容的 hash，它是根据 chunk 自身的内容计算而来
contenthash
这个没有用过，看了下文档它是在提取 css 文件时根据内容计算而来的 hash，结合 ExtractTextWebpackPlugin 插件使用
hash 长度
默认 20，可自定:[hash:8]、[chunkhash:16]
mode
这个属于 webpack4 才新增的，4 之前大家一般用 DefinePlugin 插件设置
mode：development`，production，none`，
development : 开发模式，打包的代码不会被压缩，开启代码调试，
production : 生产模式，则正好反之。
// 方法一
webpack –mode development/production
// 方法二
……
mode:’development/production’
……
devtool
控制是否生成，以及如何生成 source map 文件，开发环境下更有利于定位问题，默认 false,
当然它的开启，也会影响编译的速度，所以生产环境一定一定记得关闭；
常用的值：cheap-eval-source-map、eval-source-map、cheap-module-eval-source-map、inline-cheap-module-source-map 等等，更详细的可以去官方查看；
本人一般使用：eval-source-map 较多，每个都有它不一样的特性，有兴趣的同学可以一一尝试，
optimization
optimization 是 webpack4 新增的，主要是用来让开发者根据需要自定义一些优化构建打包的策略配置，
minimize：true/false, 告诉 webpack 是否开启代码最小化压缩，
minimizer：自定 js 优化配置，会覆盖默认的配置，结合 UglifyJsPlugin 插件使用，
removeEmptyChunks: bool 值，它检测并删除空的块。将设置为 false 将禁用此优化，
removeEmptyChunks: bool 值，它检测并删除空的块。将设置为 false 将禁用此优化，
nodeEnv：它并不是 node 里的环境变量，设置后可以在代码里使用 process.env.NODE_ENV === ‘development’ 来判断一些逻辑，生产环境 UglifyJsPlugin 会自动删除无用代码，
splitChunks：取代了 CommonsChunkPlugin，自动分包拆分、代码拆分，详细默认配置：
默认配置，只会作用于异步加载的代码块 —— chunks: ‘async’，它有三个值：all,async,initial
// 环境变更也可以直接 在启动中设置
//webpack –env.NODE_ENV=local –env.production –progress
//splitChunks 默认配置 , 首席填坑官∙苏南的专栏
splitChunks: {
chunks: ‘async’,
minSize: 30000,
maxSize: 0,
minChunks: 1,
maxAsyncRequests: 5,
maxInitialRequests: 3,
automaticNameDelimiter: ‘~’,
name: true,
cacheGroups: {
vendors: {
test: /[\\/]node_modules[\\/]/,
priority: -10
},
default: {
minChunks: 2,
priority: -20,
reuseExistingChunk: true
}
}
}
runtimeChunk: 提取 webpack 运行时代码, 它可以设置为：boolean、Object
该配置开启时，会覆盖 入口指定的名称！！！
optimization: {
runtimeChunk:true,// 方式一
runtimeChunk: {
name: entrypoint => `runtimechunk~${entrypoint.name}` // 方式二
}
}
resolve – 配置模块如何解析
extensions：自动解析确定的扩展, 省去你引入组件时写后缀的麻烦，
alias：非常重要的一个配置，它可以配置一些短路径，
modules：webpack 解析模块时应该搜索的目录，
其他 plugins、unsafeCache、enforceExtension，基本没有怎么用到，
//extensions 后缀可以省略，
import Toast from ‘src/components/toast’;
// alias , 短路径
import Modal from ‘../../../components/modal’
// 简写 , 首席填坑官∙苏南的专栏
import Modal from ‘src/components/modal’
resolve: {
extensions: [‘.js’, ‘.jsx’,’.ts’,’.tsx’, ‘.scss’,’.json’,’.css’],
alias: {
src :path.resolve(__dirname, ‘../src’),
components :path.resolve(__dirname, ‘../src/components’),
utils :path.resolve(__dirname, ‘../src/utils’),
},
modules: [‘node_modules’],
},
module.rules – 编译规则，
rules：也就是之前的 loaders，
test：正则表达式，匹配编译的文件，
exclude：排除特定条件，如通常会写 node_modules，即把某些目录 / 文件过滤掉，
include：它正好与 exclude 相反，
use -loader：必须要有它，它相当于是一个 test 匹配到的文件对应的解析器，babel-loader、style-loader、sass-loader、url-loader 等等，
use – options：它与 loader 配合使用，可以是一个字符串或对象，它的配置可以直接简写在 loader 内一起，它下面还有 presets、plugins 等属性；
具体来看一下示例：
module: {
rules: [
{
test: /\.(js|jsx)$/,
exclude: /node_modules/,
use: [
{
loader: ‘babel-loader’,
options: {
presets: [
[‘env’,
{
targets: {
browsers: CSS_BROWSERS,
},
}],’react’, ‘es2015’, ‘stage-0’
],
plugins: [
‘transform-runtime’,
‘add-module-exports’,
],
},
},
],
},
{
test: /\.(scss|css)$/,
use: [
‘style-loader’,
{loader: ‘css-loader’,options:{plugins: [require(‘autoprefixer’)({browsers: CSS_BROWSERS,}),],sourceMap: true}},
{loader: ‘postcss-loader’,options:{plugins: [require(‘autoprefixer’)({browsers: CSS_BROWSERS,}),],sourceMap: true}},
{loader: ‘sass-loader’,options:{sourceMap: true}}
]
},
{
test: /\.(png|jpg|jpeg|gif)$/,
exclude: /node_modules/,
use: [
{
loader: ‘url-loader?limit=12&name=images/[name].[hash:8].[ext]’,
},
],
},
{
test: /\.(woff|woff2|ttf|eot|svg)$/,
exclude: /node_modules/,// 首席填坑官∙苏南的专栏, 公众号：`honeyBadger8`
use: [
{
loader: ‘file-loader?name=fonts/[name].[hash:8].[ext]’,
},
],
},
],
},
项目中常用 loader
babel-loader、awesome-typescript-loader js*/ts 编译，
css-loader、postcss-loader、sass-loader、less-loader、style-loader 等 css 样式处理
file-loader、url-loader、html-loader 等图片 /svg/html 等的处理，
plugins – 插件
UglifyJsPlugin
HotModuleReplacementPlugin
NoEmitOnErrorsPlugin
HtmlWebPackPlugin
ExtractTextPlugin
PreloadWebpackPlugin
等等，很多很多，插件的详解会留在下一章节详细介绍，欢迎持续关注。
plugins/loader 区别
新入门的一些同学可能会有些疑惑，不是有 loader 了吗？为什么还 plugins 呢，还要它做什么？
loader 的作用在于解析文件，比如把 ES6 转换成 es5, 甚至 ES3, 毕竟还有万恶的 IE 嘛；把 Sass、Less 解析成 CSS，给 CSS 自动加上兼容的前缀；对图片进行一个解析等等；
plugins 呢？它在干啥？它在吹水、喝茶、嗑瓜子聊天，当然这是 loader 在没有把项目做完之前，loader 下班时间就是 plugins 苦难的开始，它要对 loader 干的事情进行优化分类、提取精华(公共代码提取)、做压缩处理(js/css/html 压缩)、输出指定的目录等……，反正也是很苦逼！
webpack-dev-server
这个有些老生常谈了，新手上路一般都有用它，
公司因为现在是结合了 微服务，整套流程是结合：Dockerfile、nodejs、express 等一起在线构建编译的，所以大部分项目都不会走 webpack-dev-server；
我们开发环境就是使用 express + webpack-dev-middleware + webpack-hot-middleware+ ‘…’;
contentBase：告诉服务 (dev server) 在哪里查找文件，默认不指定会在是当期项目根目录，
historyApiFallback: 可以是 boolean、object，默认响应的入口文件，包括 404 都会指向这里，object 见下面示例：
compress：启用 gzip 压缩，
publicPath：它其实就是 output.publicPath，当你改变了它，即会覆盖了 output 的配置，
stats：可以自定控制要显示的编译细节信息，
proxy：它其实就是 http-proxy-middleware，可以进行处理一些代理的请求。
// 方式一：不配置方式二的内容
webpack-dev-server –config webpack/webpack.config.dev.js
// 指定 端口：–port=8080
// 开启热更新：–hot
//gzip：–compress
// 方式二
devServer :
contentBase:’./assets’,
host: ‘0.0.0.0’,
port: 9089,
publicPath: ‘/assets/’,
historyApiFallback: {
index: ‘/views/index.html’
},
/*
匹配路径，进入不同的入口文件，首席填坑官∙苏南的专栏, 公众号：`honeyBadger8`
rewrites: [
{from: /^\/$/, to: ‘/views/landing.html’},
{from: /^\/subpage/, to: ‘/views/subpage.html’},
{from: /./, to: ‘/views/404.html’}
]
}
*/
compress: true,
noInfo: true,
inline: true,
hot: true,
stats: {
colors: true,
chunks: false
},
proxy:{
‘/mockApi’: ‘https://easy-mock.com/project/5a0aad39eace86040263d’ ,// 请求可直接写成 /mockApi/api/login…
}
}
webpack4 删除的点：
module.loaders
NoErrorsPlugin
CommonsChunkPlugin
DefinePlugin
OccurenceOrderPlugin
欢迎补充……，平时用到的大概就是这些
尾声：
以上就是工作中 react 自定脚手架的配置总结，希望能对您有所帮助，webpack4 的改动蛮大的，功能比之前强大了少，也简便了开发者很多的麻烦，效率大大提高，但同时也意味着我们对于底层的东西，了解的更少了，下一章节将为大家分享一些常用的插件 / 以及用法的分析，欢迎持续关注，记得点个赞哦，当然您能动动手指关注下方公众号就更棒了，谢谢支持！
更多文章：
easy-mock 最好的备胎没有之一 immutability 因 React 官方出镜之使用总结分享！小程序项目之做完项目老板给我加了 6k 薪资～小程序项目之填坑小记面试踩过的坑，都在这里了～你应该做的前端性能优化之总结大全！如何给 localStorage 设置一个过期时间？动画一点点 – 如何用 CSS3 画出懂你的 3D 魔方？动画一点点 – 手把手教你如何绘制一辆会跑车 SVG Sprites Icon 的使用技巧
作者：苏南 – 首席填坑官链接：https://blog.csdn.net/weixin_… 交流：912594095、公众号：honeyBadger8 本文原创，著作权归作者所有。商业转载请联系 @IT·平头哥联盟获得授权，非商业转载请注明原链接及出处。
