简要总结
Bun (Experimental)
这页说明书在讲一个叫 Bun 的新玩具(还在试验阶段)。它有点像另一个“小帮手”,可以帮你更快地运行一些程序。但是,如果你要用它来玩 WhatsApp 或者 Telegram 游戏,我们不推荐哦,可能会有小 bug。平时搭建积木(build)或者用其他工具时,还是用原来的 pnpm 更稳当。
这页适合你想试试新玩具 Bun 的时候看,会告诉你怎么安装、怎么用它来运行和测试,还有哪些地方要小心。
五岁小孩版解释
Bun 是一个还在试验中的新工具,你可以把它想成一个跑得很快的“小帮手”,能直接运行 TypeScript 代码。但是,它现在还不能很好地和 WhatsApp 或 Telegram 一起工作,可能会有奇怪的 bug。所以,如果你要玩这两个应用,最好还是用原来的 Node 小帮手。
安装 Bun 要开始用 Bun 小帮手,你需要先让它认识这个项目里的所有积木块(依赖包)。
- 打开你的终端(就像对电脑下命令的小窗口)。
- 输入
bun install然后按回车。Bun 就会去把需要的积木块都搬过来。- 小心哦:Bun 会自己生成一个叫
bun.lock的小本本来记录它搬了哪些积木,但我们故意不让这个小本本保存到你的项目里,所以不用担心弄乱。 - 如果你连这个小本本都不想让它写,可以输入
bun install --no-save。
- 小心哦:Bun 会自己生成一个叫
用 Bun 来搭建和测试 安装好积木块后,你就可以让 Bun 小帮手帮你干活了。
- 搭建项目:输入
bun run build。这就像对 Bun 说:“请按照图纸,把所有的积木块搭建成一个完整的大城堡!” - 测试项目:输入
bun run vitest run。这就像对 Bun 说:“请检查一下,我们搭好的城堡每个房间都牢固吗?有没有哪里松动了?”
关于“生命周期脚本”的小麻烦 有些积木块(依赖包)自己带了安装前或安装后要执行的小指令(叫“生命周期脚本”)。Bun 小帮手比较谨慎,默认会拦住这些指令,除非你明确告诉它“我相信这个积木块”。
- 在我们这个项目里,被拦住的两个指令其实不重要,不会影响你玩。
- 一个是检查 Node 版本的,我们用的版本已经够新了。
- 另一个只是会发出一些无关紧要的警告。
- 但如果以后你真的遇到了问题,需要允许这些指令,你可以用这个命令告诉 Bun 去信任它们:
bun pm trust @whiskeysockets/baileys protobufjs。
需要注意的事情 Bun 小帮手现在还不是很完美,有些地方要记住:
- 它不认识
pnpm用的那个记录积木块清单的小本本(pnpm-lock.yaml),会直接忽略它。 - 项目里有一些脚本(比如
docs:build,ui:*,protocol:check)还是写死了要用pnpm来运行。如果你要运行这些脚本,记得暂时切换回pnpm命令哦。