webpack的学习
尚硅谷2020最新版Webpack5实战教程(从入门到精通),哔哩哔哩链接:https://www.bilibili.com/video/BV1e7411j7T5?p=1
环境参数: Nodejs 10版本以上、webpack 4.26版本以上
预备技能: 基本Nodejs知识和Npm指令、熟悉ES6语法
一、webpack基本使用
1.webpack简介
webpack
是一种前端资源构建工具,一个静态模块打包器(module bundler
)。 在 webpack 看来, 前端的所有资源文件
(js/json/css/img/less/...
)都会作为模块处理。 它将根据模块的依赖关系进行静态分析,打包生成对应的静态资源(bundle
)。
2.webpack五个核心概念
1 Entry
入口(Entry
)指示 webpack 以哪个文件为入口起点开始打包,分析构建内部依赖图。例如从index.js
这个起点出发
2 Output
输出(Output
)指示 webpack 打包后的资源 bundles 输出到哪里去,以及如何命名。
3 Loader
Loader
让 webpack 能 够 去 处 理 那 些 非 JavaScript 文 件 (webpack 自 身 只 理 解 JavaScript
),例如css、img
4 Plugins
插件(Plugins
)可以用于执行范围更广的任务。插件的范围包括,从打包优化和压缩, 一直到重新定义环境中的变量等。
5 Mode
3.webpack初体验
1.在vscode
中新建一个文件夹,右键在终端中打开
2.输入 npm init
,初始化npm,
3.接着输入webpack的包名
,其他按enter默认即可
4.然后下载包并指定为全局安装,输入
npm i webpack webpack-cli -g
这里下载了两个包,一个为webpack
,一个为webpack-cli
,使我们通过webpack-cli这个包的指令去使用webpack内部的功能,-g
表示全局安装,将来可以直接通过指令去调用这两个包。这里即使你已经安装过这两个包,也可以再次输入,他会自动覆盖旧的包
5.然后本地安装,输入 ,
npm i webpack webpack-cli -D
-D
的意思是将webpack添加到开发依赖,webpack下载的所有东西都属于开发依赖,不属于生产依赖
6.之后新建的文件夹会出现以下的三个文件
7.接着在自己建的文件夹下新建src
和bulid
文件夹,src表示源代码,bulid表示代码通过webpack打包处理之后输出的目录
8.在src下新建index.js
作为webpack的入口起点文件
index.js
/*
index.js: webpack入口起点文件
1. 运行指令:
开发环境:webpack ./src/index.js -o ./build/built.js --mode=development
webpack会以 ./src/index.js 为入口文件开始打包,打包后输出到 ./build/built.js
整体打包环境,是开发环境
生产环境:webpack ./src/index.js -o ./build/built.js --mode=production
webpack会以 ./src/index.js 为入口文件开始打包,打包后输出到 ./build/built.js
整体打包环境,是生产环境,生产环境会压缩代码
2. 结论:
1. webpack能处理js/json资源,不能处理css/img等其他资源
2. 生产环境和开发环境将ES6模块化编译成浏览器能识别的模块化~
3. 生产环境比开发环境多一个压缩js代码。
*/
// import './index.css';
import data from './data.json';
console.log(data);
function add(x, y) {
return x + y;
}
console.log(add(1, 2));
data.json
{
"name": "jack",
"age": 18
}
9.然后运行开发环境指令 ,
webpack ./src/index.js -o ./build/built.js --mode=development
-o
为Output,意思是输出到.build/built.js
这个路径。
Hash
为每次打包都会生成一个唯一的哈希值,built.js
为打包资源
10.通过 node .\build\built.js
指令便可直接运行built.js文件
11.在html中引入webpack打包后的资源
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
<!-- 引入webpack打包后的资源 -->
<script src="./build/built.js"></script>
</head>
<body>
</body>
</html>
结果如下:
二、webpack开发环境配置
1.打包样式(css、less)资源
因为webpack只能识别js
文件,所以要想识别其他文件必须在webpack的配置文件里进行配置,将其转换为js。
1.新建index.css、index.js、index.less、webpack.config.js
配置文件
index.css
html, body{
margin: 0;
padding: 0;
height: 100%;
background-color: pink;
}
index.js
// 引入样式资源
import './index.css';
import './index.less';
index.less
#title {
color: #fff;
}
webpack.config.js
/*
webpack.config.js webpack的配置文件
作用: 指示 webpack 干哪些活(当你运行 webpack 指令时,会加载里面的配置)
所有构建工具都是基于node.js平台运行的~模块化默认采用commonjs。
*/
// resolve用来拼接绝对路径的方法
const {
resolve } = require('path');
module.exports = {
// webpack配置
// 入口起点
entry: './src/index.js',
// 输出
output: {
// 输出文件名
filename: 'built.js',
// 输出路径
// __dirname 为node.js的变量,代表当前文件的目录绝对路径,即代表“03.打包样式资源”这个路径,
//后面的“build”表示这个目录下的build路径
path: resolve(__dirname, 'build')
},
// loader的配置
module: {
rules: [
// 详细loader配置
// 不同文件必须配置不同loader处理
{
// 匹配哪些文件
test: /\.css$/,
// 使用哪些loader进行处理
use: [
// 注意,use数组中loader执行顺序:从右到左,从下到上 依次执行
// 创建style标签,将js中的样式资源插入进行,添加到head中生效
'style-loader',
// 将css文件变成commonjs模块加载js中,里面内容是样式字符串
'css-loader'
]
},
{
test: /\.less$/,
use: [
// 创建style标签,将js中的样式资源插入进行,添加到head中生效
'style-loader',
// // 将css文件变成commonjs模块加载js中,里面内容是样式字符串
'css-loader',
// 将less文件编译成css文件,需要下载 less-loader和less
'less-loader'
]
}
]
},
// plugins的配置
plugins: [
// 详细plugins的配置
],
// 模式
mode: 'development', // 开发模式
// mode: 'production' 生产模式
}
2.为了防止我们每新建一个案例就导一次包,我们可以利用node找包找不到,去上一级找的特点
直接给整个项目导入包,我们输入
npm i webpack webpack-cli -D
再输入
npm i css-loader style-loader less less-loader -D
这里下载了4个包,css-loader
和style-loader
为css样式打包所要用到的,还有less
(这里less不下载也可以)和less-loader
为将less文件转换为css所需要的
3.之后输入webpack
或者webpack ./src/index.js -o ./build/built.js --mode=development
进行打包
4.新建index.html
文件引入打包好的js文件,查看效果是否实现
index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
</head>
<script src="./build/built.js"></script>
<body>
<h1 id="title">111</h1>
</body>
</html>
2.打包html资源
1.对新建的项目(打包html)进行npm init
,配置好信息后自动生成package.json、package-lock.json 和node-modules
这三个文件,之后新建index.js
打包入口文件、webpack.config.js
配置文件,
index.js
function add(x, y) {
return x + y;
}
console.log(add(2, 3));
webpack.config.js
/*
loader: 1. 下载 2. 使用(配置loader)
plugins: 1. 下载 2. 引入 3. 使用
*/
const {
resolve } = require('path');
// 引入下载的 html-webpack-plugin 这个插件
const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
entry: './src/index.js',
output: {
filename: 'built.js',
path: resolve(__dirname, 'build')
},
module: {
rules: [
// loader的配置
]
},
plugins: [
// plugins的配置,打包html需要 html-webpack-plugin 这个包
/* new HtmlWebpackPlugin()功能:默认会创建一个空的HTML,自动引入打包输出的所有资源(JS/CSS),
所以我们可以在里面加入 template: './src/index.html' 这样就会将我们的html引入它创建出来的html当中
*/
// 需求:需要有结构的HTML文件
new HtmlWebpackPlugin({
// 复制 './src/index.html' 文件,并自动引入打包输出的所有资源(JS/CSS)
template: './src/index.html'
})
],
mode: 'development'
};
2.然后把这个案例右键在终端打开下载html-webpack-plugin
这个包,输入
npm i html-webpack-plugin -D
3.再输入webpack
进行打包
3.打包图片资源
1.对新建的项目(打包图片资源)进行npm init
,配置好信息后自动生成package.json、package-lock.json 和node-modules
这三个文件,之后新建index.js
打包入口文件、webpack.config.js
配置文件、index.less
、index.html
index.js
import './index.less';
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.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>webpack</title>
</head>
<body>
<div id="box1"></div>
<div id="box2"></div>
<div id="box3"></div>
<img src="./angular.jpg" alt="angular">
</body>
</html>
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$/,
// 要使用多个loader处理用use
use: ['style-loader', 'css-loader', 'less-loader']
},
{
// 问题:默认处理不了html中img图片
// 处理图片资源
test: /\.(jpg|png|gif)$/,
// 使用一个loader
// 下载 url-loader和file-loader,因为url-loader依赖file-loader
loader: 'url-loader',
options: {
// 图片大小小于8kb,就会被base64处理,这里的数字随便自己写
// 优点: 减少请求数量(减轻服务器压力)
// 缺点:图片体积会更大(文件请求速度更慢)
limit: 8 * 1024,
// 问题:因为url-loader默认使用es6模块化解析,而html-loader引入图片是commonjs
// 解析时会出问题:[object Module],即在html中的引入的图片src值会
// 变为<img src="[object Module]" alt="angular">
// 解决:关闭url-loader的es6模块化,使用commonjs解析,新版webpack已解决这个问题
esModule: false,
// 给图片进行重命名,如果不重命名的话图片默认使用生成的哈希值进行命名,导致图片名字过长,影响加载速度
// [hash:10]取图片的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'
};
结构目录如下:注意vue.jpg
图片由于大小小于8k,已被默认转换为base64
的图片编码显示,
2.右键在终端打开,输入
npm i style-loader css-loader less-loader url-loader file-loader html-loader -D
style-loader
和css-loader
为css样式表所需要的,
style-loader
和css-loader
和less-loader
为less所需要的,
url-loader
依赖file-loader
,为less或css中导入background-image: url('./react.png');
这个图片所需要的,
html-loader
为html中引入图片所需要的
3.再输入webpack
进行打包,打包好后bulit.js
引入的html文件如下
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>webpack</title>
</head>
<body>
<div id="box1"></div>
<div id="box2"></div>
<div id="box3"></div>
//src值为自定义重命名的哈希值的前十位+后缀名
<img src="830bf3c820.jpg" alt="angular">
<script type="text/javascript" src="built.js"></script></body>
</html>
4.打包其他资源(字体图标等等)
目录结构:
index.js
// 引入 iconfont 样式文件
import './iconfont.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: /\.css$/,
use: ['style-loader', 'css-loader']
},
// 打包其他资源(除了html/js/css资源以外的资源)
{
// 排除css/js/html资源
exclude: /\.(css|js|html|less)$/,
loader: 'file-loader',
options: {
name: '[hash:10].[ext]'
}
}
]
},
plugins: [
new HtmlWebpackPlugin({
template: './src/index.html'
})
],
mode: 'development'
};
index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>webpack</title>
</head>
<body>
<span class="iconfont icon-icon-test"></span>
<span class="iconfont icon-icon-test2"></span>
<span class="iconfont icon-icon-test3"></span>
<span class="iconfont icon-icon-test1"></span>
</body>
</html>
打包好后bulit.js
引入的index.html,查看效果
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>webpack</title>
</head>
<body>
<span class="iconfont icon-icon-test"></span>
<span class="iconfont icon-icon-test2"></span>
<span class="iconfont icon-icon-test3"></span>
<span class="iconfont icon-icon-test1"></span>
<script type="text/javascript" src="built.js"></script></body>
</html>
5.devServer
需要先下载webpack-dev-server
这个包,输入npm i webpack-dev-server -D
启动devServer指令为:npx webpack-dev-server
停止devServer指令:快捷键ctrl+c
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: /\.css$/,
use: ['style-loader', 'css-loader']
},
// 打包其他资源(除了html/js/css资源以外的资源)
{
// 排除css/js/html资源
exclude: /\.(css|js|html|less)$/,
loader: 'file-loader',
options: {
name: '[hash:10].[ext]'
}
}
]
},
plugins: [
new HtmlWebpackPlugin({
template: './src/index.html'
})
],
mode: 'development',
// 开发服务器 devServer:用来自动化(自动编译,自动打开浏览器,自动刷新浏览器~~)
// 特点:只会在内存中编译打包,不会有任何输出,即不会更新(改变)bulid打包文件夹中的文件,
// 即使把bulid删掉也能照样显示
// 启动devServer指令为:npx webpack-dev-server
devServer: {
// 项目构建后路径
contentBase: resolve(__dirname, 'build'),
// 启动gzip压缩
compress: true,
// 端口号,即在浏览器中输入http://localhost:3000/ 即可访问
port: 3000,
// 自动打开浏览器 即输入npx webpack-dev-server后自动打开浏览器
open: true
}
};
6.开发环境基本配置
webpack.config.js
/*
开发环境配置:能让代码运行
运行项目指令:
webpack 会将打包结果输出出去
npx webpack-dev-server 只会在内存中编译打包,没有输出
*/
const {
resolve } = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
// 引入一个对象
module.exports = {
// 入口
entry: './src/js/index.js',
// 输出
output: {
// 文件名
filename: 'js/built.js',
/*
输出的文件路径,一般是一个绝对路劲,而绝对路径一般需要引入一个node.js的核心模块path,
path的方法叫resolve方法,用来处理绝对路径
__dirname 为node.js的变量,代表当前文件的目录绝对路径,即代表“开发环境配置”这个路径,
后面的“build”表示这个目录下的build路径
*/
path: resolve(__dirname, 'build')
},
module: {
rules: [
// loader的配置
{
// 处理less资源,less和css会一起输出到bulit.js文件当中
test: /\.less$/,
use: ['style-loader', 'css-loader', 'less-loader']
},
{
// 处理css资源
test: /\.css$/,
use: ['style-loader', 'css-loader']
},
{
// 处理(css、less)图片资源
test: /\.(jpg|png|gif)$/,
// url-loader通过es6-modules解析
loader: 'url-loader',
options: {
limit: 8 * 1024,
name: '[hash:10].[ext]',
// 关闭es6模块化,使用commonjs解析,这是为了防止模块不一样导致解析失败,新版webpack已解决这个问题
esModule: false,
// 将图片输出到imgs下
outputPath: 'imgs'
}
},
{
// 处理html中img资源,html-loader通过commonjs解析
test: /\.html$/,
loader: 'html-loader'
},
{
// 处理其他资源
exclude: /\.(html|js|css|less|jpg|png|gif)/,
// url-loader是在file-loader基础上做了详细的优化,多了一个limit的功能,
// 即转为base64的图片格式,file-loader就是原封不动的将资源输出出去
loader: 'file-loader',
options: {
name: '[hash:10].[ext]',
// // 将其他资源输出到media下
outputPath: 'media'
}
}
]
},
// 插件,处理html资源需要插件,插件需要引入才能使用,
// 即上方的const HtmlWebpackPlugin = require('html-webpack-plugin');
plugins: [
// plugins的配置
new HtmlWebpackPlugin({
// 表示以某个文件为模板
template: './src/index.html'
})
],
mode: 'development',
devServer: {
contentBase: resolve(__dirname, 'build'),
compress: true,
port: 3000,
open: true
}
};
打包后引入bulit.js
的index.html文件
<!