Bun 1.4.4 的 bun fmt:先跑 --check,再谈替换 Prettier

举报
yd_225649965 发表于 2026/11/14 01:11:12 2026/11/14
【摘要】 Bun 1.4.4 的 bun fmt:先跑 --check,再谈替换 PrettierBun 1.4.4(2026 年 10 月 22 日发布)把格式化器收进了运行时:bun fmt。它不是又一个"更快但输出不一样"的格式化器——官方的卖点恰恰是输出与 Prettier 一致:读你现有的 Prettier 或 oxfmt 配置,跑 Prettier 自己的测试集,9648/9731 个用例...

Bun 1.4.4 的 bun fmt:先跑 --check,再谈替换 Prettier

Bun 1.4.4(2026 年 10 月 22 日发布)把格式化器收进了运行时:bun fmt。它不是又一个"更快但输出不一样"的格式化器——官方的卖点恰恰是输出与 Prettier 一致:读你现有的 Prettier 或 oxfmt 配置,跑 Prettier 自己的测试集,9648/9731 个用例输出字节级相同(99.1%)。在 Prettier 自己的仓库(2616 个文件)上,bun fmt --check 只要 59.7 毫秒,Prettier 3.9.10 要 17.1 秒,内存 48MB 对 459MB。

数字很抓眼球,但迁移格式化器最怕的不是慢,而是悄悄改掉几百个文件的格式、污染 diff。本文不聊基准测试,只讲一条落地路线:先用不写盘的命令验,再决定要不要换。

第一步:装成本地依赖,别急着换全局

bun fmt 只在 1.4.4 及以后才有,1.4.3 跑这个命令会直接报不存在。先把它装成项目的开发依赖,版本锁死,别动全局的 Bun:

npm install --save-dev bun@1.4.4
npx bun --version   # 应为 1.4.4

锁版本的原因很现实:格式化器的输出就是它的版本签名。团队里有人用 1.4.4、有人用更新的版本,同一份代码可能格式化出两种结果,CI 门禁会无缘无故变红。等团队统一版本再谈别的。

第二步:先跑 --check,它什么都不改

--check 只检查、不写盘,是试用成本最低的命令。先拿一个故意写乱的小文件试手:

// demo.ts
const   greeting
=
"hello"
console.log( greeting )

再配一个最小的 Prettier 配置:

// .prettierrc.json
{ "semi": true, "singleQuote": false }
npx bun fmt --check demo.ts
echo $?   # 1:文件需要格式化,但文件本身没被动过

退出码是这条命令最值得记住的部分:

  • 0:已符合格式,什么都不用做;
  • 1:文件需要格式化,内容未改动;
  • 2:遇到不支持的插件或语法错误,命令拒绝继续。

先在 CI 里只加 --check,不加写盘的 bun fmt。这样团队可以先看到"有多少文件不符合",而不必当天就全仓重排。等大家对差异达成共识,再决定是否批量格式化一次并单独提交。

验证通过后,格式化并复查幂等性:

npx bun fmt demo.ts
npx bun fmt --check demo.ts   # 应返回 0
npx bun fmt demo.ts           # 再跑一次,文件不应再变化

第二次运行没有变化,说明格式化是幂等的——同一份输入反复格式化结果稳定,这是把它放进 pre-commit 钩子的前提。

第三步:核对配置是不是真的被读进去了

bun fmt 会读 .prettierrc*、prettier.config.* 以及 package.json 里的 prettier 字段。最容易翻车的点是:仓库里同时存在多个配置源。Prettier 的配置查找有优先级,bun fmt 沿用同一套规则,但如果你的配置藏在 package.json 的某个字段里、或者用了需要插件才能解析的配置格式,它可能静默地按默认配置跑。

验证办法很直接:改一个看得见的配置项再跑一次。比如把 semi 从 true 改成 false,跑 bun fmt --check,看它报的差异是不是按无分号的风格来。如果配置没生效,检查结果会和你预期的风格对不上——在全仓跑之前发现这个问题,比在几百个文件的 diff 里发现要便宜得多。

