1. webpack 中的插件
1.1. 什么是 webpack 概念:webpack 是前端项目工程化的具体解决方案。
主要功能:它提供了友好的前端模块化开发支持,以及代码压缩混淆、处理浏览器端 JavaScript 的兼容性、性能优化等强大的功能。
好处:让程序员把工作的重心放到具体功能的实现上,提高了前端开发效率和项目的可维护性。 注意:目前Vue,React 等前端项目,基本上都是基于webpack 进行工程化开发的。
1.2. 创建列表隔行变色项目 ① 新建项目空白目录,并运行npm init –y 命令,初始化包管理配置文件package.json
② 新建 src 源代码目录
③ 新建 src -> index.html 首页和 src -> index.js 脚本文件
④ 初始化首页基本的结构
⑤ 运行npm install jquery –S 命令,安装 jQuery
⑥ 通过 ES6 模块化的方式导入 jQuery,实现列表隔行变色效果
1.3. 在项目中安装 webpack 在终端运行如下的命令,安装webpack 相关的两个包:
npm install webpack@5.42.1 webpack-cli@4.7.2 –D
-s是--save的简写
-D是--save-dev的简写
1.4. 在项目中配置 webpack ① 在项目根目录中,创建名为 webpack.config.js 的 webpack 配置文件,并初始化如下的基本配置:(Development是开发时设定;production是产品发布时设定)
文章图片
② 在 package.json 的 scripts 节点下,新增 dev 脚本如下:
文章图片
③ 在终端中运行npm run dev 命令,启动webpack 进行项目的打包构建
1.4.1mode 的可选值
mode 节点的可选值有两个,分别是:
①development
开发环境 不会 对打包生成的文 件 进 行 代 码压 缩 和 性 能优化 打包 速度快 ,适合在 开 发阶 段 使用 ②production
生产环境 会 对打包生成的文件 进 行 代 码 压 缩 和 性 能 优化 打包 速度很慢 ,仅适 合 在项 目 发布 阶 段 使用
1.4.2 webpack.config.js 文件的作用
webpack.config.js 是 webpack 的配置文件。webpack 在真正开始打包构建之前,会先读取这个配置文件,从而基于给定的配置,对项目进行打包。
注意:由于 webpack 是基于 node.js 开发出来的打包工具,因此在它的配置文件中,支持使用 node.js 相关的语法和模块进行webpack 的个性化配置。
1.4.3 webpack 中的默认约定
在 webpack 4.x 和 5.x 的版本中,有如下的默认约定:
① 默认的打包入口文件为 src -> index.js
【前端工程化与Webpack|Webpack】② 默认的输出文件路径为dist -> main.js
注意:可以在webpack.config.js 中修改打包的默认约定
1.4.4 自定义打包的入口与出口
在 webpack.config.js 配置文件中,通过entry 节点指定打包的入口。通过output 节点指定打包的出口。 示例代码如下:
文章图片
2. webpack 中的插件
2.1.webpack 插件的作用 通过安装和配置第三方的插件,可以拓展webpack 的能力,从而让webpack 用起来更方便。最常用的webpack 插件有如下两个:
①webpack-dev-server
类似 于 node.js 阶段用到 的 nodemon 工具 每当修改了源代码 ,webpack 会自动进行项目的打包 和 构建 ②html-webpack-plugin
webpack 中 的 HTML 插件(类似于一个模 板 引擎 插 件) 可以通过此插件自定制 index.html 页面的内容 2.2. webpack-dev-server webpack-dev-server 可以让webpack 监听项目源代码的变化,从而进行自动打包构建。
2.2.1 安装 webpack-dev-server
运行如下的命令,即可在项目中安装此插件:
npm install webpack-dev-server@3.11.2 -D
2.2.2 配置 webpack-dev-server
① 修改package.json -> scripts 中的dev 命令如下:
文章图片
② 再次运行npm run dev 命令,重新进行项目的打包
③ 在浏览器中访问http://localhost:8080 地址,查看自动打包效果
注意:webpack-dev-server 会启动一个实时打包的http 服务器
2.2.3.打包生成的文件哪儿去了?
① 不配置webpack-dev-server 的情况下,webpack 打包生成的文件,会存放到实际的物理磁盘上
严格遵守开发者 在 webpack.config.js 中指定配置 根 据 output 节点 指定路径进行存放 ② 配置了 webpack-dev-server 之后,打包生成的文件存放到了内存中
不再根 据 output 节点指定的路径,存放 到 实 际 的物 理 磁盘上 提高 了 实时打包输出 的 性能 , 因 为 内 存 比 物 理 磁 盘 速 度 快 很 多
2.2.4. 生成到内存中的文件该如何访问?
webpack-dev-server 生成到内存中的文件,默认放到了项目的根目录中,而且是虚拟的、不可见的。
可以直接 用 / 表示 项目根目 录 , 后 面 跟 上 要 访 问 的 文 件 名 称 , 即 可 访 问 内 存 中 的 文 件 例 如 /bundle.js 就表示要访 问 webpack-dev-server 生成到内存中 的 bundle.js 文件 2.3. html-webpack-plugin html-webpack-plugin 是 webpack 中的HTML 插件,可以通过此插件自定制 index.html 页面的内容。 需求:通过html-webpack-plugin 插件,将 src 目录下的 index.html 首页,复制到项目根目录中一份!
2.3.1 安装 html-webpack-plugin
运行如下的命令,即可在项目中安装此插件:
npm install html-webpack-plugin@5.3.2 -D
2.3.2 配置 html-webpack-plugin
文章图片
2.3.3 解惑 html-webpack-plugin
① 通过HTML 插件复制到项目根目录中的 index.html 页面,也被放到了内存中
② HTML 插件在生成的 index.html 页面,自动注入了打包的bundle.js 文件
2.4. devServer 节点 在 webpack.config.js 配置文件中,可以通过devServer 节点对webpack-dev-server 插件进行更多的配置,示例代码如下:
文章图片
注意:凡是修改了 webpack.config.js 配置文件,或修改了 package.json 配置文件,必须重启实时打包的服务器,否则最新的配置文件无法生效!
3. webpack 中的 loader
3.1. loader 概述 在实际开发过程中,webpack 默认只能打包处理以.js 后缀名结尾的模块。其他非.js 后缀名结尾的模块,webpack 默认处理不了,需要调用 loader 加载器才可以正常打包,否则会报错!
loader 加载器的作用:协助 webpack 打包处理特定的文件模块。比如:
css-loader 可以打包处 理 .css 相关的文件 less-loader 可以打包处 理 .less 相关的文件 babel-loader 可以打包处 理 webpack 无法处理的高级 JS 语法 3.2. loader 的调用过程
文章图片
3.3. 打包处理 css 文件 ① 运行npm i style-loader@3.0.0 css-loader@5.2.6 -D 命令,安装处理css 文件的 loader
② 在 webpack.config.js 的module -> rules 数组中,添加 loader 规则如下:
文章图片
其中,test 表示匹配的文件类型, use 表示对应要调用的 loader
注意:
use 数组中指定的 loader 顺序是固定的 多个 loader 的调用顺序是: 从后 往 前 调 用
3.4. 打包处理 less 文件 ① 运行npm i less-loader@10.0.1 less@4.1.1 -D 命令
② 在 webpack.config.js 的module -> rules 数组中,添加 loader 规则如下:
文章图片
3.5. 打包处理样式表中与 url 路径相关的文件 ① 运行npm i url-loader@4.1.1 file-loader@6.2.0 -D 命令
② 在 webpack.config.js 的module -> rules 数组中,添加 loader 规则如下:
文章图片
其中? 之后的是 loader 的参数项:
limit 用来指定 图片的大 小 ,单 位 是 字 节 (byte) 只 有 ≤limit 大小的图片,才会被转 为 base64 格式的图片 3.6. 打包处理 js 文件中的高级语法 webpack 只能打包处理一部分高级的 JavaScript 语法。对于那些webpack 无法处理的高级 js 语法,需要借 助于babel-loader 进行打包处理。例如webpack 无法处理下面的 JavaScript 代码:
文章图片
3.6.1 安装 babel-loader 相关的包
运行如下的命令安装对应的依赖包:
npm i babel-loader@8.2.2 @babel/core@7.14.6 @babel/plugin-proposal-decorators@7.14.5 -D
在 webpack.config.js 的 module -> rules 数组中,添加 loader 规则如下:
文章图片
3.6.2 配置 babel-loader
在项目根目录下,创建名为 babel.config.js 的配置文件,定义 Babel 的配置项如下:
文章图片
详情请参考Babel 的官网https://babeljs.io/docs/en/babel-plugin-proposal-decorators
https://babeljs.io/docs/en/babel-plugin-proposal-decorators
文章图片
https://babeljs.io/docs/en/babel-plugin-proposal-decorators
4. 打包发布
4.1. 为什么要打包发布 项目开发完成之后,需要使用webpack 对项目进行打包发布,主要原因有以下两点:
① 开发环境下,打包生成的文件存放于内存中,无法获取到最终打包生成的文件
② 开发环境下,打包生成的文件不会进行代码压缩和性能优化
为了让项目能够在生产环境中高性能的运行,因此需要对项目进行打包发布。
4.2. 配置 webpack 的打包发布 在 package.json 文件的 scripts 节点下,新增build 命令如下:
文章图片
--model 是一个参数项,用来指定webpack 的运行模式。production 代表生产环境,会对打包生成的文件 进行代码压缩和性能优化。
注意:通过 --model 指定的参数项,会覆盖webpack.config.js 中的model 选项。
4.3. 把 JavaScript 文件统一生成到 js 目录中 在 webpack.config.js 配置文件的output 节点中,进行如下的配置:
文章图片
4.4. 把图片文件统一生成到 image 目录中 修改webpack.config.js 中的 url-loader 配置项,新增outputPath 选项即可指定图片文件的输出路径:
文章图片
文章图片
4.5. 自动清理 dist 目录下的旧文件 webpack5.2以上版本,可以在output里面加上clean:true选项,就可以实现这个插件的功能了
为了在每次打包发布时自动清理掉dist 目录中的旧文件,可以安装并配置clean-webpack-plugin 插件:
文章图片
5. Source Map
5.1. 生产环境遇到的问题 前端项目在投入生产环境之前,都需要对 JavaScript 源代码进行压缩混淆,从而减小文件的体积,提高文件的 加载效率。此时就不可避免的产生了另一个问题:
对压缩混淆之后的代码除错(debug)是一件极其困难的事情
文章图片
变量被替换成 没有任 何 语 义 的 名称 空行和注释被剔除
5.2. 什么是 Source Map Source Map 就是一个信息文件,里面储存着位置信息。也就是说,Source Map 文件中存储着压缩混淆后的 代码,所对应的转换前的位置。
有了它,出错的时候,除错工具将直接显示原始代码,而不是转换后的代码,能够极大的方便后期的调试。
5.3. webpack 开发环境下的 Source Map 在开发环境下,webpack 默认启用了 Source Map 功能。当程序运行出错时,可以直接在控制台提示错误行 的位置,并定位到具体的源代码:
文章图片
5.3.1 默认 Source Map 的问题
开发环境下默认生成的 Source Map,记录的是生成后的代码的位置。会导致运行时报错的行数与源代码的行 数不一致的问题。示意图如下:
文章图片
5.3.2 解决默认 Source Map 的问题
开发环境下,推荐在webpack.config.js 中添加如下的配置,即可保证运行时报错的行数与源代码的行数 保持一致:
文章图片
5.4. webpack 生产环境下的 Source Map 在生产环境下,如果省略了devtool 选项,则最终生成的文件中不包含 Source Map。这能够防止原始代码通 过 Source Map 的形式暴露给别有所图之人。
文章图片
5.4.1 只定位行数不暴露源码
在生产环境下,如果只想定位报错的具体行数,且不想暴露源码。此时可以将 devtool 的值设置为
nosources-source-map。实际效果如图所示:
文章图片
5.4.2 定位行数且暴露源码(实际开发中,为了安全性不推荐,也不要用)
在生产环境下,如果想在定位报错行数的同时,展示具体报错的源码。此时可以将devtool 的值设置为source-map。实际效果如图所示:
文章图片
采用此选项后:你应该将你的服务器配置为,不允许普通用户访问 source map 文件!
5.5.Source Map 的最佳实践 ① 开发环境下:
建议 把 devtool 的值设置 为 eval-source-map 好处:可以精准定位 到 具体 的 错 误 行 ② 生产环境下:
建议 关闭 Source Map 或 将 devtool 的值设置 为 nosources-source-map 好处:防止源码泄露 , 提高 网 站 的 安全性
5.6. Webpack中@的原理和好处 先在webpack文件中配置@指向
resolve: {
alias: {
// 告诉 webpack,程序员写的代码中,@ 符号表示 src 这一层目录
'@': path.join(__dirname, './src/')
}
}
在js文件中进行@的使用
// import msg from '../../msg'
import msg from '@/msg.js'
// 建议大家使用 @ 表示 src 源代码目录,从外往里查找;不要使用 ../ 从里往外查找
//@/msg.js
console.log(msg)
@在使用之前,要自己在webpack文件中配置好,才可以使用,已经配置好,无需再进行配置
总结
6. 实际开发中需要自己配置 webpack 吗? 答案:不需要!
实际开发中会使命令行工具(俗称 CLI)一键生成带有 webpack 的项目
开箱即用,所有 webpack 配置项都是现成的!
我们只需要知道 webpack 中的基本概念即可!
文章图片
推荐阅读
- 前端|vite-plugin-mock使用
- IntelliJ|Vue学习笔记(狂神)
- vue.js|狂神说 Vue 笔记
- 对Indexlookup的理解误区
- Java如何使用TreeMap(解析和用法示例)
- C++如何使用STL中的map find()函数(示例)
- Angular CLI | Angular项目部署详细指南
- 在std::map中插入元素(插入,插入和运算符[])
- 前端优秀开源项目|xgplayer.js 西瓜播放器 - 字节跳动团队出品的免费开源 HTML5 视频播放组件,内置解析器、也能节省流量