webpack4.x 入门一篇足矣

前言：

webpack4出了以后，一些插件变化很大，和之前的版本使用方式不一样，新手入坑，本篇将介绍如何从一开始配置webpack4的开发版本，对css，js进行编译打包合并生成md5，CSS中的图片处理，js自动注入html页，删除指定文件，提取公共文件，热更新等等。

后面有附上webpack打包优化的配置信息及详细注释

更新了一篇前端架构之node jwt认证，欢迎各位大佬观摩观摩！！！

更新了一篇小小node server架构，欢迎各位大佬观摩观摩！！！

安装

//全局安装 
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