另外三个常用插件是内置的,不用再装:

  • prettier-plugin-tailwindcss:按项目里的 Tailwind v3/v4 排序 class;
  • prettier-plugin-packagejson:按固定键序整理 package.json,值不动;
  • prettier-plugin-svelte:默认格式化 .svelte,对齐 4.1.1 的行为。

如果你的配置用了别的插件(比如 prettier-plugin-jsdoc),bun fmt 会打印插件名、跳过受影响的文件,然后以退出码 2 退出。它不会悄悄用默认行为代替插件,这是好事——失败是显性的。但也意味着:插件清单要先盘一遍,别等 CI 红了才发现。

第四步:理解"有意不同"的两处

Bun 的迁移文档写明了一条原则:"bun fmt 与 Prettier 3 输出的任何差异都是 bug"——但有例外。官方文档列出了一类有意差异:某些输入经过 Prettier 格式化后会改变代码语义,bun fmt 会保留语义。也就是说,在这些边界输入上,两者输出不一样是设计如此,不是 bug。

落地的含义是:别把"和 Prettier 输出逐字节相同"当成迁移的验收标准。更实际的验收标准是三条:

  1. --check 在 CI 里跑通,退出码符合预期;
  2. 对同一批文件,bun fmt 与 Prettier 的差异可数、可解释(用 --debug-check 看);
  3. 格式化后测试套件照常通过。

--debug-check 值得单独提一句:它会在格式化后重新解析,校验语义没有被改掉。怀疑某次格式化"改坏了东西"时,先跑它,而不是凭感觉回滚。

第五步:只格式化改动的文件

全仓一次性格式化是最容易后悔的操作:几千个文件的 diff 会把 git blame 冲掉,Code Review 也没法看。更稳的做法是只格式化本次改动的文件,Bun 为此准备了 --staged:

npx bun fmt --staged   # 只格式化已暂存的文件,并重新暂存改动

把它放进 pre-commit 钩子(配合 lint-staged 一类工具只传改动文件也行),新代码按新格式走,老代码保持原样。等老文件自然被改动、被格式化,格式会随时间收敛,而不需要一次性的全仓提交。

一份迁移检查清单

  • [ ] 锁定 bun@1.4.4(或团队统一的更新版本)为开发依赖;
  • [ ] 先在 CI 加 bun fmt --check,只检查不写盘;
  • [ ] 核对配置真的被读进去了(改一个可见项验证);
  • [ ] 盘点 Prettier 插件清单,确认没有 bun fmt 不支持的;
  • [ ] 用 --debug-check 抽查边界文件,确认语义未变;
  • [ ] pre-commit 只格式化改动文件(--staged),不全仓重排;
  • [ ] 格式化后跑一遍测试套件,再合入。

结论

bun fmt 真正有价值的不是 286 倍这个数字——格式化在大多数项目里本来也不是瓶颈。它的价值在于把格式化器收进运行时之后,工具链少了一个需要单独安装、单独升级、单独配插件的环节。Prettier 兼容意味着迁移成本主要是验证成本,不是重写成本。

但"兼容"不等于"无脑替换"。先 --check、再核对配置、再小范围试,最后才决定要不要把 Prettier 从依赖里拿掉。格式化器换错了,代价不是一次 CI 变红,而是整个仓库的 diff 历史被污染。这个顺序,值得按部就班走一遍。


实测注记:本文的 --check / 格式化 / 幂等性步骤已在 bun 1.4.4 上实际跑过:未格式化文件 --check 退出码 1,格式化后为 0,二次格式化文件 md5 不变,--debug-check 退出码 0。286 倍、99.1% 等基准数字引自 Bun 官方发布说明与第三方对照实测,非本文复测。

参考:Bun 官方发布说明《Bun v1.4.4》(bun.com/blog/bun-v1.4.4);第三方对照实测:1326 个文件上 bun fmt --check 约 0.2 秒、Prettier 约 31 秒(gleamhub.net)。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。