できない.dev

Prettier の Tailwind クラス自動ソート (prettier-plugin-tailwindcss) が効かない

prettier-plugin-tailwindcss が効かないときは、plugins 配列に明示して最後に置けば直ることが多い。
Prettier 3 で plugins の自動検出が廃止されたためだ。

公開: 更新:

症状できない · exit 1
npx prettier --write index.html
[error] Cannot find package 'prettier-plugin-tailwindcss' imported from /tmp/tmp.8tdVxOb60g/noop.js

2026-10-07 に node:20(Prettier 3.9.9 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

prettier-plugin-tailwindcss でクラスがソートされない場合、(1) プラグインが入っているか、(2) Prettier 3 系で plugins に明示しているか、(3) tailwind.config の場所、(4) 他プラグインとの順序、を順に確認する。
Prettier 3 から plugins の auto-discover が廃止されたことが、いちばん踏みやすい落とし穴である。

実行例

node:20 の Prettier 3.9.9 では、.prettierrc の plugins に prettier-plugin-tailwindcss を書いたまま未導入だと、Cannot find package で終了コード 1 になった。
npm install -D で入れても、plugins が空の {} のままでは index.html が (unchanged) で、クラスの順は変わらなかった。
plugins に prettier-plugin-tailwindcss を書き直すと、p-4 flex text-red-500 mt-2 items-center が mt-2 flex items-center p-4 text-red-500 に並び替わった。

$ cat .prettierrc
{
  "plugins": ["prettier-plugin-tailwindcss"]
}
$ npx prettier --write index.html
[error] Cannot find package 'prettier-plugin-tailwindcss' imported from /tmp/tmp.8tdVxOb60g/noop.js
$ echo $?
1
$ npm install -D prettier-plugin-tailwindcss
added 1 package in 5s
$ cat .prettierrc
{}
$ npx prettier --write index.html
index.html 15ms (unchanged)
$ cat index.html
<div class="p-4 flex text-red-500 mt-2 items-center"></div>
$ cat .prettierrc
{
  "plugins": ["prettier-plugin-tailwindcss"]
}
$ npx prettier --write index.html
index.html 179ms
$ cat index.html
<div class="mt-2 flex items-center p-4 text-red-500"></div>

— 2026-10-07 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-07 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • Prettier 3.9.9

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. プラグインをインストールする

npm install -D prettier-plugin-tailwindcss

2. Prettier 3 では plugins に明示する

公式 plugins ドキュメント(新しいタブで開く) のとおり、Prettier 3 系は plugins 配列で明示する必要がある。

{
  "plugins": ["prettier-plugin-tailwindcss"]
}

3. tailwind.config の場所を指定する

monorepo で UI パッケージに tailwind.config がある場合は、ルートの設定で参照先を渡す。

{
  "plugins": ["prettier-plugin-tailwindcss"],
  "tailwindConfig": "./packages/ui/tailwind.config.js"
}

4. プラグイン順序を最後にする

プラグイン README(新しいタブで開く) のとおり、prettier-plugin-tailwindcss は他のすべてのプラグインの後に書かないとソート結果が他プラグインで上書きされる。

{
  "plugins": [
    "prettier-plugin-organize-imports",
    "prettier-plugin-tailwindcss"
  ]
}

よくある原因

  1. プラグインが入っていない。
    パッケージそのものをインストールしていない。
  2. Prettier 3 で plugins を指定していない。
    v3 系は plugins 配列に明示的に書かないと読み込まれない。
  3. tailwind.config の検出に失敗している。
    monorepo / 非標準パスでは自動検出できず、tailwindConfig オプションが必要になる。
  4. プラグインの順序が違う。
    organize-imports など他プラグインの後に書かないと、ソート後に再フォーマットされて結果が消える。