Wie das Sprichwort sagt: Wenn ein Arbeiter seine Arbeit gut machen will, muss er zuerst seine Werkzeuge schärfen! Das Schreiben eines Open-Source-Projekts ist keine Ausnahme. Nehmen Sie das vue3-Framework
und das vite-Tool
, die in China sehr beliebt sind. Die Implementierung und das architektonische Design sind alle gleich und riesige Projekte, und was den reibungslosen Betrieb dieser Projekte unterstützt, sind nichts anderes als Räder nacheinander. Ich habe kürzlich den Quellcode von vue3 und vite3
gelesen und einige praktischere gefunden Räder, teile es mit allen hier. vue3 框架
和 vite 工具
来讲,其中的实现与架构设计无不是一个 复杂而庞大的工程
,而支撑这些工程能顺利运行的无不是一个又一个的轮子,正好最近有在阅读 vue3 和 vite3
的源码,发现一些较实用的轮子,在这里分享给大家。
如果你想对 前端工程化
有所涉猎的话,我相信下面的工具总有一款是你想要的!
picocolors 是一个可以在终端修改输出字符样式的 npm
包,说直白点就是给字符添加颜色;
可能有的同学想到了,这不是跟 chalk 一样的吗?
没错,他们的作用其实就是一样的!
为什么选择 picocolors:
所以大家明白选什么了吧!
当然因为 picocolors
包比较小,所以功能边界没有 chalk
的全面,但是用在一些自研等绝大部分的需求中是完全可以满足的。
注意:
因为历史等原因
vue3
目前还在使用chalk
;vite 已全面用
picocolors
替代作为终端样式输出;不过
chalk
为了优化,在最近的最新版本 v5 中已剔除依赖包;
prompts
vs enquirer
vs inquirer
乍一看,可能有的同学会有点懵,其实一句话交代就是:其实他们三都是用来 实现命令行交互式界面
的工具;
之所以放在一起是因为 vue3
和 vite
Front-End-Engineering
befassen möchten, ist eines der folgenden Tools meiner Meinung nach genau das Richtige für Sie!
NPM-Download-Beliebtheitstrend in den letzten zwei Jahren:
Eine kurze Zusammenfassung:
Tatsächlich verwendete vite
auch enquirer
bei Zuerst, aber später für Um die Fehler zu beheben, auf die Benutzer bei der Verwendung plattformübergreifender Anwendungen stoßen, wurde prompts
ersetzt. Das bedeutet natürlich nicht, dass enquirer
nicht gut ist, aber Die Szenarien sind unterschiedlich, daher wird die Auswahl unterschiedlich sein. ;vite
起初也是使用的 enquirer
,只是后面为了满足用户跨平台使用时出现的 bug,才替换成了 prompts
,当然也并不是说 enquirer
不好,只是场景不同,所以选择会有所不同罢了;
其实如果你想在自己的项目中使用 交互式界面
工具,我这边还是比较推荐 inquirer
的,毕竟社区受欢迎程度和功能都是完全满足你的需求的。
cac 是一个用于构建 CLI 应用程序的 JavaScript 库;
通俗点讲,就是给你的 cli 工具增加自定义一些命令,例如 vite create
,后面的 create
命令就是通过 cac 来增加的;
因为该库较适用于一些自定义的工具库中,所以只在 vite
中使用, vue3
并不需要该工具;
主要是因为 vite 的工具是针对一些自定义的命令等场景不是特别复杂的情况;
我们看看 cac 的优势
:
commander
和 yargs
;cli.option
、cli.version
、cli.help
cli.parse
即可搞定大部分需求;当然,如果你想写一个功能较多的 cli 工具,也是可以选择
commander
和yargs
的;不过一些中小型的 cli 工具我还是比较推荐
cac
的;
npm-run-all 是一个 cli
工具,可以并行、或者按顺序执行多个 npm
脚本;npm-run-all
在 vite
工具源码中有使用;
通俗点讲就是为了解决官方的 npm run 命令
无法同时运行多个脚本的问题,它可以把诸如 npm run clean && npm run build:css && npm run build:js && npm run build:html
的一长串的命令通过 glob 语法简化成 npm-run-all clean build:*
一行命令。
提供三个命令:
npm-run-all
:-s
和 -p
参数的简写,分别对应串行和并行;# 依次执行这三个任务命令 npm-run-all clean lint build # 同时执行这两个任务命令 npm-run-all --parallel lint build # 先串行执行 a 和 b, 再并行执行 c 和 d npm-run-all -s a b -p c d
run-s
:为 npm-run-all --serial
的缩写;run-p
:为 npm-run-all --parallel
的缩写;上面只是简单的介绍了下,想要了解更多实用功能的,可以去官网查看;
最后:这个库属实是好用,良心推荐!
semver 是一个语义化版本号管理的 npm
库;semver
在 vue3
框架源码和 vite
工具源码中都有使用;
说直白一点,你在开发一个开源库的时候,肯定会遇到要提醒用户不同版本号不同的情况,那么如何去判断用户版本过低,semver
就可以很好的帮助你解决这个问题;
semver
内置了许多方法,比如 判断一个版本是否合法,判断版本号命名是否正确,两个版本谁大谁小之类
Wenn Sie das Interaktive Interface
-Tool in Ihrem eigenen Projekt verwenden möchten, empfehle ich dennoch Anfragender
Schließlich ist die Community beliebt. Umfang und Funktionalität sind ganz auf Ihre Bedürfnisse zugeschnitten. 3. cac
cac ist eine JavaScript-Bibliothek zum Erstellen von CLI-Anwendungen.
Einfach ausgedrückt bedeutet dies, dass Sie Ihrem CLI-Tool einige benutzerdefinierte Befehle hinzufügen, z. B.vite create
, gefolgt von create<. der befehl code> wird über cac hinzugefügt. 🎜🎜Da diese Bibliothek besser für einige benutzerdefinierte Werkzeugbibliotheken geeignet ist, wird sie nur in <code>vite
, vue3
und verwendet. Dieses Tool ist nicht erforderlich ; 🎜🎜🎜Warum nicht commander🎜 oder yargs🎜 ? 🎜🎜🎜 Hauptsächlich, weil die Tools von vite für einige benutzerdefinierte Befehle und andere Szenarien konzipiert sind, die nicht besonders komplex sind. 🎜🎜 Werfen wir einen Blick auf die Vorteile von cac
: 🎜🎜🎜🎜Super leichtgewichtig🎜: Da Es gibt keine Abhängigkeiten und die Größe ist um ein Vielfaches kleiner als commander
und yargs🎜🎜Einfach zu erlernen🎜: Es müssen nur 4 APIs <code> erlernt werden cli.option
, cli.version
, cli.help
cli.parse
kann die meisten Anforderungen erfüllen;🎜🎜 Leistungsstark🎜: Der Standardbefehl „Enable“ kann genauso einfach verwendet werden wie der Git-Befehl und verfügt über vollständige Funktionen wie Parameter- und Optionsüberprüfung, automatische Hilfegenerierung usw. 🎜Natürlich; Wenn Sie ein CLI-Tool mit mehr Funktionen schreiben möchten, können Sie auchcommander
undyargs
wählen. 🎜🎜Ich empfehle jedoch weiterhincac
für einige kleine und mittlere CLI-Tools. ;🎜
cli
-Tool, das mehrere ausführen kann npmim parallelen oder sequentiellen Code>-Skript; <code>npm-run-all
wird im Quellcode des vite
-Tools verwendet 🎜🎜Für Laien ist es zu lösen der offizielle npm run-Befehl
Das Problem, dass nicht mehrere Skripte gleichzeitig ausgeführt werden können, kann eine lange Liste von Befehlen wie npm run clean && npm run build:css && übergeben npm run build:js && npm run build:html
durch glob Die Syntax wird auf den einzeiligen Befehl npm-run-all clean build:*
vereinfacht. 🎜🎜🎜Stellt drei Befehle bereit: 🎜🎜🎜🎜npm-run-all
: 🎜🎜kann die Parameter -s
und -p
annehmen. Abkürzungen, entsprechend seriell bzw. parallel; const semver = require('semver') semver.valid('1.2.3') // '1.2.3' semver.valid('a.b.c') // null semver.clean(' =v1.2.3 ') // '1.2.3' semver.satisfies('1.2.3', '1.x || >=2.5.0 || 5.0.0 - 7.2.3') // true semver.gt('1.2.3', '9.8.7') // false semver.lt('1.2.3', '9.8.7') // true semver.minVersion('>=1.0.0') // '1.0.0' semver.valid(semver.coerce('v2')) // '2.0.0' semver.valid(semver.coerce('42.6.7.9.3-alpha')) // '42.6.7'🎜
run-s
: ist npm-run-all --serial
Abkürzung für ; 🎜run-p
: Abkürzung für npm-run-all --parallel
🎜 Das Obige ist Nur eine kurze Einführung. Wenn Sie weitere praktische Funktionen kennenlernen möchten, können Sie zu Offizielle Website 🎜Ansicht; 🎜🎜Abschließend: 🎜Diese Bibliothek ist wirklich einfach zu verwenden, sehr zu empfehlen! 🎜🎜
npm
-Bibliothek für die semantische Versionsverwaltung; semver
befindet sich im Quellcode des vue3
-Frameworks und in der vite
-Toolquelle Code Sie werden alle verwendet. 🎜🎜 Um es ganz klar auszudrücken: Wenn Sie eine Open-Source-Bibliothek entwickeln, werden Sie definitiv auf Situationen stoßen, in denen Sie Benutzer daran erinnern müssen, dass unterschiedliche Versionsnummern unterschiedlich sind. Wie können Sie also beurteilen, ob die Benutzerversion zu niedrig ist? , semver
kann Ihnen bei der Lösung dieses Problems sehr gut helfen; 🎜🎜semver
verfügt über viele integrierte Methoden, wie z Die Versionsnummer ist korrekt benannt und welche der beiden Versionen ist älter Weitere Informationen finden Sie in der Dokumentation🎜🎜minimist 是一个命令行参数解析工具;minimist
在 vue3
框架源码和 vite
工具源码中都有使用;
使用:
const args = require('minimist')(process.argv.slice(2))
例如:
# 执行以下命令 vite create app -x 3 -y 4 -n5 -abc --beep=boop foo bar baz # 将获得 { _: [ 'foo', 'bar', 'baz' ], x: 3, y: 4, n: 5, a: true, b: true, c: true, beep: 'boop' }
特别要说明的是返回值其中首个 key 是_
,它的值是个数组,包含的是所有没有关联选项的参数。
如果你的工具在终端有较多的参数,那么这个工具就非常的适合您!
magic-string 是一个用于操作字符串和生成源映射的小而快的库;
其实它最主要的功能就是对一些源代码和庞大的 AST
字符串做轻量级字符串的替换;
在 vite
工具源码和 @vue/compiler-sfc
中大量使用;
使用:
import MagicString from 'magic-string'; const s = new MagicString('problems = 99'); // 替换 problems -> answer s.overwrite(0, 8, 'answer') s.toString() // 'answer = 99' // 生成 sourcemap var map = s.generateMap({ source: 'source.js', file: 'converted.js.map', includeContent: true })
fs-extra 是一个强大的文件操作库
, 是 Nodejs fs 模块
的增强版;
这个就不多讲了,因为它在千锤百炼之下只能形容它是 YYDS
,查看 更多官方文档。
chokidar 是一款专门用于文件监控的库;chokidar
只在 vite
工具源码中有使用;
其实 Node.js 标准库中提供 fs.watch
和 fs.watchFile
两个方法用于处理文件监控,但是为什么我们还需要chokidar
呢?
主要是由于 兼容性不好、无法监听、监听多次
等大量影响性能的问题;
chokidar 用法:
const chokidar = require('chokidar'); const watcher = chokidar.watch('file, dir, glob, or array', { ignored: /(^|[\/\\])\../, persistent: true }); watcher .on('add', path => console.log(`File ${path} has been added`)) .on('change', path => console.log(`File ${path} has been changed`)) .on('unlink', path => console.log(`File ${path} has been removed`)) .on('addDir', path => console.log(`Directory ${path} has been added`)) .on('unlinkDir', path => console.log(`Directory ${path} has been removed`)) .on('error', error => console.log(`Watcher error: ${error}`)) .on('ready', () => console.log('Initial scan complete. Ready for changes')) .on('all', (event, path) => console.log(event,path)) .on('raw', (event, path, details) => { log('Raw event info:', event, path, details); });
fast-glob 是一个快速批量导入、读取文件的库; fast-glob
只在 vite
工具源码中有使用;
基本语法:
*
:匹配除斜杆、影藏文件外的所有文件内容;
**
:匹配零个或多个层级的目录;
?
:匹配除斜杆以外的任何单个字符;
[seq]
:匹配 []
中的任意字符 seq;
如何使用:
const fg = require('fast-glob'); const entries = await fg(['.editorconfig', '**/index.js'], { dot: true });
在 vite
中使用:
vite
工具中 import.meta.glob
方法(如下)就是基于这个库来实现,所以如果你在自己的工具库中有批量文件等的操作,这个库是以很不错的选择;
const modules = import.meta.glob('./dir/*.js', { query: { foo: 'bar', bar: true } })
vite
通过 fast-glob
工具把它生成如下代码
// vite 生成的代码 const modules = { './dir/foo.js': () => import('./dir/foo.js?foo=bar&bar=true').then((m) => m.setup), './dir/bar.js': () => import('./dir/bar.js?foo=bar&bar=true').then((m) => m.setup) }
debug 是一个模仿 Node.js
核心调试技术的小型 JavaScript
调试程序,在适用于 Node.js
和 Web 浏览器
都可使用;debug
只在 vite
工具源码中有使用;
说直白点就是你可以使用 debug 来对你的程序进行 毫秒级别时间差的统计
对你程序代码进行优化;
使用:
var debug = require('debug')('http') , http = require('http') , name = 'My App'; // fake app debug('booting %o', name); http.createServer(function(req, res){ debug(req.method + ' ' + req.url); res.end('hello\n'); }).listen(3000, function(){ debug('listening'); }); // fake worker of some kind require('./worker');
如果你对你的代码或者自研的工具等有较高性能要求,强烈建议可以使用
debug
来进行调式。
dotenv 是一个零依赖模块,可将 .env 文件
中的环境变量加载到 process.env
中;dotenv
只在 vite
工具源码中有使用;
如何使用:
1、创建 .env 文件
S3_BUCKET="YOURS3BUCKET" SECRET_KEY="YOURSECRETKEYGOESHERE"
2、使用
import * as dotenv from 'dotenv' dotenv.config() console.log(process.env)
esbuild 是一个基于 Go 语言开发的 JavaScript 打包工具,被 Vite 用于开发环境的依赖解析;
相比传统的打包工具,主打性能优势,在构建速度上可以快 10~100 倍;
到现在知道为啥
vite
为啥快了吧,esbuild
就是第一功臣。
优势:
使用:
esbuild
在 API 层面上非常简洁, 主要的 API 只有两个: Transform
和 Build
, 这两个 API 可以通过 CLI, JavaScript, Go 的方式调用;
1、transform:调用这个API能将 ts
,jsx
等文件转换为js文件;
// cli exbuild ./test.ts --loader=ts // 输出 const str = 'Hello World'; // js api调用 const esbuild = require('esbuild'); const fs = require('fs'); const path = require('path'); const filePath = path.resolve(__dirname, 'test.ts'); const code = esbuild.transformSync(fs.readFilesync(filePath), { loader: 'ts', }) console.log(code); // 输出 // { // code: 'const str = 'Hello World'', // map: '', // warnings: [] // }
2、build:整合了transform
后的代码,可以将一个或者多个文件转换并保存为文件;
// cli esbuild test.ts --outfile=./dist/test.js // { errors: [], warnings: [] } // js api调用 const esbuild = require('esbuild'); const path = require('path'); const result = esbuild.buildSync({ entryPoints: [path.resolve(__dirname, 'test.ts')], outdir: path.resolve(__dirname, 'dist'), }); console.log(result); // { errors: [], warnings: [] }
更多详细使用可查看链接
rollup 是一个 JavaScript 模块打包器
,可以将小块代码编译成大块复杂的代码,我们熟悉的 vue、react、vuex、vue-router 等都是用 rollup 进行打包的。
在 vite
中的生产环境(Production) 就是基于 rollup
打包来构建主要代码的。
使用:
1、创建 rollup.config.js
文件
2、配置文件
export default { input: 'src/index.js', output: { name: 'amapUpper', file: 'dist/amapUpper.js', format: 'umd' }, plugins: [] };
3、运行
{ "scripts": { "dev": "rollup -i src/index.js -o dist/bundle.js -f es" }, }
4、执行 npm run dev
ws 是一个简单易用、速度极快且经过全面测试的 WebSocket 客户端
和 服务器
实现;完全可以是 Socket.io
的替代方案;ws
只在 vite
工具源码中有使用。
说直白一点就是通过 ws
,咱们可以实现服务端和客户端的长连接,且通过 ws
对象,就可以获取到 客户端发送过来的信息
和 主动推送信息给客户端
。
使用:
1、server.js
const WebSocket = require('ws') const WebSocketServer = WebSocket.Server; // 创建 websocket 服务器 监听在 3000 端口 const wss = new WebSocketServer({port: 3000}) // 服务器被客户端连接 wss.on('connection', (ws) => { // 通过 ws 对象,就可以获取到客户端发送过来的信息和主动推送信息给客户端 var i=0 var int = setInterval(function f() { ws.send(i++) // 每隔 1 秒给连接方报一次数 }, 1000) })
2、client.js
const WebSocket = require('ws') const ws = new WebSocket('ws://localhost:3000') // 接受 ws.on('message', (message) => { console.log(message) // 当数字达到 10 时,断开连接 if (message == 10) { ws.send('close'); ws.close() } })
connect 是一个最早期的 HTTP 服务器框架,亦可称为中间件插件;express
就是基于此框架做的扩展;
注意:从 vite2
开始官方已从依赖 koa
转成 connect
了;
至于为什么使用 connect
而不是 koa
,咱们看官方的回答:
大概意思就是:由于大部分逻辑应该通过插件钩子而不是中间件来完成,因此对中间件的需求大大减少;所以使用 connect
优先级会高于 Koa
。
esno 是一个基于 esbuild
的 TS/ESNext
的 Node.js
运行时;
说直白点就是可以类似 ts-node
一样直接运行 TS 文件
,那为甚么还用 esno
呢?
因为 esno
是基于 esbuild
运行的,esbuild
有多快,上面我们有讲到了吧,这里就不复述了。
使用:
{ "scripts": { "start": "esno index.ts" }, "dependencies": { "esno": "*" } }
npm run start
tsup 是一个轻小且无需配置的,由 esbuild
支持的打包工具;
它可以直接把 .ts、.tsx
转成不同格式 esm、cjs、iife
的文件,快速打包你的工具库;
使用:
1、安装 tsup
pnpm i tsup -D
2、在根目录下的 package.json
中配置
{ "scripts": { "dev": "pnpm run build -- --watch --ignore-watch examples", "build": "tsup src/index.ts --dts --format cjs,esm" }, }
vitepress 是在 vuepress
的基础上实现的静态网站生成器,区别在于 vitepress
是建立在 vite
之上做的开发;
优势:
vite
anstelle von webpack
, alle schnelleren Startzeiten, Hot-Reloading usw.;vite
而不是 webpack
,所有更快的启动时间,热重载等;vue3
来减少 js 的有效负载;所以如果你想写一个在线文档仓库,那么
vitepress
就是一个很好的选择。
vitest 是一个由 vite
提供支持的快速单元测试框架。
优势:
由 Vite ⚡️ 提供支持的极速单元测试框架。
与 Vite 的配置通用,watch 模式下极快的反应(相当于测试中 HMR)。
可以对 Vue/React 组件进行测试。
开箱即用 Typescript/JSX/ESM(这一点我想配过 jest 的人应该懂是什么意思)
与 Jest 几乎相同的 API,同时也有 Jest 的快照功能(这个非常好用!)
模拟 DOM
生成测试覆盖率
ESM优先,顶级等待
开箱即用的 TypeScript / JSX 支持
套件和测试的过滤、超时、并发
等等
所以你还有什么理由不使用
vitest
呢?
其实细心的同学可能会发现,目前 vue3
和 vite3
都是一个 monorepo
仓库,且都是使用 pnpm workspace
来进行仓库管理的;
所以了解 monorepo
和 pnpm workspace
对源码的阅读也是有很大的帮助的;
关于这块更多详细可以查看《如何入门 vite 源码》进行了解。
https://juejin.cn/post/7094984070999834655
当然,上面的分享的工具库只是在源码中使用 场景较多的库
,还有一些库由于 场景较少
Verwenden Sie vue3
zur Reduzierung js payload;
Wenn Sie also ein Online-Dokumentenlager schreiben möchten, istVorteile:🎜🎜🎜🎜Blitzschnelles Unit-Testing-Framework mit Unterstützung von Vite ⚡️. 🎜🎜🎜Gemeinsam mit der Vite-Konfiguration, extrem schnelle Reaktion im Überwachungsmodus (entspricht HMR im Test). 🎜🎜🎜Kann Vue/React-Komponenten testen. 🎜🎜🎜Typescript/JSX/ESM ist sofort verfügbar (ich denke, Leute, die mit Jest gearbeitet haben, sollten verstehen, was das bedeutet)🎜🎜🎜Fast die gleiche API wie Jest, und es gibt sie außerdem die Snapshot-Funktion von Jest (das ist sehr nützlich!) Unboxing Sofort einsatzbereite TypeScript/JSX-Unterstützung🎜🎜🎜Filterung, Zeitüberschreitungen, Parallelität für Suiten und Tests🎜🎜🎜und mehr🎜🎜🎜also warum nicht wahr? Wie wäre es mit der Verwendung vonvitepress
eine gute Wahl.20. vitest
vitest ist ein schnelles Unit-Test-Framework, das von
vite
unterstützt wird.
vitest
? 🎜🎜vue3
und vite3
beide gleich sind monorepo Warehouse, und beide verwenden pnpm workspace
für die Lagerverwaltung 🎜🎜Verstehen Sie also monorepo
und pnpm workspace
Der Quellcode ist ebenfalls sehr hilfreich. 🎜🎜🎜Weitere Informationen hierzu finden Sie unter „Erste Schritte mit dem Vite-Quellcode“. 🎜🎜https://juejin.cn/post/7094984070999834655🎜🎜🎜Natürlich verwenden die oben freigegebenen Toolbibliotheken nur Bibliotheken mit mehr Szenarien
im Quellcode, und einige Bibliotheken sind auf Es gibt weniger Szenarien
, daher gibt es hier keine detaillierte Erklärung. Wenn Sie wissen möchten, welche Toolbibliothek im Quellcode enthalten ist, können Sie diese gerne rechtzeitig hinzufügen, nachdem Sie Ihre Auswahl getroffen haben 🎜🎜Ursprüngliche Adresse: https://juejin .cn/post/7124112069355372581🎜🎜Autor: Meister Yi🎜🎜