2児のパパ系Webエンジニア
の開発日記
A Dad-of-Two Engineer's Development Diary

Bun 1.4.4のbun fmtでPrettierを置き換え!--stagedでlint-staged不要、.astroだけは要注意

Bun 1.4.4のbun fmtでPrettierを置き換え!--stagedでlint-staged不要、.astroだけは要注意

🙌 結論から

2026年10月22日に出た Bun v1.4.4 で、Prettier 互換のフォーマッター bun fmt が入りました!

.prettierrc をそのまま読んでくれるので、JS / TS 中心のプロジェクトならコマンドを差し替えるだけでほぼ移行できます。

さらに bun fmt --staged でコミット対象のファイルだけを整形して再ステージまでしてくれるので、pre-commit 用の lint-staged も外せます(^^)

ただし、.astro のように Prettier のプラグインで整形している言語は、インストール済みの Prettier に処理が回されます。

なのでこのブログのような Astro のリポジトリだと、**Prettier を「完全に消す」のではなく「CI とフックの主役を交代する」**くらいの気持ちで入れるのがちょうどいいと思います。

💡 bun fmtで何が変わるのか

一番大きいのは、Prettier の設定ファイルを読み替えなしで使えるところです。

読んでくれるのは次のあたりです。

  • .prettierrc* / prettier.config.* / package.json の "prettier" キー
  • overrides・.editorconfig・.prettierignore
  • oxfmt の設定(.oxfmtrc.json など)
  • Bun 独自の bunfig.toml の [fmt] セクション

公式のリリースノートによると、Prettier 自身のテスト 9,731 件のうち 9,648 件(99.1%)でバイト単位まで同じ出力になったそうです👀

速さも公式ベンチの数字ですが、Prettier のリポジトリ(2,616ファイル)を --check したときに bun fmt が 59.7ms、Prettier 3.9.10 が 17.1秒とのこと。

正直、桁が違いすぎて笑いました笑

対応している言語も JS / TS / JSX のほかに CSS・SCSS・HTML・Vue・Svelte・JSON・YAML・TOML・Markdown・MDX・GraphQL まで入っています。

prettier-plugin-tailwindcss・prettier-plugin-packagejson・prettier-plugin-svelte は Bun 側で作り直されているので、plugins に書いたままで大丈夫です🙌

👀 乗り換えは5ステップで終わる

公式の移行ガイドの流れをまとめると、こうなります。

  1. bun fmt --doctor で、Bun が設定をどう解釈するかを確認する(ファイルは書き換えない)
  2. package.json の prettier --write . を bun fmt、prettier --check . を bun fmt --check に置き換える
  3. CI と Git フックも同じように置き換える
  4. bun fmt --check で差分が出ないか確かめる
  5. もう一度 --doctor を見て、使われなくなった Prettier まわりのパッケージを bun remove する

bun fmt は何も指定しなくても書き込みで、対象もカレントディレクトリになります。

なので --write . は要りません。

CI では bun fmt --check を使います。

