webpack4配置详解(新)

入职新公司,看了他们的webpack配置,再次总结下

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自身的内容计算而来,'js/[name].[chunkhash:8].js'
contenthash 提取css文件时根据内容计算而来的 hash ,结合ExtractTextWebpackPlugin插件使用

mode

这个属于webpack4才新增的,4之前大家一般用DefinePlugin插件设置
mode:development``,production,none,
development : 开发模式,打包的代码不会被压缩,开启代码调试,
production : 生产模式,则正好反之。

//方法一
webpack --mode development/production

//方法二
……
mode:'development/production'
……

devtool

  • 控制是否生成,以及如何生成 source map文件,开发环境下更有利于定位问题,默认 false,
  • 当然它的开启,也会影响编译的速度,所以生产环境一定一定记得关闭;
  • 常用的值:cheap-eval-source-mapeval-source-mapcheap-module-eval-source-mapinline-cheap-module-source-map等等,更详细的可以去官方查看
  • 本人一般使用:eval-source-map较多,每个都有它不一样的特性,有兴趣的同学可以一一尝试,

optimization

optimization是webpack4新增的,主要是用来让开发者根据需要自定义一些优化构建打包的策略配置,
minimize:true/false,告诉webpack是否开启代码最小化压缩,
minimizer:自定js优化配置,会覆盖默认的配置,结合UglifyJsPlugin插件使用,
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/,
            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的作用在于解析文件,比如把ES6转换成es5,甚至ES3,毕竟还有万恶的IE嘛;把Sass、Less解析成CSS,给CSS自动加上兼容的前缀;对图片进行一个解析等等;
plugins呢?它在干啥?它在吹水、喝茶、嗑瓜子聊天,当然这是loader在没有把项目做完之前,loader下班时间就是plugins苦难的开始,它要对loader干的事情进行优化分类、提取精华(公共代码提取)、做压缩处理(js/css/html压缩)、输出指定的目录等……,反正也是很苦逼!

webpack-dev-server

这个有些老生常谈了,就不说了
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'
    },
    /*
    匹配路径,进入不同的入口文件,首席填坑官∙苏南的专栏,公Z好: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
欢迎补充……,平时用到的大概就是这些

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

推荐阅读更多精彩内容