webpack4.x 入门一篇足矣
前言:
webpack4出了以后,一些插件变化很大,和之前的版本使用方式不一样,新手入坑,本篇将介绍如何从一开始配置webpack4的开发版本,对css,js进行编译打包合并生成md5,CSS中的图片处理,js自动注入html页,删除指定文件,提取公共文件,热更新等等。
后面有附上webpack打包优化的配置信息及详细注释
安装
//全局安装
npm install -g webpack webpack-cli
创建文件夹初始化
//创建文件夹
mkdir webpack4demo
//进入
cd webpack4demo
//初始化
npm init -y
创建文件夹scripts 里面创建index.js文件
index.js
const s=()=>{
console.log('s init')
}
s()
创建webpack.config.js文件
webpack.config.js
const path = require("path");
module.exports = {
entry: {
index: "./scripts/index.js" //入口文件,若不配置webpack4将自动查找src目录下的index.js文件
},
output: {
filename: "[name].bundle.js",//输出文件名,[name]表示入口文件js名
path: path.join(__dirname, "dist")//输出文件路径
}
}
执行webpack --mode development将会生成dist/index.bundle.js
创建index.html,并引入js
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>$Title$</title>
</head>
<body>
$END$
</body>
<script src="./dist/index.bundle.js"></script>
</html>
打开浏览器将会看到之前设置的js文件生效
对css,js进行编译打包合并生成md5
创建a.js,c.js,a.css,更改index.js
a.js
import acss from './a.css'
import c from './c.js'
const a={
init(){
console.log("a init bbbaaa")
},
cinit(){
c.init()
}
}
export default a;
c.js
const c={
init(){
console.log("ccccc")
}
}
export default c;
a.css
body{
background-color: #6b0392;
}
index.js
import a from './a.js'
import c from './c.js'
const s=()=>{
a.init()
a.cinit()
c.init()
console.log('s init')
}
s()
配置webpack.config.js文件
const path = require("path");
module.exports = {
entry: {
index: "./scripts/index.js"
},
output: {
filename: "[name].bundle.[hash].js",//[hash]会在后面生成随机hash值
path: path.join(__dirname, "dist")
},
module: { // 处理对应模块
rules: [
{
test: /\.css$/,
use: [ 'style-loader', 'css-loader' ]//处理css
}
]
},
}
安装style-loader, css-loader
npm install style-loader css-loader --save-dev
执行webpack --mode development
将会看到一个带md5值得js文件,将他引入html中
CSS中的图片处理
安装url-loader, file-loader
npm install url-loader file-loader --save-dev
修改a.css 将一张图片放到scripts目录
body{
background-image: url("./timg.jpg");
background-color: #a748ca;
}
配置webpack.config.js文件
module: {
rules: [
{
test: /\.css$/,
use: [ 'style-loader', 'css-loader' ]
},
{
test:/\.(png|jpg|gif)$/,
use:[{
loader:'url-loader',
options:{
outputPath:'images/',//输出到images文件夹
limit:500 //是把小于500B的文件打成Base64的格式,写入JS
}
}]
}
]
},
执行webpack --mode development
将会看到dist中有一个images文件夹中有一张图片,打开index.html
js自动注入html文件
使用插件html-webpack-plugin,可以将生成的js自动引入html页面,不用手动添加
//安装html-webpack-plugin
npm install html-webpack-plugin --save-dev
//安装webpack webpack-cli
npm install webpack webpack-cli --save-dev
配置webpack.config.js文件
const path = require("path");
const HtmlWebpackPlugin = require('html-webpack-plugin');//引入html-webpack-plugin
module.exports = {
entry: {
index: "./scripts/index.js"
},
output: {
filename: "[name].bundle.[hash].js",
path: path.join(__dirname, "dist")
},
module: {
rules: [
{
test: /\.css$/,
use: [ 'style-loader', 'css-loader' ]
}
]
},
plugins: [// 对应的插件
new HtmlWebpackPlugin({ //配置
filename: 'index.html',//输出文件名
template: './index.html',//以当前目录下的index.html文件为模板生成dist/index.html文件
}),
]
}
执行webpack --mode development
记得要讲之前手动引入的script删除,便可以看到dist那里自动生成一个index.html,打开便可以看到。
删除指定文件
使用插件clean-webpack-plugin,删除指定文件,更多配置,查看clean-webpack-plugin
npm install clean-webpack-plugin --save-dev
配置webpack.config.js文件
const CleanWebpackPlugin = require('clean-webpack-plugin');//引入
plugins: [// 对应的插件
new HtmlWebpackPlugin({ //配置
filename: 'index.html',//输出文件名
template: './index.html',//以当前目录下的index.html文件为模板生成dist/index.html文件
}),
new CleanWebpackPlugin(['dist']), //传入数组,指定要删除的目录
]
执行webpack --mode development,
可以看到dist目录被删除,又生成一个新的dist,之前的js文件已经被删除。
提取公共文件
我们可看到a.js和index.js都引入了c.js文件,为什么要提取公共代码,简单来说,就是减少代码冗余,提高加载速度。和之前的webpack配置不一样:
//之前配置
// new webpack.optimize.SplitChunksPlugin({
// name: 'common', // 如果还要提取公共代码,在新建一个实例
// minChunks: 2, //重复两次之后就提取出来
// chunks: ['index', 'a'] // 指定提取范围
// }),
//现在配置
optimization: {
splitChunks: {
cacheGroups: {
commons: { // 抽离自己写的公共代码
chunks: "initial",
name: "common", // 打包后的文件名,任意命名
minChunks: 2,//最小引用2次
minSize: 0 // 只要超出0字节就生成一个新包
},
vendor: { // 抽离第三方插件
test: /node_modules/, // 指定是node_modules下的第三方包
chunks: 'initial',
name: 'vendor', // 打包后的文件名,任意命名
// 设置优先级,防止和自定义的公共代码提取时被覆盖,不进行打包
priority: 10
},
}
}
},
下载jq npm install jquery --save
在a.js,index.js引用 import $ from 'jquery'
输出$
生成3个js文件,执行webpack --mode development
热更新,自动刷新
我们将用到webpack-dev-server
,webpack-dev-server
就是一个基于Node.js
和webpack
的一个小型服务器,它有强大的自动刷新和热替换功能。
安装webpack-dev-server
npm install webpack-dev-server --save-dev
配置webpack.config.js文件
const webpack = require("webpack");
plugins: [
new HtmlWebpackPlugin({
filename: 'index.html',
template: './index.html',
}),
new CleanWebpackPlugin(['dist']), //传入数组,指定要删除的目录
// 热更新,热更新不是刷新
new webpack.HotModuleReplacementPlugin()
],
devServer: {//配置此静态文件服务器,可以用来预览打包后项目
inline:true,//打包后加入一个websocket客户端
hot:true,//热加载
contentBase: path.resolve(__dirname, 'dist'),//开发服务运行时的文件根目录
host: 'localhost',//主机地址
port: 9090,//端口号
compress: true//开发服务器是否启动gzip等压缩
},
配置package.json
"scripts": {
"dev": "webpack-dev-server --mode development"
},
执行npm run dev
访问 http://localhost:9090/
随便修改任一文件便会自动刷新网站显示修改相应内容。
总结:
webpack4还有很多很多配置,例如css的拆分呀,less sass配置呀,js编译es6呀,多入口配置呀,生产环境配置,js没有使用的模块自动检测剥离等等,只能等下次有空在总结,感谢大家的观看,新手入坑,欢迎指出错误的地方。
webpack打包优化配置
附上3个文件,webpack.base.conf.js(基本配置文件),webpack.dev.conf.js(开发环境配置文件),webpack.prod.conf.js(生产环境配置文件),里面有详细的注释
webpack.base.conf.js
const path = require("path")
const chalk = require('chalk');
const ProgressBarPlugin = require('progress-bar-webpack-plugin')//进度条
const MiniCssExtractPlugin = require('mini-css-extract-plugin') //CSS文件单独提取出来
const VueLoaderPlugin = require('vue-loader/lib/plugin');
const HappyPack = require('happypack')//多线程压缩
const os = require('os')// node 提供的系统操作模块
// 根据系统的内核数量 指定线程池个数
const happyThreadPool = HappyPack.ThreadPool({ size: os.cpus().length })
const ExtractTextPlugin = require('extract-text-webpack-plugin')
// 转换为绝对路径
function resolve(dir) {
return path.join(__dirname,'..', dir);
}
function assetsPath(_path_) {
let assetsSubDirectory = 'static';
return path.posix.join(assetsSubDirectory, _path_)
}
module.exports = {
entry: {
app: './src/main.js'//入口文件
},
output: {
path: resolve("dist"),//输出文件路径
filename: '[name].js' //输出文件名,[name]表示入口文件js名
},
resolve: {
// 优化模块查找路径
modules: [
path.resolve('src'),
path.resolve('node_modules') // 指定node_modules所在位置 当你import 第三方模块时 直接从这个路径下搜索寻找
],
//开启后缀名自动补全,指定搜索那些文件
extensions: ['.js','.vue','.json'],
//配置别名可以加快webpack查找模块的速度
alias: {
'vue$': 'vue/dist/vue.esm.js',//末尾添加 $,以表示精准匹配
'@': resolve('src')
}
},
//模块
module: {
// 多个loader是有顺序要求的,从右往左写,因为转换的时候是从右往左转换的
rules: [
{
test: /\.vue$/,
loader: 'vue-loader',
include: resolve('src'),//限制范围,提高打包速度
exclude: /node_modules/ //排除
},
{
test: /\.js|jsx$/,
exclude: /node_modules/,
loader: 'happypack/loader?id=happys',// cacheDirectory缓存loader执行结果
include: resolve('src'),
exclude: /node_modules/
},
{
test: /\.css$/,
loader: ExtractTextPlugin.extract({
fallback: 'style-loader',
use: ['css-loader', 'postcss-loader', 'less-loader']
}),
include: [resolve('src')], //限制范围,提高打包速度
exclude: /node_modules/
},
{
test: /\.less$/,
loader: ExtractTextPlugin.extract({
fallback: 'style-loader',
use:['css-loader', 'postcss-loader', 'less-loader']}),
include: resolve('src'),
exclude: /node_modules/
},
{
test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
loader: 'url-loader',
options: {
limit: 10000,// 10KB 以下使用 base64
name: assetsPath('img/[name].[hash:7].[ext]')
}
webpack.dev.conf.js
const webpack = require('webpack')
const path = require('path')
const baseWebpackConfig = require('./webpack.base.conf')
const merge = require('webpack-merge')
const HtmlWebpackPlugin = require('html-webpack-plugin') // 生成html的插件
const devWebpackConfig = merge(baseWebpackConfig, {
devtool: 'eval-source-map', // 指定加source-map的方式
//配置此静态文件服务器,可以用来预览打包后项目
devServer: {
inline:true,//打包后加入一个websocket客户端
hot:true,//热加载
contentBase: path.join(__dirname, "..", "dist"), //静态文件根目录
port: 3824, // 端口
host: 'localhost',
overlay: true,
compress: false // 服务器返回浏览器的时候是否启动gzip压缩
},
watchOptions: {
ignored: /node_modules/, //忽略不用监听变更的目录
aggregateTimeout: 500, //防止重复保存频繁重新编译,500毫秒内重复保存不打包
poll:1000 //每秒询问的文件变更的次数
},
plugins: [
new HtmlWebpackPlugin({
template: path.resolve(__dirname, '..', 'src','index.html'),
filename: 'index.html',
// vendor: './vendor.dll.js', //与dll配置文件中output.fileName对齐
hash:true,//防止缓存
// minify:{
// removeAttributeQuotes:true//压缩 去掉引号
// }
}),
new webpack.HotModuleReplacementPlugin(), //HMR
new webpack.NamedModulesPlugin() // HMR
]
})
module.exports = devWebpackConfig
webpack.prod.conf.js
const path = require('path');
const glob = require('glob');
const webpack = require('webpack')
const CopyWebpackPlugin = require('copy-webpack-plugin') // 复制静态资源的插件
const CleanWebpackPlugin = require('clean-webpack-plugin') // 清空打包目录的插件
const HtmlWebpackPlugin = require('html-webpack-plugin') // 生成html的插件
const baseWebpackConfig = require('./webpack.base.conf')
const merge = require('webpack-merge')
const WebpackParallelUglifyPlugin = require('webpack-parallel-uglify-plugin')
const OptimizeCSSPlugin = require('optimize-css-assets-webpack-plugin')
const PurifyCSSPlugin = require("purifycss-webpack");
const ExtractTextPlugin = require('extract-text-webpack-plugin')
function assetsPath(_path_) {
let assetsSubDirectory = 'static';
return path.posix.join(assetsSubDirectory, _path_)
}
const prodWebpackConfig = merge(baseWebpackConfig, {
output:{
path: path.resolve(__dirname, '../dist'),
filename: assetsPath('js/[name].js'),
publicPath: './' //这里要放的是静态资源CDN的地址(一般只在生产环境下配置)
},
plugins: [
new HtmlWebpackPlugin({
template: path.resolve(__dirname, '../src', 'index.html'),
filename:'index.html',
// chunks:['index', 'common'],
// vendor: './vendor.dll.js',
hash:true,//防止缓存
minify:{
removeAttributeQuotes:true,//压缩 去掉引号,
collapseWhitespace: true //是否去除空格
}
}),
new CopyWebpackPlugin([
{
from: path.join(__dirname, '../src', 'assets'),
to: path.join(__dirname, '..', 'dist', 'assets'),
ignore: ['.*']
}
]),
new CleanWebpackPlugin(['dist'], {
root: path.join(__dirname, '..'),
exclude: ['manifest.json', 'vendor.dll.js'],
verbose: true,
dry: false
}),
new WebpackParallelUglifyPlugin({
workerCount: 4, // 开启几个子进程去并发的执行压缩,默认是当前电脑的cpu数量减1
uglifyJS: {
output: {
beautify: false, // 不需要格式化
comments: false // 保留注释
},
compress: {
warnings: false, // Uglifyjs 删除没有代码时,不输出警告
drop_console: true, // 删除所有console语句
collapse_vars: true,
reduce_vars: true
}
}
}),
//压缩提取出的css,并解决ExtractTextPlugin分离出的js重复问题(多个文件引入同一css文件)
new OptimizeCSSPlugin({
cssProcessorOptions: {safe: true}
}),
//消除未使用的CSS
new PurifyCSSPlugin({
paths: glob.sync(path.join(__dirname, '../src/*.html')),
}),
//打包css生成另外的文件夹
new ExtractTextPlugin({
filename: 'static/css/[name].css',
disable: false,
allChunks: false
})
]
})
module.exports = prodWebpackConfig
转载自:https://juejin.cn/post/6844903623944568839