整形が必要なファイルがあれば終了コード1、構文エラーなどの失敗は2で返ってくるので、ここは Prettier の感覚のままで大丈夫です(`・ω・´)

ここで最初につまずきやすいのが、package.json に fmt という名前のスクリプトがある場合です。

そのときの bun fmt はフォーマッターではなく、そのスクリプトの方を実行してしまいます(・_・;)

昔 "fmt": "prettier --write ." みたいに書いていたリポジトリは、先にスクリプト名を変えておくと安心です。

🔧 私ならこう設定する

Laravel + TypeScript みたいな構成で、フロント側だけ Prettier を使っているリポジトリを想定した設定です。

まず package.json のスクリプトはこれだけ。

{
  "scripts": {
    "format": "bun fmt",
    "format:check": "bun fmt --check"
  }
}

bun format は今までどおり format スクリプトを実行するので、チームの人の打つコマンドは変わりません👍

pre-commit フックは、lint-staged を外してこの1行にします。

#!/bin/sh
bun fmt --staged

--staged は、コミットしようとしているファイルだけを整形してもう一度ステージしてくれるオプションです。

ここで1つ気をつけたいのが、同じファイルに「ステージ済みの変更」と「まだステージしていない変更」が混ざっているときです。

この場合 Bun はファイルを書き換えず、整形が必要ならファイル名を出して終了コード2で止まります。

勝手に未ステージの変更までコミットに混ぜないための動きなので、止まったら git add -p で分けてからもう一度コミットすれば大丈夫です(^^)

もう1つ、自作のシェルスクリプトで git diff --name-only | xargs bun fmt のように書いている場合も要注意です。

Prettier は引数が空だとエラーになりますが、bun fmt は引数なしだとカレントディレクトリ全体を整形します。

ファイル一覧が空になりうるなら xargs -r を付けるか、素直に --staged を使うのが安全です。

PR を出す前にまとめて揃えたいときは、デフォルトブランチとの差分だけを整形する --changed も便利です。

bun fmt --changed=origin/develop

設定を bunfig.toml に寄せたい場合は、Prettier と同じ名前のオプションがそのまま使えます。

[fmt]
printWidth = 100
singleQuote = true

[[fmt.overrides]]
files = ["*.test.ts", "scripts/**"]
options = { printWidth = 120 }

ただ、私なら最初は .prettierrc を残したまま切り替えます。

エディタの Prettier 拡張も同じ設定を読むので、保存時の整形とコミット時の整形がズレないからです。

🤔 .astroとエディタはPrettierを残す

ここが一番のハマりどころかも・・・!

bun fmt に入っていないプラグインで整形する言語(Astro など)は、プロジェクトにインストールされている Prettier に処理が渡されます。

つまり prettier-plugin-astro を使っているリポジトリで Prettier を bun remove してしまうと、.astro だけ整形されなくなります(´・ω・`)

どのファイルが Prettier 行きになるかは bun fmt --doctor で一覧が出るので、消す前に一度見ておくのがおすすめです。

また、Bun が対応していないプラグイン(例: prettier-plugin-jsdoc)を plugins に書いていると、そのプラグインの対象ファイルを飛ばして終了コード2になります。

プラグインなしで整形してよければ --allow-unsupported を付ければ通ります。

エディタ側も同じで、VS Code の Prettier 拡張や eslint-plugin-prettier は Prettier 本体を呼んでいます。

これらを使い続けるなら prettier は devDependencies に残しておく、が公式の案内です。

CI とフックは bun fmt、エディタと .astro は Prettier、という分担が今のところ一番トラブルが少ないと思っています✨

🔗 関連記事と使い分け

パパ系Webエンジニア〜愛用ガジェット一覧 🛍️

この記事を書いている作業環境のガジェットを楽天ROOMにまとめています ✨ 在宅エンジニアのデスク作りの参考にどうぞ 🙌

🎉 まとめ

bun fmt は、.prettierrc を読んでくれる・速い・--staged でフックが1行になる、の3つがそろっていて、乗り換えのハードルがかなり低いです。

もう当たり前感あるけど、整形ツールの速さって CI の待ち時間だけじゃなく、コミットするたびの小さなストレスまでかなり変わるんですよね。

一方で、Astro のようなプラグイン頼みの言語とエディタ連携では、まだ Prettier の出番が残ります。

なので私なら、まず CI の --check と pre-commit の --staged だけ差し替えて、--doctor を見ながら少しずつ Prettier まわりを減らしていきます🙌

みんなはフォーマッター、もう乗り換えた?まだ Prettier 派?

※ バージョン番号・料金・機能は今後も変わる可能性があります。最新情報は Bun公式ドキュメント をご確認ください👀

参考になったらシェアしてもらえるとうれしいです🙌

Xでポスト Threads はてブ LINE