前端系列-3 前端打包工具和插件介绍(npm+babel+webpack)
Ewen Seong 2024-08-11 12:33:01 阅读 74
背景
最近接触了两个前端项目,分别是vue2和vue3,感觉有点生疏。作为后端开发,前端知识容易遗忘,想着将之前的学习笔记整理成电子版发出来,以便后续简单复习即可快速恢复。前端系基于这个目的创建,将用于收集前端技术文章。
1.npm和nodejs
1.1 nodejs
说明:nodejs是一个基于ChromeV8引擎的JS运行环境,使用了事件驱动、非阻塞式I/O模型、优化的JS编译技术的JS运行时环境;基于此,JS可用于开发服务端语言。NodeJS与V8引擎的最新版本是保持同步, 因此支持ES6语法。
安装:https://nodejs.cn/download/
node -v 查看是否安装成功
1.2 npm
说明: Node Package Manager, NodeJs默认的包管理工具,相当于Python的pip,Java的maven.
安装:在安装NodeJs时会自动安装
npm -v 查看是否安装成功
1.2.1 语法:
(1) npm config get/set
用于获取和设置全局配置,可配置项包括:prefix, cache, registry, proxy。
cache和prefix分别是npm的缓存和 全局安装包的路径;
proxy代理地址(公司内部一般会进行代理设置)
register 设置包镜像地址,可设置为国内的镜像地址:
<code>npm config set registry https://registry.npm.taobao.org/
(2) npm init
用于项目初始化; 在当前目录生成一个package.json
文件
(3) npm install/uninstall
npm install/uninstall 语句用于安装和卸载安装包
# -g表示全局安装, -D表示开发环境安装
npm install -g nodemon
安装完成后会在当前项目/全局路径下生产一个node_modules文件夹,用于存放安装包.
(3) npm list
查看已经安装的包
# -g表示全局安装
npm list -g
(4) npm的发布
需要注册npm账号,使用npm login命令登录,使用npm publish发布
1.2.2 配置文件:
.npmrc作为npm的配置文件(键值对集合),在指定npm命令时会读取.npmrc文件,存在相同的键时,优先级顺序为:项目根目录下的.npmrc
文件>用户主目录下的.npmrc
文件>npm内置的默认配置。上述npm config set语句的执行结果会同步到.npmrc文件文件中,因此机器重启不会丢失修改的配置。
1.2.3 package.json文件:
(1) 坐标属性(必选)
name和version用于全局唯一标识安装包;
(2) 描述类属性:
description, keywords ,contributors,bugs,author等描述类属性,可选;
(3) 依赖配置:
常使用的依赖包括dependencies和devDependencies,其中dependencies表示生产环境中运行需要的依赖,devDependencies表示开发环境需要的依赖。
一般生产环境中不需要 Webpack、Eslint、Babel 等打包工具,因此这些依赖会被放在devDependencies中。
格式如下:
"devDependencies": { -- -->
"babel": "^6.23.0"
}
#固定版本: 安装时只安装这个指定的版本;
#波浪号: 主版本号、次版本号下允许的最新版本;
#插入号: 主版本号下允许的最低版本;
#latest:安装最新的版本
执行npm install时会自动将依赖项记录到package.json文件中。
(4) 脚本
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
}
当命令行执行 npm run test时,执行test命令对应的语句.
2.babel
JS不断发展,浏览器的适配速度没有跟上,引入了一个问题:用高级(ES6+)的JS语法开发的代码,无法在支持低版本(ES5)JS语法的浏览器上运行。babel作为转译工具,可以实现将ES6转译为ES5,为该问题提供了一个解决方案。label常被集成到webpack中进行打包;随着vue3的出现, vite+esbuild的占有率相比webpack+babel更高。
2.1.组成
babel是一个工具链集,由以下部分组成:
[1] 核心@babel/core:
babel的核心包,集成了整个Babel的工作流,类似计算机主板的作用。
[2] 编译器 @babel/parser,@babel/traverse,@babel/generator:
parser对源码进行解析得到AST(抽象语法树),traverse对语法书进行遍历,并调用插件对其进行转义,得到新的语法树;generator根据新的语法树生成ES5代码;
[3] 插件和预设:
babel整体提供了一个执行流程的框架,实际的转义工作需要依赖于具体的插件。如: @babel/plugin-transform-arrow-functions插件的作用是将ES6的箭头函数语法转换为ES5的普通函数语法, @babel/plugin-transform-for-of插件的作用是将ES6的for…of循环语法转换为ES5可理解的语法等。预设是对插件进行的一些组装或者条件组装,从而减少了重复工作(通过引入一个预设而不需要引入多个插件)。
插件的转换可以分为两种类型:
(1)语法转义,如箭头函数和for…of的转换,可通过babel语法插件实现;
(2)API和内置对象的转义,Promise、Array、Symbol等的转换,需要使用pollyfill(垫片)机制实现。pollyfill实现原理较为简单,直接在全局对象中引入ES6中新增API的定义(垫片),来模拟一个ES6环境;从而可以运行ES6的API。
**说明:**直接在全局对象中引入ES6的垫片是babel6中的 babel-polyfill的实现方式,容易造成全局污染;在babel7中不再建议使用babel-polyfill,推荐使用 @babel/polyfill替代方案,@babel/polyfill采用了更加模块化的方式来引入垫片。二者底层是对core.js和regenerator-runtime这两个库的封装。
2.2 使用方式
2.2.1 安装babel
babel作为编译期间使用的依赖,使用如下命令进行安装:
npm install --save-dev @babel/core @babel/cli @babel/preset-env
2.2.2 配置依赖
在项目根目录下新建.babelrc文件,在.babelrc配置文件中进行插件和预设的配置。一般而言,配置preset-env能满足大部分场景:
{
"plugins": [],
"presets": ['@babel/preset-env']
}
plugins和presets的运行顺序为: plugins -> presets, plugins是从前往后执行, presets是从后往前执行。
也可以将配置放在package.json中,如下所示:
{
"dependencies": {
//...
},
//...
"babel": {
"presets": [
"env"
],
"comments": false
}
}
preset-env预设会根据指定的目标环境自动确定需要哪些Babel插件和polyfills,从而进行必要的代码转换。preset-env中支持配置浏览器的版本,babel保证生成的代码可以被对应的浏览器所识别。
2.2.3 案例介绍
step1: 执行npm init -y
快速创建一个项目;
step2: 执行npm install --save-dev @babel/core @babel/cli @babel/preset-env
安装babel;
step3: 新建src文件夹和src/index.js和src/module1.js文件(index.js依赖module1.js模块):
index.js
import { print} from "./module1";
print();
// 1.箭头函数
var a = () => { };
module1.js
function fetchData() {
// 2.Promise
return new Promise((resolve, reject) => {
setTimeout(() => { resolve('hello world');}, 1000);
});
}
export var print = function() {
fetchData().then(data => {
console.log('数据获取成功:', data);
}).catch(error => {
console.error('数据获取失败:', error);
});
}
step4: 修改package.json, 添加构建脚本命令:
{
// ...
"scripts": {
// 编译src目录下的js文件,并输出到lib目录下
"build": "babel src -d lib"
}
}
step5: 在项目根路径下添加babel配置文件:
{
"plugins": [],
"presets": [
[
"@babel/preset-env",
{
"corejs": 3,
"useBuiltIns": "usage"
}
]
]
}
step6: 在项目路径下,执行npm run build, 得到的js如下所示:
index.js:
"use strict";
var _module = require("./module1");
(0, _module.print)();
// 1.箭头函数已转换
var a = function a() { };
module1.js:
"use strict";
// 在module1模块中引入promise,模拟ES6
require("core-js/modules/es.object.define-property.js");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.print = void 0;
require("core-js/modules/es.object.to-string.js");
require("core-js/modules/es.promise.js");
require("core-js/modules/web.timers.js");
function fetchData() {
return new Promise(function (resolve, reject) {
setTimeout(function () {
resolve('hello world');
}, 1000);
});
}
var print = exports.print = function print() {
fetchData().then(function (data) {
console.log('数据获取成功:', data);
})["catch"](function (error) {
console.error('数据获取失败:', error);
});
};
3.webpack
webpack是一个前端项目的打包工具,默认仅支持对低版本JS的打包, 可通过loader方式增加可处理文件的类型,另外通过插件机制对webpack的功能进行增强。
3.1 安装webpack
#webpack是全局的工具,也可以通过-g安装至全局
npm i webpack webpack-cli -D
npm i webpack-dev-server -D
3.2 配置文件
webpack的配置文件放在项目根路径下,名称为webpack.config.js:
module.exports = {
entry: "打包入口",
output: "打包出口",
mode: "运行环境",
module: { },//配置loader
plugins: [] //插件配置
};
如上所示,常用的配置有:
**[1] entry配置打包入口:**可以配置单个文件或者多个文件
// 指定一个打包入口:
module.exports = {
entry: "./src/index.js", //打包⼊⼝⽂件
}
// 指定多个打包入口
module.exports = {
entry: {
index: './src/index.js',
index2: './src/index2.js'
}
}
[2] output配置打包的出口
const path = require('path');
module.exports = {
output:{
//_dirname 是一个全局变量,根目录的绝对路径
path:path.join(__dirname, './dist'), //输出文件存放路径
filename:'bundle.js' //输出文件的名称
}
}
[3] mode执行环境信息
可以设置为develop或者production,develop打包时不会进行文件压缩,速度较快,使用于开发环境;部署时,使用production模式打包。
[4] module配置loader
如下所示为处理css的loader:
module.exports = {
module: {
rules: [
{ test: /\.css$/i, use: ["style-loader", "css-loader"]}
]
}
}
上面涉及到的test: /\.css$/i
为正则表达式,匹配后,才会使用style-loader和css-loader.
其中:/表示正则表达式的开始或者结束,\转义字符,.表示点号;$表示结尾,i表示忽略大小写。loader执行顺序为反向,即css-loader读取css文件处理后交给style-loader,style-loader处理后将模块信息保存到内存中,转交给webpack,webpack对模块进行打包。
在webpack配置style-loader和css-loader时,需要保证当前环境已经安装了相应的依赖,否则需要执行以下命令:
npm install style-loader css-loader -D
[5] plugins配置插件
常用插件有html-webpack-plugin和webpack-parallel-uglify-plugin等.
module.exports = {
plugins:[htmlPlugin,cleanPlugin]
}
3.3 webpack打包流程
webpack中认为每个文件是一个模块,多个关联的模块可以编组为一个Chunk, 打包的产物为一个或多个Bundle。具体而言,webpack从配置文件中entry配置的打包入口出发,根据模块的依赖关系构建依赖图,并将依赖关系分割成不同的Chunk, 每个Chunk平行地构建(可以提高打包速度),每个chunk生成一个bundle。对于chunk中每个模块, 构建流程如下:
[1] 当前模块是js文件且不包含高级语法:webpack直接处理;
否则: [2] 是否配置loader ? 调用loader加载模块并将处理后的模块信息转交给webpack : 报错。
3.4 webpack整合babel
根据babel章节中介绍的内容配置babel,然后在webpack的配置文件中进行如下配置:
module.exports = {
module: {
rules: [
// exclude用于排除文件
{ test:/\.js$/,use:'babel-loader',exclude:/node_modules/}
]
}
}
配置后,webpack打包时,如果遇到高级语法的js文件,会经过babel-loader转换。
3.5 案例介绍
3.5.1 项目初始化
执行npm init -y
初始化项目后,得到一个package.json文件:
{
"name": "demo",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC"
}
准备项目的资源文件,目录树设计为:
-src
-index.js
-module1.js
-index.html
-package.json
-package-lock.json
index.html
<!DOCTYPE html>
<html>
<head>
<title>demo</title>
</head>
<body>
<script src="./dist/bundle.js"></script>code>
</body>
</html>
index.js
// index.js
import { -- -->getMessage} from "./module1";
console.log(getMessage());
module1.js
// module1.js
export function getMessage(){
return "[webpack] hello world";
}
3.5.2 安装和配置babel
安装babel:
npm install --save-dev @babel/core @babel/cli @babel/preset-env
配置babel:
在根目录下新建babel的配置文件.babelrc:
{
"plugins": [],
"presets": [
[
"@babel/preset-env",
{
"corejs": 3,
"useBuiltIns": "usage"
}
]
]
}
3.5.3 安装和配置webpack
安装webpack:
npm i webpack webpack-cli webpack-dev-server -D
安装babel-loader:
npm install babel-loader -D
配置webpack:
在根目录下创建webpack.config.js文件并配置:
const path = require("path")
module.exports = {
mode:"development",
entry:"./src/index.js",
output:{
filename:"main.js",
path: path.resolve(__dirname, "dist"),
},
module: {
rules: [
{ test:/\.js$/,use:'babel-loader',exclude:/node_modules/}
]
}
}
3.5.4 运行结果
配置package.json文件:
"scripts": {
//添加build命令
"build": "npx webpack"
}
运行npm run build命令:
> demo@1.0.0 build
> npx webpack
asset main.js 4.13 KiB [emitted] (name: main)
runtime modules 670 bytes 3 modules
cacheable modules 132 bytes
./src/index.js 66 bytes [built] [code generated]
./src/module1.js 66 bytes [built] [code generated]
webpack 5.91.0 compiled successfully in 1265 ms
在浏览器中查看打印信息如下:
[webpack] hello world
声明
本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。