webpack4配置详解之逐行分析

时间 2019-12-07

标签 webpack4 webpack 配置详解逐行分析繁體版

原文原文链接

前言

　　常常会有群友问起webpack、react、redux、甚至create-react-app配置等等方面的问题，有些是我也不懂的，慢慢从你们的相互交流中，也学到了很多。javascript

　　今天就尝试着一块儿来聊聊Webpack吧，旨在帮你们加深理解、新手更容易上路，都能从0到1搭建配置自定属于本身的脚手架，或对已封装好的脚手架有进一步的巩固，接下来苏南会详细讲解webpack中的每个配置字段的做用(部分为webpack4新增)。css

近两年，前端一直在以一个高速持续的过程发展，经常会有网友在调侃老了、学不动了，html

虽是在调侃却又间接阐述着无奈，迫于生活的压力，不得不提速前行，前端

由于没有谁为你而停留，公司不会、社会不会、同伴不会……，停下可能将意味着淘汰 —— 理想很丰满，现实很骨感，因此让咱们一块儿进步，共同加薪，奋斗吧骚年，加油。。java

～～吐槽过了，接着聊正事～～。node

　原谅我控制不住本身，想问下各位，昨天刚刚过去的双十一你脱单了吗？

人生若只如初见，何事秋风悲画扇；
等闲变却故人心，却道故人心易变；
骊山语罢清宵半，夜雨霖铃终不怨。

各位大佬早安，这里是 @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的改动蛮大的，功能比以前强大了少，也简便了开发者不少的麻烦，效率大大提升，但同时也意味着咱们对于底层的东西，了解的更少了，下一章节将为你们分享一些经常使用的插件/以及用法的分析，欢迎持续关注，记得点个赞哦，固然您能动动手指关注下方公众号就更棒了，谢谢支持！react

webpack4配置详解之逐行分析

前言

原谅我控制不住本身，想问下各位，昨天刚刚过去的双十一你脱单了吗？

entry

output - 输出

hash

mode

devtool

optimization

resolve - 配置模块如何解析

module.rules - 编译规则，

项目中经常使用loader

plugins - 插件

plugins/loader 区别

webpack-dev-server

webpack4删除的点：

尾声：

更多文章：

　原谅我控制不住本身，想问下各位，昨天刚刚过去的双十一你脱单了吗？