GitHub 完整配置文件地址: https://github.com/yhtx1997/w...
由于篇幅过长分三次发布,建议按顺序看
[ webpack4 ] 配置属于自己的打包系统教程(一)—— 基础配置篇
[ webpack4 ] 配置属于自己的打包系统教程(二)—— 资源配置篇
[ webpack4 ] 配置属于自己的打包系统教程(最终篇)—— 环境配置篇
环境配置篇
主要内容
- 开发环境生产环境分离
- 实时预览
- webpack-dev-server 其他常用
- 代码复用处理
开发环境和生产环境
到了这一步,该讲讲开发环境模式和生产环境模式了
- 开发环境是自己开发时用的,需要有实时编译功能、模块热替换功能(更新文件不用完全更新页面)、错误提示到具体哪个文件几行
- 生产环境是放到线上给用户使用的,需要代码压缩功能
配置代码组件化
我们先把之前配置好的 webpack 配置文件改下名,改名 webpack.common.js ,意思是开发环境和生产环境都需要的,将代码压缩之类的挪到生产配置下
之后安装 webpack-merge ,官方推荐的是为每个环境写单独的 webpack 文件
虽然有简单的方法实现但是依然推荐写单独的配置文件,因为在这样的配置方式你可以更清楚你自己在做什么,还可以让你的配置更加个性(自定义)
安装 webpack-merge
npm install webpack-merge -D
新建开发环境配置
我们新建一个 js 文件,命名为 webpack.dev.js ,添加如下代码
const merge = require('webpack-merge');//合并配置
const common = require('./webpack.common.js');//引入公共配置
module.exports = merge(common, {
mode: 'development',//声明是开发环境
//关于 dev 的配置
})
新建开发环境配置
我们新建一个 js 文件,命名为 webpack.prod.js
添加如下代码
const merge = require('webpack-merge');//合并配置
const UglifyJSPlugin = require('uglifyjs-webpack-plugin');//用来压缩 js 代码
const common = require('./webpack.common.js');//引入公共配置
module.exports = merge(common, {
mode: 'production',//声明是生产环境
//关于 prod 的配置
});
开发环境
实时预览
跟着配置并操作的小伙伴可能发现了,每次修改后都需要手动在命令行输入命令,并且还要刷新浏览器才能看到最新的效果
那么现在来解决这两个问题,方法就是使用 webpack-dev-server
安装
npm install webpack-dev-server -D
配置
- 实时预览
- 自定义请求代理
- 自定义 ip 及端口
- 注:使用 webpack-dev-server 并不会编译到本地文件,而是放到内存中
const merge = require('webpack-merge');
const common = require('./webpack.common.js');
const path = require('path');
const webpack = require('webpack');
module.exports = merge(common, {
mode: 'development',
devServer: {
contentBase: path.join(__dirname, 'dist'),//预览的目录,写出口目录的绝对路径
hot: true,//模块热更新
host: 'localhost',//默认值 也可以改为 127.0.0.1 或者其他
port: 8080,
proxy: {
'/api': 'http://localhost:3000'//请求到 /api/users 现在会被代理到请求 http://localhost:3000/api/users
}
}
})
接下来加入错误提示以及将生成 HTML 的代码从公共配置( webpack.common.js )拿到这里
因为开发和生产有些许不一样,我又不知道怎样简单配置,所以开发环境和生产环境我都会放一个生成 HTML 的代码
生产环境
- 每次打包都要清理掉旧文件
- 所有代码都要进行压缩
- 重复的 js 代码,需要只有一个就好
文件清理
从公共配置( webpack.common.js )将之前文件清理的代码拿过来放到这里
const merge = require('webpack-merge');
const common = require('./webpack.common.js');
const CleanWebpackPlugin = require('clean-webpack-plugin');
module.exports = merge(common, {
mode: 'production',
plugins: [
new CleanWebpackPlugin(['dist']),
new HtmlWebpackPlugin({
title: '2048',
template: './src/index.html',
minify: true,//HTML 代码压缩
hash: true
}),
],
})
代码压缩
先安装压缩代码的插件
npm install uglifyjs-webpack-plugin -D
npm install optimize-css-assets-webpack-plugin -D
- uglifyjs-webpack-plugin 是 js 压缩插件
- optimize-css-assets-webpack-plugin 是推荐和
const UglifyJsPlugin = require("uglifyjs-webpack-plugin");
const OptimizeCSSAssetsPlugin = require("optimize-css-assets-webpack-plugin");
复用代码分离
假设需要使用 jQuery 来辅助开发,我在 a.js b.js 两个文件都引入了 jQuery ,将 a.js b.js 打包成 a.min.js b.min.js ,这时看他们的体积会比原来大很多,且 a 和 b 的代码中都包含完整的 jQuery 代码
为了解决这种情况,我们需要将 jQuery 这种复用的代码分离到单独的文件
在将环境设置为生产环境时默认开启了很多功能,其中 SplitChunksPlugin 就是用于避免重复依赖的
在我们不配置时 默认配置是这样的
optimization: {
splitChunks: {
chunks: 'async',
minSize: 30000,
minChunks: 1,
}
}
- chunks: 表示哪些代码需要优化,有三个可选值:initial(初始块)、async(按需加载块)、all(全部块),默认为async 改成 all 支持所有的
- minSize: 这个文件最少是多少才去优化,默认为 30000 实际测试是文件大于 30 kb,在 31kb时开始优化
- minChunks: 最少引用几次才去优化,默认为1 实际测试为在只引用一次的情况不优化,只有大于它才优化
- 注: 还有其他属性个人感觉不常用就没写,了解更多可以看这里
最终代码汇总
最终公共配置 webpack.common.js 代码如下
const path = require('path');
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
module.exports = {
entry: {
512:'./src/js/512.js',
1024:'./src/js/1024.js',
2048:'./src/js/2048.js',
},
plugins: [
new MiniCssExtractPlugin({
filename: "css/[name].css"
})
],
output: {
filename: "js/[name].js",
path: path.resolve(__dirname, 'dist')
},
module: {
rules: [
{
test: /\.js$/,
exclude: /(node_modules|bower_components)/,
use: {
loader: 'babel-loader',
options: {
presets: ['@babel/preset-env']
}
}
},
{
test: /\.scss$/,
use: [
MiniCssExtractPlugin.loader,
'css-loader',
'postcss-loader',
'sass-loader',
]
},
{
test: /\.(png|svg|jpg|gif)$/,
use: [
'file-loader'
]
},
{
test: /\.(woff|woff2|eot|ttf|otf)$/,
use: [
'file-loader'
]
},
{
test: /\.(csv|tsv)$/,
use: [
'csv-loader'
]
},
{
test: /\.xml$/,
use: [
'xml-loader'
]
}
]
},
}
最终开发环境 webpack.dev.js 代码如下
const merge = require('webpack-merge');
const common = require('./webpack.common.js');
const path = require('path');
const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = merge(common, {
mode: 'development',
plugins: [
new HtmlWebpackPlugin({
title: '2048',
template: './src/index.html',
minify: false,
hash: true
})
],
devtool: 'inline-source-map',
devServer: {
contentBase: path.join(__dirname, 'dist'),
host: 'localhost',
port: 8080,
proxy: {
'/api': 'http://localhost:3000'
}
}
})
最终生产环境 webpack.prod.js 代码如下
const merge = require('webpack-merge');
const common = require('./webpack.common.js');
const UglifyJsPlugin = require("uglifyjs-webpack-plugin");
const OptimizeCSSAssetsPlugin = require("optimize-css-assets-webpack-plugin");
const HtmlWebpackPlugin = require('html-webpack-plugin');
const CleanWebpackPlugin = require('clean-webpack-plugin');
module.exports = merge(common, {
mode: 'production',
plugins: [
new CleanWebpackPlugin(['dist']),
new HtmlWebpackPlugin({
title: '2048',
template: './src/index.html',
minify: true,
hash: true
}),
],
optimization: {
splitChunks: {
chunks: 'all'
},
minimizer: [
new UglifyJsPlugin({
cache: true,
parallel: true,
sourceMap: true
}),
new OptimizeCSSAssetsPlugin({})
],
}
});
npm 项目配置代码 package.json 代码如下
{
"name": "2048",
"version": "1.0.0",
"description": "",
"private": true,
"main": "index.js",
"scripts": {
"dev": "webpack-dev-server --open --config webpack.dev.js",
"build": "webpack --config webpack.prod.js"
},
"keywords": [],
"author": "",
"license": "ISC",
"dependencies": {
"webpack": "^4.28.3"
},
"devDependencies": {
"@babel/core": "^7.2.2",
"@babel/preset-env": "^7.2.3",
"autoprefixer": "^9.4.3",
"babel-loader": "^8.0.4",
"clean-webpack-plugin": "^1.0.0",
"css-loader": "^2.1.0",
"csv-loader": "^3.0.2",
"extract-text-webpack-plugin": "^4.0.0-beta.0",
"file-loader": "^3.0.1",
"html-webpack-plugin": "^3.2.0",
"mini-css-extract-plugin": "^0.5.0",
"node-sass": "^4.11.0",
"optimize-css-assets-webpack-plugin": "^5.0.1",
"postcss": "^7.0.7",
"postcss-loader": "^3.0.0",
"sass-loader": "^7.1.0",
"style-loader": "^0.23.1",
"uglifyjs-webpack-plugin": "^2.1.1",
"webpack-cli": "^3.1.2",
"webpack-dev-server": "^3.1.14",
"webpack-merge": "^4.1.5",
"xml-loader": "^1.2.1"
}
}