VUE框架知识储备（一）——webpack

前端工程化

模块化（js 的模块化、css的模块化、资源的模块化）
组件化（复用现有的UI结构、样式、行为）
规范化（目录结构的划分、编码规范化、文档规范化、Git分支管理）
自动化（自动化构建、自动化部署、自动化测试）

什么是前端工程化

前端工程化指的是：在企业级的前端项目开发中,把前端开发所需的工具、技术、流程、经验等进行规范化、标准化
企业中的Vue项目和React项目，都是基于工程化的方式进行开发的。
好处：前端开发自成体系，有一套有一套标准的开发方案和流程

前端工程化的解决方案：

早期的前端工程化解决方案

grunt(http://www.gruntjs.net/)
gulp(http://wwww.gulpjs.com.cn/)

目前主流的前端工程化解决方案：

webpack(https://www.webpackjs.com/)
parcel(https://zh.parceljs.org/)

webpack的基本使用

什么是webpack

概念webpack是前端项目工程化的具体解决方案。

主要功能：它提供了友好的前端模块化开发支持，以及代码压缩混淆、处理浏览器端JavaScript的兼容性、性能优化等强大功能。

好处：让程序员工作的重心放到具体功能的实现上，同奥了前端开发效率?和项目的可维护性。

目前Vue,React等前端项目，基本上都是基于webpack进行工程化开发的。

在项目中安装jQuery

在项目中安装webpack

在终端运行如下命令，安装webpack相关的两个包：

npm install webpack@5.42.1 webpack-cli@4.7.2 -D

-S是 --save的简写
-D是 --save-dev的简写

在项目中配置webpack

在项目根目录中，创建名为webpack.config.js的webpack配置文件，并初始化如下基本配置：

module.exports = {
    // 代表 webpack 运行模式，可选值有两个  development 和 production
    // 开发一定要用development，因为追求的是打包的速度，而不是体积
    // 反过来，发布上限的时候一定要用production，因为上限最求的是体积小，而不是打包速度块。
    mode:'development'
}

在package.json的script节点下，新增dev脚本如下：

"scripts":{
    "dev":"webpack" // script结点下的脚本，可以通过 npm run dev
}

在终端中运行 npm run dev 命令，启动webpack进行项目的打包构建。
最后在页面导入dist文件夹下的main.js

webpack中的默认约定

在webpack 4.x 和 5.x的版本中，有如下默认约定：

默认的打包入口文件 src -> index.js
默认的输出文件路径为 dist -> main.js

可以在 webpack.config.js 中修改打包的默认约定

webpack.congig.js文件的作用

webpack.config.js 是 webpack的配置文件。webpack在真正开始打包构建之前，会先读取这个配置文件，从而基于给定的配置，对项目进行打包。

有webpack是基于node.js开发出来的打包工具，因此在它的配置文件中，支持使用node.js相关的语法和模块进行webpack的个性化配置。开发出来的打包工具，因此在它的配置文件中，支持使用node.js相关的语法和模块进行webpack的个性化配置。

自定义打包的入口与出口

在 webpack.config.js 配置文件中，通过entry 节点指定打包的入口。通过output节点指定打包的出口。
实例代码如下：

const path = require('path')

module.exports = {
  entry: path.join('__dirname,'./src/index.js'),
  output: {
    path:path.join('__dirname','./dist'),
    filename: 'bundle.js'
  }
}

webpack中的插件

webpack插件的作用

通过暗转和配置第三方的插件，可以拓展webpack的能力，从而让webpack用起来更方便。最常用webpack插件有如下两个：

webpack-dev-server

类似于node.js阶段用到的nodemon工具
每当修改了源代码，webpack会自动进行项目的打包和构建

html-webpack-plugin

webpack中的HTML插件（类似于一个模板引擎插件）
可以通过此插件自定制index.html页面的内容

安装webpack-dev-server

在终端中运行以下命令，即可在项目中安装此插件

npm install webpack-dev-server@3.11.2 -D

配置webpack-dev-server

修改 package.json -> script 中 dev 命令，如下所示：

"script":{
    "dev":"webpack serve" // script节点下的脚本，可以通过npm run执行
}

再次运行npm run dev 命令，重新进行项目的打包
在浏览器中访问 http://localhost:8080 地址，查看自动打包效果。

webpack-dev-server 会启动一个实时打包的http服务器。

webpack 中的 loader

loader 概述

在实现开发过程中，webpack默认只能打包处理以.js后缀名结尾的模块。其他非.js后缀名结尾的模块，webpack 默认处理不了，需要调用loader加载器才可以正常打包，否则会报错！

loader 加载器的作用：协助 webpack打包处理特定的文件模块。比如：

css-loader 可以打包处理.css 相关文件
less-loader 可以打包处理.less 相关的文件
babel-loader 可以打包处理 webpack 无法处理的高级的js语法

graph LR begin(将要被webpack打包<br>处理的文件模块)-->ifjs{是否为js模块} ifjs-->ifhigh{是否包含了<br>高级js语法} ifhigh-->ifbabel{是否配置了<br>babel} ifbabel-->loaderdis2(调用loader处理) ifbabel-->erro2(报错) ifjs-->ifloader{是否配置了<br>对应的loader} ifloader-->loaderdis1(调用 loader 处理) ifloader-->error1(报错)

打包处理css文件

① 运行npm i style-loader@3.0.0 css-loader@5.2.6 -D 命令，安装处理css文件的loader
② 在webpack.config.js 的 module-> rules 数组中，添加loader规则，如下所示：

module:{ // 所有第三方文件模块的匹配规则
    rule:{ // 文件后缀名的匹配规则
        {test:/\.css$/,use:['style-loader','css-loader']}
    }
}

其中，test表示匹配的文件类型，use表示对应要调用的loader

use数组中指定的loader 顺序是固定的多个loader的调用顺序是固定的
多个loader的调用顺序是：从后往前调用

webpack详细执行步骤

webpack默认只能打包处理.js结尾的文件，处了其他后缀名的文件
由于代码中包含了index.css 这个文件，因此webpack默认处理不了
当webpack发现某个文件处理不了的时候，会查找webpack.config.js这个配置文件，看module.rules 数组中，是否配置了对应的loader加载器。
webpack把index.css这个文件，先转交给最后一个loader进行处理（先转交给css-loader）
当css-loader 处理完毕之后，会把处理结果，转交给下一个loader（转交给style-loader）
当 style-loader 处理完毕之后，发现没有下一个loader了，于是就把处理的结果，转交给了webpack
webpack把style-loader处理的结果，合并到/dist/index.js中，最终生成打包好的文件

打包处理less文件

① 运行npm i less-loader@10.0.1 less@4.1.1 -D 命令
② 在webpack.config.js 的module->rules数组中，添加loader规则如下：

module:{ // 所有第三方文件模块的匹配规则
    rules:[ // 文件后缀名的匹配规则
        { test:/\.less/,use:['style-loader','css-loader','less-loader']}
    ]
}

打包处理样式表中与url路径相关的文件

① 运行 npm i url-loader@4.1.1 file-loader@6.2.0 -D命令
② 在webpack.config.js的module->rules 数组中，添加loader规则如下：

module:{
    rules:[
        { test:/\.jpg|png|gif$/,use:'url-loader?limit=22229'}
    ]
}

其中?之后的是loader 的参数项：

limit用来指定图片的大小，单位是字节（byte）
只有≤limit大小的图片，才会被转为base64格式的图片

打包处理js文件中的高级语法

webpack只能打包处理一部分高级的JavaScript语法。对于那些webpack无法处理的高级js语法，需要借助于babel-loader进行打包处理。例如webpack无法处理下面的JavaScript代码：

// 1.定义了名为info的装饰器
function info(target){
    target.info = 'Person info'
}

// 3. 为Person 类应用 info装饰器
@info
class Person{}

// 4.打印 Person 的静态属性 info
console.log(Person.info)

安装 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规则如下：

// 注意：必须使用exclude指定排除项：因为node_modules目录下的第三方包不需要被打包
// 因为第三方包的JS兼容性，不需要程序员关心
{ test:/\.js$/,use:'babel-loader',exclude:/node_modules/ }

配置 babel-loader

在项目根目录下，创建名为babel.config.js配置文件，定义Babel的配置项如下：

module.exports = {
    // 声明 babel 可用的插件
    plugins:[['@babel/plugins-proposal-decorators',{ legacy:true}]]
}

详情参考Babel官网 https://babeljs.io/docs/en/babel-plugin-proposal-decorators

配置 webpack 的打包发布

在 package.json 文件的script节点下，新增build命令如下：

"scripts":{
    "dev":"webpack serve", // 开发环境中，运行 dev 命令
    "build":"webpack --mode production" // 项目发布时，运行 build 命令
}

--model 是一个参数项，用来指定webpack的运行模式。production代表生产环境，会对打包生成的文件进行代码压缩和性能优化。

通过 --model指定的参数项，会覆盖 webpack.config.js中的model选项。

把JavaScript文件统一生成到js目录中

在webpack.config.js配置文件的output节点中，进行如下配置：

output:{
    path:path.join(__dirname,'dist'),
    filename:'js/bundle.js'
}

把图片文件统一生成到image目录中

修改webpack.config.js中的url-loader配置项，新增outputPath选项即可指定图片文件的输出路径：

{
    test:/\.jpg|png|gif$/,
    use:{
        loader:'url-loader',
        options:{
            limit:22228,
            // 明确指定把打包生成的图片，存储到dist目录下的image文件夹中
            outputPath:'image'
        }
    }
}

自动清理dist目录下的旧文件

为了在每次打包发布时自动清理掉dist目录中的旧文件，可以安装并配置clean-webpack-plugin插件

// 安装清理 dist 目录的webpack 插件
npm install clean-webpack-plugin@3.0.0 -D

// 按需导入插件、得到插件的构造函数之后，创建插件的实例对象
const{ CleanWebpackPlugin} = require('clean-webpack-plugin')
const cleanPlugin = new CleanWebpackPlugin()

// 把创建的cleanPlugin 插件实例对象，挂载到plugins 节点中
plugins:[htmlplugin，cleanPlugin] // 挂载插件

Source Map

什么是Source Map

Source Map就是一个信息文件，里面存储这位置信息。也就是说，Source Map文件中存储着压缩混淆后的代码，所对应的转换前的位置。
有了它，出错的时候，除错工具将直接显示原始代码，而不是转化后的代码，能够极大的方便后期的调试。

默认 Source Map 问题

开发环境下默认生成的Source Map，记录的是生成后的代码的位置。会导致运行时报错的行数与源代码的行数不一致的问题。

解决默认Source Map问题

开发环境下，推荐在webpack.config.js中添加如下配置，即可保证运行时报错的行数与源代码的行数保持一致:

module.exports = {
    mode:'development',
    // eval-source-map 仅限在“开发模式”下使用，不建议在“生产模式”下使用。
    // 此选项生成的 Source Map 能够保证“运行时报错的行数”与“源代码的行数”保持一致
    devtool:'eval-source-map'
    // 省略其它配置项...
}

webpack 生产环境下的 Source Map

在生产环境下，如果省略了devtool选项，则最终生成的文件中不包含Source Map。这能够防止原始代码通过Source Map 的形式暴露给别有所图之人。

只定位行数不暴露源码

在生产环境下，如果只想定位拨错的具体行数，且不想暴露源码。此时可以将devtool的值设置为nosources-source-map。

采用此选项后：你应该将你的服务器配置为，不允许普通用户访问source map 文件！

Source Map的最佳实践

①开发环境下：

建议把devtool的值设置为 eval-source-map
好处：可以精准定位到具体的错误行
② 生产环境下：
建议关闭Source Map或将devtool的值设置为nosource-source-map
好处：防止源码泄漏，提高网站安全性

posted @ 2022-06-02 10:07 maplerain 阅读(70) 评论(0) 编辑收藏举报

刷新页面返回顶部

Maplerain

VUE框架知识储备（一）——webpack

前端工程化

什么是前端工程化

前端工程化的解决方案：

早期的前端工程化解决方案

目前主流的前端工程化解决方案：

webpack的基本使用

什么是webpack

在项目中安装jQuery

在项目中安装webpack

在项目中配置webpack

webpack中的默认约定

webpack.congig.js文件的作用

自定义打包的入口与出口

webpack中的插件

webpack插件的作用

安装webpack-dev-server

配置webpack-dev-server

webpack 中的 loader

loader 概述

打包处理css文件

webpack详细执行步骤

打包处理less文件

打包处理样式表中与url路径相关的文件

打包处理js文件中的高级语法

安装 babel-loader 相关的包

配置 babel-loader

配置 webpack 的打包发布

把JavaScript文件统一生成到js目录中

把图片文件统一生成到image目录中

自动清理dist目录下的旧文件

Source Map

什么是Source Map

默认 Source Map 问题

解决默认Source Map问题

webpack 生产环境下的 Source Map

只定位行数不暴露源码

Source Map的最佳实践

公告