前言
大家好,我是Frank。相信大家都对webpack不陌生,今天我们一起来学习下webpack该怎么用。
webpack5.x已经在今年10.1国庆期间发布上线,但是考虑到不稳定性,和生态插件的更新,所以本次分享仍以webpack4.x版本为主。(webpack@4.43.0,webpack-cli@3.3.12,webpack-dev-server:@3.11.0)
webpack入门
1.webpack简介
Webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler),当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。
Webpack是一个打包模块化JavaScript的工具,它会从入口模块出发,识别出源码中的模块化导入语句,递归地找出入口文件的所有依赖,将入口和其所有的依赖打包到一个单独的文件中
是工程化、自动化思想在前端开发中的体现。
2.webpack 安装
环境准备
nodeJs :https://nodejs.org/en/
版本参考官网发布的最新版本,可以提升webpack的打包速度
安装方式
局部安装(推荐)
npm init -y # 初始化npm配置文件
npm install --save-dev webpack # 安装核心库
npm install --save-dev webpack-cli # 安装命令行工具
# 安装最新的4.x稳定版本
npm i -D webpack@4.44.0
# 安装指定版本
npm i -D webpack@<version>
全局安装(不推荐)
# 安装webpack V4+版本时,需要额外安装webpack-cli
npm install webpack webpack-cli -g
# 检查版本
webpack -v
# 卸载
npm uninstall webpack webpack-cli -g
全局安装webpack,这会将你项目中的webpack锁定到指定版本,造成不同的项目中因为webpack依赖不同版本而导致冲突,构建失败
3.启动webpack
3.1- webpack默认配置
- webpack默认支持JS模块和JSON模块
- 支持CommonJS Es moudule AMD等模块类型
- webpack4支持零配置使用,但是很弱,稍微复杂些的场景都需要额外扩展
3.2- 准备执行构建
- 新建src文件夹
- 新建src/index.js、src/index.json、src/other.js
### index.js
const json = require("./index.json");//commonJS
import { add } from "./other.js";//es module
console.log(json, add(2, 3));
### index.json
{
"name": "JOSN"
}
### other.js
export function add(n1, n2) {
return n1 + n2;
}
3.3- 执行构建
# npx方式
npx webpack
# npm script
npm run test
修改package.json文件:
"scripts": {
"test": "webpack"
},
原理就是通过shell脚本在node_modules/.bin目录下创建一个软链接。
3.4-构建成功
我们会发现目录下多出一个dist目录,里面有个main.js,这个文件是一个可执行的JavaScript文件,里面包含webpackBootstrap启动函数。
3.5-默认配置
const path = require("path");
module.exports = {
// 必填 webpack执行构建入口
entry: "./src/index.js",
output: {
// 将所有依赖的模块合并输出到main.js
filename: "main.js",
// 输出文件的存放路径,必须是绝对路径
path: path.resolve(__dirname, "./dist")
}
};
4.webpack配置核心概念 - 重要
- chunk:指代码块,一个 chunk 可能由多个模块组合而成,也用于代码合并与分割。
- bundle:资源经过Webpack 流程解析编译后最终输出的成果文件。
- entry:顾名思义,就是入口起点,用来告诉webpack用哪个文件作为构建依赖图的起点。webpack会根据entry递归的去寻找依赖,每个依赖都将被它处理,最后输出到打包成果中。
- output:output配置描述了webpack打包的输出配置,包含输出文件的命名、位置等信息。
- loader:默认情况下,webpack仅支持
.js .json文件,通过loader,可以让它解析其他类型的文件,充当翻译官的角色。理论上只要有相应的loader,就可以处理任何类型的文件。 - plugin:loader主要的职责是让webpack认识更多的文件类型,而plugin的职责则是让其可以控制构建流程,从而执行一些特殊的任务。插件的功能非常强大,可以完成各种各样的任务。
- mode:4.0开始,webpack支持零配置,旨在为开发人员减少上手难度,同时加入了mode的概念,用于指定打包的目标环境,以便在打包的过程中启用webpack针对不同的环境下内置的优化。。
零配置
零配置是很弱的,特定的需求,总是需要自己进行配置
webpack有默认的配置文件,叫webpack.config.js,我们可以对这个文件进行修改,进行个性化配置
- 使用默认的配置文件:webpack.config.js
- 不使用自定义配置文件: 比如webpack.config.js,可以通过--config webpack.config.js来指定webpack使用哪个配置文件来执行构建
webpack.config.js配置基础结构
module.exports = {
entry: "./src/index.js", //打包入口文件
output: "./dist", //输出结构
mode: "production", //打包环境
module: {
rules: [
//loader模块处理
{
test: /\.css$/,
use: "style-loader"
}
]
},
plugins: [new HtmlWebpackPlugin()] //插件配置
};
4.1-entry:
指定webpack打包入口文件:Webpack 执行构建的第一步将从 Entry 开始,可抽象成输入
//单入口 SPA,本质是个字符串
entry:{
main: './src/index.js'
}
// ==相当于简写===
entry:"./src/index.js"
//多入口 entry是个对象
entry:{
index:"./src/index.js",
login:"./src/login.js"
}
4.2-output:
打包转换后的文件输出到磁盘位置:输出结果,在 Webpack 经过一系列处理并得出最终想要的代码后输出结果。
output: {
filename: "bundle.js",//输出文件的名称
path: path.resolve(__dirname, "dist")//输出文件到磁盘的目录,必须是绝对路径
},
//多入口的处理
output: {
filename: "[name][chunkhash:8].js",//利用占位符,文件名称不要重复
path: path.resolve(__dirname, "dist")//输出文件到磁盘的目录,必须是绝对路径
},
这里补充一下hash、chunkhash、contenthash的区别:
hash:文件中任何改动都会生成新的hash值chunkhash:与chunk文件产生依赖的文件发生改变的时候会生成新的hash,多用于多页面打包contenthash:当文件内容发生改变时生成新的hash,通常项目中会用MiniCssExtractPlugin来将css单独打包,此时我们可以通过设置contenthash来达到只对修改的文件生成新的hash值
4.3-mode
Mode用来指定当前的构建环境
- production
- development
- none
设置mode可以自动触发webpack内置的函数,达到优化的效果
开发阶段的开启会有利于热更新的处理,识别哪个模块变化
生产阶段的开启会有帮助模块压缩,处理副作用等一些功能
4.4-loader
模块解析,模块转换器,用于把模块原内容按照需求转换成新内容。
webpack是模块打包工具,而模块不仅仅是js,还可以是css,图片或者其他格式
但是webpack默认只知道如何处理js和JSON模块,那么其他格式的模块处理,和处理方式就需要loader了
常见的loader
style-loader
css-loader
less-loader
sass-loader
ts-loader //将Ts转换成js
babel-loader//转换ES6、7等js新特性语法
file-loader//处理图片子图
eslint-loader
...
4.5-module
模块,在 Webpack 里一切皆模块,一个模块对应着一个文件。Webpack 会从配置的 Entry 开始递归找出所有依赖的模块。
当webpack处理到不认识的模块时,需要在webpack中的module处进行配置,当检测到是什么格式的模块,使用什么loader来处理。
module:{
rules:[
{
test:/\.xxx$/,//指定匹配规则
use:{
loader: 'xxx-load'//指定使用的loader
}
}
]
}
案例:样式处理:
css-loader 分析css模块之间的关系,并合成一个css
Style-loader 会把css-loader生成的内容,以style挂载到页面的heade部分
npm install style-loader css-loader -D
{
test: /\.css$/,
use: ["style-loader", "css-loader"]
}
后记
好了,今天的分享到这里。下一篇我们将具体介绍项目中常用的loader、plugins以及他们的配置细则,希望大家学有所获,下期再见~
本文使用 mdnice 排版