できない.dev

.prettierignore が効かない/除外したファイルが整形される

.prettierignore が効かないときは、まず除外したファイルを prettier --write に渡して切り分ける。
書き換わらないなら整形の主体はエディタや ESLint で、書き換わるなら配置と glob の順序を見直す。

公開: 更新:

症状できない
npx prettier --write src/generated/api.ts
src/generated/api.ts 32ms
解決後できた · exit 0
npx prettier --write src/generated/api.ts

2026-09-03 に node:20(Node.js 20.20.2 / npm 10.8.2) で実際に打って取った出力。検証環境の詳細

要約

.prettierignore は CLI にファイル名を直接渡した場合にも適用される。
prettier --write src/generated.ts は、そのファイルが除外対象なら書き換えずに終了する。
それでも整形されるなら、整形しているのが Prettier CLI ではないか、ignore ファイルが読まれていない。
実行主体を切り分ける、.prettierignore をルートに置く、glob 順序を見直す、エディタ拡張の prettier.ignorePath を明示する、の 4 点で解消する。

実行例

.prettierignore を src/ に置いたままルートで実行すると読まれず、除外したはずの src/generated/api.ts がそのまま整形される。
--ignore-path で位置を明示した場合と、ルートへ移した場合はどちらも同じコマンドがファイルを書き換えずに終了し、除外が効いていることが分かる。

$ npx prettier --write src/generated/api.ts
src/generated/api.ts 32ms
$ echo $?
0
$ cat src/generated/api.ts
export const x = { a: 1, b: 2 };
$ npx prettier --write --ignore-path src/.prettierignore src/generated/api.ts
$ echo $?
0
$ cat src/generated/api.ts
export const   x = {a:1,b:2}
$ npx prettier --write src/generated/api.ts
$ echo $?
0
$ cat src/generated/api.ts
export const   x = {a:1,b:2}

— 2026-09-03 時点の出力

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

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

解決策

1. 整形しているのが Prettier CLI か切り分ける

# 除外したはずのファイルを直接渡す
npx prettier --write src/generated/api.ts

除外対象なら、このコマンドはファイルを書き換えずに終了する(--check でも検査対象に入らない)。
つまり .prettierignore は明示指定されたファイルにも効く。
にもかかわらず保存時やコミット時に整形されるなら、整形しているのは Prettier CLI ではない。
エディタなら editor.defaultFormatter が Prettier 拡張かを確認する。
ESLint 経由で Prettier を走らせている場合は、公式の Integrating with Linters(新しいタブで開く) が指摘するとおり間に一段挟まる分だけ挙動が読みにくくなるので、除外の設定も ESLint 側で見直す。

2. ルートに置く / --ignore-path で指定

# モノレポでパッケージ固有の ignore を使いたい場合
npx prettier --write --ignore-path packages/web/.prettierignore packages/web

CLI ドキュメント(新しいタブで開く) の --ignore-path は v3 以降で複数指定もできる。

3. glob の順序を見直す

# .prettierignore
**/*.js
# src/utils 配下の .js は整形対象に戻す
!src/utils/**/*.js
dist/
build/

後で書いたルールが勝つ。
除外を「打ち消す」ルールは 対象除外の後 に書く。
コメントになるのは行頭の # だけで、行末に書くとパターンの一部になって打ち消しが効かない。
src/utils/**.js の ** は * と同じ扱いで、src/utils の直下にしか当たらない。

4. VSCode 拡張に ignore パスを教える

// .vscode/settings.json
{
  "prettier.ignorePath": "./.prettierignore",
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.formatOnSave": true
}

モノレポで複数の .prettierignore がある場合、ワークスペースごとに prettier.ignorePath を明示しないと拡張機能が誤った ignore を読みかねない。

よくある原因

  1. 整形しているのが Prettier CLI ではない。
    エディタの editor.defaultFormatter が別の拡張になっているか、ESLint 経由で整形していると、.prettierignore を直しても保存時やコミット時に整形される。
    設定と挙動が食い違って見えるときは、まず実行主体を切り分ける。
  2. .prettierignore の置き場所がずれている。
    Prettier は process.cwd() の .prettierignore を読むので、サブディレクトリで実行すると別の(または存在しない)ignore を見に行ってしまう。
  3. ! を付けた glob の順序が逆になっている。
    後に書いたルールが勝つので、*.js で除外した後に !src/** で復活させる順に書かないと、除外の解除が効かない。
  4. エディタ拡張には独自の挙動がある。
    VSCode の esbenp.prettier-vscode 拡張は基本的に .prettierignore を読むが、ネストしたモノレポでは prettier.ignorePath の明示が必要なことがある。