webpack4配置詳解之慢嚼細嚥

前言

  常常會有羣友問起webpack、react、redux、甚至create-react-app配置等等方面的問題，有些是我也不懂的，慢慢從你們的相互交流中，也學到了很多。

​  今天就嘗試着一塊兒來聊聊Webpack吧，旨在幫你們加深理解、新手更容易上路，都能從0到1搭建配置自定屬於本身的腳手架，或對已封裝好的腳手架有進一步的鞏固，接下來蘇南會詳細講解webpack中的每個配置字段的做用(部分爲webpack4新增)。

近兩年，前端一直在以一個高速持續的過程發展，經常會有網友在調侃老了、學不動了，

雖是在調侃卻又間接闡述着無奈，迫於生活的壓力，不得不提速前行，

由於沒有誰爲你而停留，公司不會、社會不會、同伴不會……，停下可能將意味着淘汰 —— 理想很豐滿，現實很骨感，因此讓咱們一塊兒進步，共同加薪，奮鬥吧騷年，加油。。

～～吐槽過了，接着聊正事～～。

 原諒我控制不住本身，想問下各位，昨天剛剛過去的雙十一你脫單了嗎？

默默說了句：沒脫～

• 人生若只如初見，何事秋風悲畫扇；
• 等閒變卻故人心，卻道故人心易變；
• 驪山語罷清宵半，夜雨霖鈴終不怨。

各位大佬早安，這裏是@IT·平頭哥聯盟，我是首席填坑官∙蘇南，用心分享 作有溫度的攻城獅。
公Z號：honeyBadger8，羣：912594095

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'],
}
//首席填坑官∙蘇南的專欄,公Z好：honeyBadger8
複製代碼

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插件使用
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較多，每一個都有它不同的特性，有興趣的同窗能夠一一嘗試，

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了嗎？爲何還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'
	},
	/* 匹配路徑，進入不一樣的入口文件，首席填坑官∙蘇南的專欄,公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
• 歡迎補充……，平時用到的大概就是這些

尾聲：

  以上就是工做中react自定腳手架的配置總結，但願能對您有所幫助，webpack4的改動蠻大的，功能比以前強大了少，也簡便了開發者不少的麻煩，效率大大提升，但同時也意味着咱們對於底層的東西，瞭解的更少了，下一章將爲你們分享一些經常使用的插件/以及用法的分析，歡迎持續關注，記得點個贊哦，固然您能動動手指關注下方公衆號就更棒了，謝謝支持！

用心分享 作有溫度的攻城獅

做者：蘇南 - 首席填坑官

連接：blog.csdn.net/weixin_4325…

交流：91259409五、公衆好：honeyBadger8

本文原創，著做權歸做者全部。商業轉載請聯繫@IT·平頭哥聯盟得到受權，非商業轉載請註明原連接及出處。

補充說明：

• 有些大佬在評論，說文章是否原創，以爲有必要說明一下，以上分享的內容爲公司如今所用的項目腳手架，Docker、Jenkins、nodejs、express 、配合在線發佈。
• 下圖爲今年前些時間分享的一個SSR 服務端渲染的示例，配置是基於webpack3的，但所使用的配置、插件，腳手架的總體結構都與今天分享的一致，
• 新手上路，也是前端開發，雖然比較菜，但還不屑於抄別人的東西，謝謝！
• gitHub地址：服務端渲染腳手架

網易雲音樂 react服務端渲染示例