为什么需要学习(了解)webpack
webpack是前端工程化的基石,webpack又是基于node进行文件打包bundle,所以作为前端起手学习node服务端开发,同时学习webpack是很有必要的。
随着vite的出现,vue这一脉可能也许不再需要学习webpack了,但是需要知道的是,打包一定是前端工程化绕不开的一个概念,如果是一个足够了解webpack的开发者,日后再学习任何一款前端构建工具都将事半功倍。
但是webpack本身却是是复杂的。真要深入学习付出是必不可少的。
经过基础学习之后能够具备对问题顺藤摸瓜的能力,这是基础要求。
webpack概念
本质上,webpack 是一个用于现代 JavaScript 应用程序的 静态模块打包工具。当 webpack 处理应用程序时,它会在内部从一个或多个入口点构建一个 依赖图(dependency graph),然后将你项目中所需的每一个模块组合成一个或多个 bundles,它们均为静态资源,用于展示你的内容。
webpack核心配置项
webpack.common.js 基本配置项
入口(entry), 出口(output), 插件(plugins),模块打包(loader)const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const webpack = require('webpack');
const MyPlugin = require('./myPlugin');
module.exports = {
// 入口 可多个
entry: './src/main.js',
// 出口 可多个
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'build.js'
},
// 插件
plugins: [
new webpack.DefinePlugin({
VERSION: JSON.stringify('1.0.0')
}),
new HtmlWebpackPlugin({ template: './public/index.html', title: 'webpack app' }),
new MyPlugin()
],
// 模块loader
module: {
rules: [
{
test: /\.css$/i,
use: ['style-loader', 'css-loader', './myLoader']
}
]
}
};
webpack.dev.js 开发环境配置项
代理服务器(devServer) 调试工具(devtool)const { merge } = require('webpack-merge');
const path = require('path');
const common = require('./webpack.common.js');
const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
module.exports = merge(common, {
plugins: [
new BundleAnalyzerPlugin({
analyzerPort: 8888,
openAnalyzer: false
})
],
// 模式
mode: 'development',
// devServer
devServer: {
static: {
// 告诉服务器从哪里提供内容。只有在你希望提供静态文件时才需要这样做。static.publicPath 将会被用来决定应该从哪里提供 bundle,并具有优先级。
publicPath: '/',
directory: path.join(__dirname, 'public')
},
host: 'localhost',
port: 8080,
open: true
},
// source-map 会在webpack打包生成的文件模块的末端 加上 //# sourceURL=
// 映射source-map
devtool: 'inline-source-map'
});
webpack.prod.js 生产环境配置项
externals(打包剔除优化)const { merge } = require('webpack-merge');
const common = require('./webpack.common.js');
const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');
module.exports = merge(common, {
plugins: [
new CleanWebpackPlugin(),
new BundleAnalyzerPlugin({
analyzerPort: 1055,
openAnalyzer: false
})
],
// 模式
mode: 'production',
// externals key: value
// key和 import jQ from 'jquery'; 中的 'jquery' 一样
// value 用于替换 import jQ from 'jquery' 中的jQ
// 所以 value 必须和cdn引用暴露的window变量一样
externals: {
jquery: 'jQuery'
}
});
main.js
顺着main.js
我们往下看
import './style.css';
import jQ from 'jquery';
const str = 'hello webpack';
// 再webpack中
// 告知 webpack 将 process.env.NODE_ENV 设置为一个给定字符串。
// 如果 optimization.nodeEnv 不是 false,则会使用 DefinePlugin,optimization.nodeEnv 默认值取决于 mode,
// 如果为 falsy 值,则会回退到 "production"。
console.log(process.env.NODE_ENV);
//打包常量直接替换为 console.log('hello webpack');
console.log(str);
//生产环境用cdn
console.log(jQ);
//webpack.DefinePlugin
console.log(VERSION);
// 开启 devtool: 'inline-source-map' 方便调试
// console.log(VERSION.t.t);
实现js文件中引入css
因为在webpack.common.js
中配置了css模块的loader,这样webpack就能知道怎么去处理对应的文件,以及处理之后给js暴露一个什么样的对象
生产环境不将jquery打包,改用cdn引入
因为在webpack.prod.js
中配置了打包剔除优化(externals),结合使用插件HtmlWebpackPlugin
结合 ejs语法
, 在html模板中实现生产环境使用cdn引入jquery,当然此处还涉及了如何判断开发环境和生产环境,用到了一个node进程对象变量process.env.NODE_ENV
默认情况取决于webpack配置项mode
的值
html模板如下
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title><%= htmlWebpackPlugin.options.title %>title>
<% if (process.env.NODE_ENV === 'production' ) { %>
<script src="https://code.jquery.com/jquery-3.7.1.min.js">script>
<% } %>
head>
<body>
<h1>hello webpack serverh1>
body>
html>
使用DefinePlugin 在 编译时 将代码中的变量替换为其他值或表达式
这里你也可以用来区分开发环境和生产环境而不是使用process.env.NODE_ENV
, 在main.js
中我们输出了一个被定义为字符串1.0.0的VERSION,console.log(VERSION); ==> console.log('1.0.0');
实现MyLoader
MyPlugin
在cmd控制台
打印MyLoader… MyPlugin… 自定义规则需要结合文档
module.exports = function (source) {
const content = source;
console.log('MyLoader...');
return content;
};
//loader 从右到左(或从下到上)地取值(evaluate)/执行(execute)
//盲猜源码用了pop()
module.exports = class MyPlugin {
apply(compiler) {
// 找到合适的事件钩子,实现自己的插件功能
compiler.hooks.emit.tap('MyPlugin', () => {
// compilation: 当前打包构建流程的上下文
console.log('MyPlugin...');
});
}
};