webpack4配置详解之慢嚼细咽

于 2019-07-31 07:02:00 发布
阅读量232 收藏
点赞数

经常会有人会问起 webpack、 react、 redux、甚至 create-react-app配置等等方面的问题，有些是我也不懂的，慢慢从大家的相互交流中，也学到了不少。

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

Entry

- 这个不用解释了，看名字就是知道，它就是通往天堂/地狱的 入口，一切的苦难从这里开始，也从这里结束。

- 简单介绍几种写法：

//方式一：单文件写法	
entry: {	
    index: './src/pages/route.js',	
    //about: './src/pages/about.js',	
    //other:()=>{...}	
}	
//方式二：多文件写法	
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较多，每个都有它不一样的特性，有兴趣的同学可以一一尝试，

-  

640?wx_fmt=png

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}` //方式二	
  }	
}

640?wx_fmt=png


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的改动蛮大的，功能比之前强大了少，也简便了开发者很多的麻烦，效率大大提高，但同时也意味着我们对于底层的东西，了解的更少了，下一章节将为大家分享一些常用的插件/以及用法的分析。

深入了解webpack请戳：

640?wx_fmt=png

福利

640?wx_fmt=png

640?wx_fmt=png

对书感兴趣的朋友可以点击“阅读原文”查看详情，深入了解webpack请戳：

frontend_frank
关注
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值