できない.dev

ESLint と Prettier の競合でフォーマットできない

ESLint と Prettier の整形ルールが衝突すると、保存→フォーマット→ESLint→再差分のループになる。
eslint-config-prettier で重複ルールを切り、整形は Prettier に一本化するのが定石。

公開: 更新:

症状できない · exit 1
npx eslint sample.js
/tmp/tmp.S27BK28wWD/sample.js
  1:11  error  Strings must use doublequote  quotes

✖ 1 problem (1 error, 0 warnings)
  1 error and 0 warnings potentially fixable with the `--fix` option.
解決後できた · exit 0
npx eslint sample.js

2026-11-15 に node:20(ESLint 9.39.5 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

ESLint と Prettier の競合は、両方が「整形」を担当しているときに発生する。
解決の原則は、整形を Prettier に一本化し、ESLint には論理ルールだけを任せることである。
公式の Integrating with Linters(新しいタブで開く) が推す構成は、eslint-config-prettier を入れて重複ルールを無効化するものだ。

実行例

node:20 環境で上記の手順を動かすと、eslint-config-prettier 未導入の状態では ESLint の quotes ルールがシングルクォートをエラーとして検出し、終了コード 1 を返した。
flat config の末尾に eslint-config-prettier を展開すると、終了コードは 0 になり、競合は解消した。

v9.39.5
$ npx eslint sample.js
/tmp/tmp.S27BK28wWD/sample.js
  1:11  error  Strings must use doublequote  quotes
 
✖ 1 problem (1 error, 0 warnings)
  1 error and 0 warnings potentially fixable with the `--fix` option.
$ echo $?
1
$ npx eslint sample.js
$ echo $?
0

— 2026-11-15 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-11-15 検証(ほか 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
  • ESLint 9.39.5

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

解決策

1. eslint-config-prettier を導入

npm install --save-dev eslint-config-prettier

flat config では末尾で展開する。

// eslint.config.js
import js from "@eslint/js";
import eslintConfigPrettier from "eslint-config-prettier";
 
export default [
  js.configs.recommended,
  // プロジェクト固有ルール
  eslintConfigPrettier,
];

これで Prettier と競合する ESLint ルールが一括 off になる。

2. eslint-plugin-prettier を外す

ESLint 経由で Prettier を走らせると警告として表示・自動修正されるが、整形のたびに再 lint が走り、体感が遅くなる。
整形は prettier --write または IDE 統合に任せる。

npm uninstall eslint-plugin-prettier

CI では並列で走らせる。

npx prettier --check .
npx eslint .

3. エディタの整形担当を固定

.vscode/settings.json に明示する。

{
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit"
  }
}

保存時は ESLint の autofix が先に走り、続けて Prettier が整形する。
整形系のルールは eslint-config-prettier で切ってあるので、この順序でも競合しない。

4. .prettierrc を真の正に

.prettierrc.json を一箇所に置き、ESLint 側からは semi / quotes / indent / comma-dangle などの整形ルールを削除する。
残すのは no-unused-vars / no-undef のような論理ルールだけにする。
これで「どちらが正か」の議論が消える。

よくある原因

  1. eslint-config-prettier を入れていない。
    ESLint 側の semi / quotes / indent などの整形系ルールが残り、Prettier の出力を弾く。
  2. eslint-plugin-prettier で Prettier を二重に実行している。
    ESLint 内部から Prettier を走らせると、保存ごとに差分が再計算されて表示が揺れる。
  3. エディタの設定が競合している。
    editor.formatOnSave と ESLint の source.fixAll.eslint が両方有効だと、順序が安定しない。
  4. 設定ファイルの値がずれている。
    .prettierrc と eslint.config.js で、singleQuote や printWidth が食い違っている。