Comme le dit le proverbe : Si un ouvrier veut bien faire son travail, il doit d'abord affûter ses outils ! L'écriture d'un projet open source ne fait pas exception. Prenez le framework vue3
et l'vite tool
qui sont très populaires en Chine. L'implémentation et la conception architecturale sont toutes les mêmes Complexes. et d'énormes projets
, et ce qui soutient le bon fonctionnement de ces projets ne sont que des roues les unes après les autres. Il m'est arrivé de lire récemment le code source de vue3 et vite3
et j'en ai trouvé plus pratiques. roues. , partagez-le avec tout le monde ici. vue3 框架
和 vite 工具
来讲,其中的实现与架构设计无不是一个 复杂而庞大的工程
,而支撑这些工程能顺利运行的无不是一个又一个的轮子,正好最近有在阅读 vue3 和 vite3
的源码,发现一些较实用的轮子,在这里分享给大家。
如果你想对 前端工程化
有所涉猎的话,我相信下面的工具总有一款是你想要的!
picocolors 是一个可以在终端修改输出字符样式的 npm
包,说直白点就是给字符添加颜色;
可能有的同学想到了,这不是跟 chalk 一样的吗?
没错,他们的作用其实就是一样的!
为什么选择 picocolors:
所以大家明白选什么了吧!
当然因为 picocolors
包比较小,所以功能边界没有 chalk
的全面,但是用在一些自研等绝大部分的需求中是完全可以满足的。
注意:
因为历史等原因
vue3
目前还在使用chalk
;vite 已全面用
picocolors
替代作为终端样式输出;不过
chalk
为了优化,在最近的最新版本 v5 中已剔除依赖包;
prompts
vs enquirer
vs inquirer
乍一看,可能有的同学会有点懵,其实一句话交代就是:其实他们三都是用来 实现命令行交互式界面
的工具;
之所以放在一起是因为 vue3
和 vite
ingénierie front-end
, je pense que l'un des outils suivants sera ce qu'il vous faut !
Tendance de popularité des téléchargements npm au cours des deux dernières années :
Un bref résumé :
En fait, vite
a également utilisé enquirer
sur d'abord, mais plus tard pour répondre aux bugs que les utilisateurs rencontrent lors de l'utilisation de plusieurs plates-formes, invites
a été remplacé. Bien sûr, cela ne signifie pas que enquirer
n'est pas bon, mais. les scénarios sont différents, donc le choix sera différent. ;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
内置了许多方法,比如 判断一个版本是否合法,判断版本号命名是否正确,两个版本谁大谁小之类
En fait, si vous souhaitez utiliser l'outil Interactive Interface
dans votre propre projet, je recommande quand même demandeur
Après tout, la communauté est populaire. L'étendue et les fonctionnalités sont entièrement adaptées à vos besoins. 3. cac
cac est une bibliothèque JavaScript pour créer des applications CLI ;
Pour faire simple, cela signifie ajouter des commandes personnalisées à votre outil cli, telles quevite create
, suivies de create est ajoutée via cac ; 🎜🎜Parce que cette bibliothèque est plus adaptée à certaines bibliothèques d'outils personnalisées, elle n'est utilisée que dans <code>vite
, vue3
et aucun besoin de cet outil. 🎜🎜🎜Pourquoi ne pas utiliser commander🎜 ou yargs🎜 ? 🎜🎜🎜 Principalement parce que les outils de vite sont conçus pour certaines commandes personnalisées et d'autres scénarios qui ne sont pas particulièrement complexes 🎜🎜 Jetons un coup d'œil aux avantages de cac
: 🎜🎜🎜🎜Super léger🎜 : Il il n'y a pas de dépendances, et la taille est plusieurs fois plus petite que commander
et yargs
🎜🎜Facile à apprendre🎜 : il suffit d'apprendre 4 API ; cli.option
, cli.version
, cli.help
cli.parse
peuvent répondre à la plupart des besoins ;🎜🎜 Puissant🎜 : Activer La commande par défaut peut être utilisée aussi facilement que la commande git et possède des fonctions complètes telles que la vérification des paramètres et des options, la génération automatique d'aide, etc. 🎜Bien sûr, si vous souhaitez écrire un outil Pour cli avec plus de fonctions, vous pouvez également choisircommander
etyargs
🎜🎜Cependant, je recommande toujourscac
; pour certains outils cli de petite et moyenne taille ;🎜
cli
qui peut exécuter plusieurs npmen code parallèle ou séquentiel> ; <code>npm-run-all
est utilisé dans le code source de l'outil vite
🎜🎜En termes simples, il s'agit de résoudre la commande npm run officielle
Le problème de ne pas pouvoir exécuter plusieurs scripts en même temps, elle peut transmettre une longue liste de commandes telles que npm run clean && npm run build:css && npm run build:js && npm run build:html
via glob La syntaxe est simplifiée en la commande sur une ligne npm-run-all clean build:*
. 🎜🎜🎜Fournit trois commandes : 🎜🎜🎜🎜npm-run-all
: 🎜🎜peut prendre les paramètres -s
et -p
Abréviations, correspondant respectivement à série et parallèle ; 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
: est npm-run-all --serial
Abréviation de ; 🎜run-p
: Abréviation de npm-run-all --parallel
🎜 Ce qui précède est juste une brève introduction Si vous souhaitez connaître des fonctions plus pratiques, vous pouvez vous rendre sur le Site officiel 🎜Voir ; 🎜🎜Enfin : 🎜Cette bibliothèque est vraiment simple à utiliser, fortement recommandée ! 🎜🎜
npm
pour la gestion sémantique des versions semver
se trouve dans le code source du framework vue3
et dans la source de l'outil vite
; code Ils sont tous utilisés ; 🎜🎜 Pour parler franchement, lorsque vous développez une bibliothèque open source, vous rencontrerez certainement des situations où vous devrez rappeler aux utilisateurs que les différents numéros de version sont différents, alors comment juger que la version utilisateur est trop basse , semver
peut très bien vous aider à résoudre ce problème ; 🎜🎜semver
a de nombreuses méthodes intégrées, telles que pour juger si une version est légale, si la le numéro de version est nommé correctement et laquelle des deux versions est la plus ancienne
et d'autres méthodes 🎜🎜🎜Voici quelques exemples tirés du site officiel : 🎜🎜const args = require('minimist')(process.argv.slice(2))
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
au lieu de webpack
, des temps de démarrage tous plus rapides, un rechargement à chaud, etc. ;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
当然,上面的分享的工具库只是在源码中使用 场景较多的库
,还有一些库由于 场景较少
Utilisez vue3
pour réduire js payload;
Donc, si vous souhaitez écrire un entrepôt de documents en ligne, alorsAvantages :🎜🎜🎜🎜Cadre de tests unitaires ultra-rapide optimisé par Vite ⚡️. 🎜🎜🎜Commun avec la configuration Vite, réponse extrêmement rapide en mode montre (équivalent au HMR en test). 🎜🎜🎜Peut tester les composants Vue/React. 🎜🎜🎜Typescript/JSX/ESM est disponible immédiatement (je pense que les personnes qui ont travaillé avec Jest devraient comprendre ce que cela signifie)🎜🎜🎜Presque la même API que Jest, et il y a également la fonction Snapshot de Jest (c'est très utile !)🎜🎜🎜Simuler DOM🎜🎜🎜Générer une couverture de test🎜🎜🎜ESM d'abord, attente de niveau supérieur🎜🎜🎜 Unboxing Prise en charge TypeScript/JSX prête à l'emploi🎜🎜🎜Filtrage, délais d'attente, concurrence pour les suites et les tests🎜🎜🎜et plus encore🎜🎜🎜alors pourquoi n'est-ce pas, qu'en est-il de l'utilisation devitepress
est un bon choix.20. vitest
vitest est un framework de tests unitaires rapide alimenté par
vite
.
vitest
? 🎜🎜vue3
et vite3
sont tous deux identiques monorepo
et tous utilisent pnpm workspace
pour la gestion de l'entrepôt 🎜🎜Alors comprenez monorepo
et pnpm workspace
Lecture du le code source est également très utile 🎜🎜🎜Pour plus de détails à ce sujet, vous pouvez consulter « Comment démarrer avec le code source de Vite » pour en savoir plus. 🎜🎜https://juejin.cn/post/7094984070999834655🎜🎜🎜Bien sûr, les bibliothèques d'outils partagées ci-dessus n'utilisent que des bibliothèques avec plus de scénarios
dans le code source, et certaines bibliothèques sont dues à Il y a moins de scénarios
, donc il n'y a pas d'explication détaillée ici. Si vous voulez savoir quelle bibliothèque d'outils est dans le code source, vous pouvez l'ajouter à temps après avoir fait le choix ; 🎜🎜Adresse originale : https://juejin .cn/post/7124112069355372581🎜🎜Auteur : Maître Yi🎜🎜