Webpack 简介
什么是 Webpack?
- webpack是一种前端资源构建工具,一个静态模块打包器
- 在webpack看来,前端所有的资源文件都会作为模块处理
- 它将根据模块的依赖关系进行静态分析,打包生成对应的静态资源(bundle)’
Webpack 五个核心概念
- Entry:入口指示 Webpack 以哪个文件为入口起点开始打包,分析构建内部依赖图
- Output:输出指示 Webpack 打包后的资源 bundles 输出到哪里去,以及如何命名
- Loader:让 Webpack 能够去处理那些非JS文件
- Plugins:可以用于执行范围更广的任务。插件的范围包括,从打包优化和压缩,一直到重新定义环境中的变量等
- Mode:指示 Webpack 使用相应模式的配置。
选项 | 描述 | 特点 |
---|---|---|
development | 会将 process.env.NODE_ENV 的值设置为development | 能让代码本地调试运行的环境 |
production | 会将 process.env.NODE_ENV 的值设置为production | 能让代码优化上线运行的环境 |
Webpack开发环境基本配置
1. 打包 JS 和 JSON
// 入口起点文件
import data from "./data.json";
// import './index.css' 命令执行会报错
console.log(data);
function add(x, y) {
return x + y;
}
console.log(add(1, 2));
运行指令
1.开发环境:webpack ./webpack/02webpack初体验/src/index.js -o ./webpack/02webpack初体验/build/built.js --mode=development(以 ./src/index.js 为入口文件开始打包,打包后输出到 ./build/built.js,整体打包环境为开发环境)
2.生产环境:webpack ./webpack/02webpack初体验/src/index.js -o ./webpack/02webpack初体验/build/built.js --mode=production
结论:
- webpack可以处理js/json资源,不能处理css/img等其他资源
- 生产环境和开发环境将ES6模块化编译成浏览器能识别的模块化
- 生产环境比开发环境多一个压缩js代码
2. 打包样式资源
import "./index.css";
import "./test.less";
配置文件 webpack.config.js
/*
webpack配置文件
webpack指令运行时会加载其中的配置
所有的构建工具都是基于Node.js来运行的,模块化默认采用CommonJS
*/
// 用来拼接绝对路径的方法
const { resolve } = require("path");
module.exports = {
// 入口文件
entry: "./src/index.js",
output: {
filename: "built.js",
// 路径写绝对路径 __dirname代表当前文件的绝对路径
path: resolve(__dirname, "build"),
},
// loader配置
module: {
rules: [
// 不同文件配置不同的loader
{
// 匹配哪些文件
test: /\.css$/,
// 使用哪些loader,loader按照从后往前的顺序执行
use: [
// 创建style标签,将js中的css样式资源插入进去,添加到页面中生效
"style-loader", // 需要下载
//将css文件变成commonjs模块加载到js中,内容是样式字符串
"css-loader", // 需要下载
],
},
{
test: /\.less$/,
use: [
"style-loader",
"css-loader",
// 将less文件编译成css文件
"less-loader", // 需要额外再下载less包
],
},
],
},
plugins: [],
mode: "development",
};
直接运行 webpack 指令即可
<h1 id="title">大河之剑天上来</h1>
<script src="./built.js"></script>
使用上述代码进行测试打包是否正确
3. 打包 html 资源
/*
需要使用插件来打包html资源
1.下载 2.引入 3.配置插件
*/
const { resolve } = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");
module.exports = {
entry: "./src/index.js",
output: {
filename: "built.js",
path: resolve(__dirname, "build"),
},
module: {
rules: [],
},
plugins: [
// 默认创建一个空的 html 文件,自动引入打包输出的所有资源
new HtmlWebpackPlugin({
// 复制这个文件,并自动引入打包输出的所有资源
template: "./src/index.html",
}),
],
mode: "development",
};
4. 打包图片资源
index.html
<div id="box1"></div>
<div id="box2"></div>
<div id="box3"></div>
<img src="./angular.jpg" alt="angular">
index.less
#box1 {
width: 100px;
height: 100px;
background-image: url("./vue.jpg");
background-repeat: no-repeat;
background-size: 100% 100%;
}
#box2 {
width: 200px;
height: 200px;
background-image: url("./react.png");
background-repeat: no-repeat;
background-size: 100% 100%;
}
#box3 {
width: 300px;
height: 300px;
background-image: url("./angular.jpg");
background-repeat: no-repeat;
background-size: 100% 100%;
}
index.js
import "./index.less";
webpack.config.js
const { resolve } = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");
module.exports = {
entry: "./src/index.js",
output: {
filename: "built.js",
path: resolve(__dirname, "build"),
},
module: {
rules: [
{
test: /\.less$/,
use: ["style-loader", "css-loader", "less-loader"],
},
{
// 这种方式无法处理html中的img图片
test: /\.(jpg|png|gif)$/,
// 下载url-loader 和 file-loader
loader: "url-loader",
options: {
// 图片大小小于8kb,就会被base64处理
// 优点:减少请求数量(减轻服务器压力)
// 缺点:图片体积会更大(请求速度慢)
limit: 8 * 1024,
// url-loader 默认使用es6模块化解析,而html-loader引入图片是commonJS,解析时会报错
// 关闭url-loader的es6模块化,使用commonJS来解析
esModule: false,
// 图片名是哈希值,会比较长,使用以下方式重命名
// 含义:取hash的前10位,[ext]表示取文件原来的扩展名
name: "[hash:10].[ext]",
},
},
{
test: /\.html$/,
// 处理html文件中的img图片(负责引入img,从而能被url-loader进行处理)
loader: "html-loader",
},
],
},
plugins: [
new HtmlWebpackPlugin({
template: "./src/index.html",
}),
],
mode: "development",
};
打包后的index.html
<div id="box1"></div>
<div id="box2"></div>
<div id="box3"></div>
<img src="830bf3c820.jpg" alt="angular" />
<script src="built.js"></script>
5. 打包其他资源
index.html
<link rel="stylesheet" href="./iconfont.css">
<span class="iconfont icon-auto"></span>
<span class="iconfont icon-data"></span>
<span class="iconfont icon-rmb"></span>
<span class="iconfont icon-play-fill"></span>
index.js
// 引入样式文件
import "./iconfont.css";
在src文件夹中引入字体库的css文件和字体文件
webpack.config.js
const { resolve } = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");
module.exports = {
entry: "./src/index.js",
output: {
filename: "built.js",
path: resolve(__dirname, "build"),
},
module: {
rules: [
{
test: /\.less$/,
use: ["style-loader", "css-loader"],
},
// 打包其他资源(除了html/js/css资源以外的资源)
{
// 排除某些资源
exclude: /\.(css|js|html)$/,
loader: "file-loader",
}
],
},
plugins: [
new HtmlWebpackPlugin({
template: "./src/index.html",
}),
],
mode: "development",
};
打包后的html
<link rel="stylesheet" href="./iconfont.css">
<span class="iconfont icon-auto"></span>
<span class="iconfont icon-data"></span>
<span class="iconfont icon-rmb"></span>
<span class="iconfont icon-play-fill"></span>
<script src="built.js"></script>
6. devServer
- 开发服务器 devServer:自动化(自动编译,自动打开浏览器,自动刷新浏览器)
- 特点:只会在内存中编译打包,不会有任何输出
- 启动指令:npx webpack-dev-server 要下载webpack-dev-server包
- 启动后在浏览器输入 localhost:端口号即可访问
在配置文件中增加下面的对象
mode: "development",
devServer: {
// 构建后的项目路径
contentBase: resolve(__dirname, "build"),
// 启动gzip压缩
compress: true,
// 端口号
port: 12800,
// 自动打开浏览器
open: true,
},
7. 开发环境基本配置
webpack.config.js
const { resolve } = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");
module.exports = {
entry: "./src/js/index.js",
output: {
filename: "js/built.js",
path: resolve(__dirname, "build"),
},
module: {
rules: [
{
// 处理css资源
test: /\.css$/,
use: ["style-loader", "css-loader"],
},
{
// 处理less资源
test: /\.less$/,
use: ["style-loader", "css-loader", "less-loader"],
},
{
// 处理图片资源
test: /\.(jpg|png|gif)$/,
loader: "url-loader",
options: {
limit: 8 * 1024,
esModule: false,
name: "[hash:10].[ext]",
outputPath: "imgs",
},
},
{
// 处理html中的img资源
test: /\.html$/,
loader: "html-loader",
},
{
// 处理其他资源
exclude: /\.(css|js|html|less|jpg|png|gif)$/,
loader: "file-loader",
options: {
name: "[hash:10].[ext]",
outputPath: "media",
},
},
],
},
plugins: [
new HtmlWebpackPlugin({
template: "./src/index.html",
}),
],
mode: "development",
devServer: {
contentBase: resolve(__dirname, "build"),
compress: true,
port: 12800,
open: true,
},
};
配置时要注意文件路径
补充
1. clean-webpack-plugin
默认情况下,webpack是用新打包的文件替换以前打包的文件。使用该插件,可以先将以前打包的文件删除,再放入新打包的文件
const { CleanWebpackPlugin } = require("clean-webpack-plugin");
plugins: [
new CleanWebpackPlugin(),
],
2. 打包 ts 资源
{
test: /\.ts$/,
use: ["ts-loader"],
exclude: /node_modules/,
},
关于版本问题包的版本可以参考 https://blog.csdn.net/Alice_Lee_Lee/article/details/122481482