できない.dev

ESLint の eslint-disable-next-line で警告を抑止できない

eslint-disable-next-line が効かないときは、ルール名をエラー出力末尾の (rule-id) と完全一致させれば直ることが多い。
JSX 内のコメント形式や対象行のずれも原因になる。

公開: 更新:

症状できない · exit 1
npx eslint wrong.js
/tmp/tmp.R5Yc0v3pSB/wrong.js
  1:1  error  Definition for rule '@typescript-eslint/no-unused-vars' was not found  @typescript-eslint/no-unused-vars
  2:7  error  'unused' is assigned a value but never used                            no-unused-vars

✖ 2 problems (2 errors, 0 warnings)
解決後できた · exit 0
npx eslint fixed.js

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

要約

eslint-disable-next-line が効かないときの原因は、(1) ルール名の不一致、(2) JSX のコメント形式違反、(3) 対象行とのずれ、(4) --report-unused-disable-directives 由来の警告、のいずれかである。
公式の disabling rules ドキュメント(新しいタブで開く) に沿ってルール名とコメント位置を見直す。

実行例

node:20 環境で上記の手順を動かすと、誤ったルール名(@typescript-eslint/no-unused-vars)を .js ファイルに指定した場合は、ルール定義が見つからないエラーが追加で発生し、終了コード 1 になった。
エラー出力の (rule-id) と完全一致させた場合は、終了コード 0 で抑止が成功した。

v9.39.5
$ npx eslint wrong.js
/tmp/tmp.R5Yc0v3pSB/wrong.js
  1:1  error  Definition for rule '@typescript-eslint/no-unused-vars' was not found  @typescript-eslint/no-unused-vars
  2:7  error  'unused' is assigned a value but never used                            no-unused-vars
 
✖ 2 problems (2 errors, 0 warnings)
$ echo $?
1
$ npx eslint fixed.js
$ echo $?
0

— 2026-11-12 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-11-12 検証(ほか 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. ルール名を完全一致させる

エラー出力の末尾には (rule-id) が付く。
それをそのままコピーする。

// eslint-disable-next-line @typescript-eslint/no-unused-vars
const _unused = 1;

no-unused-vars (素のもの) と @typescript-eslint/no-unused-vars は別ルールなので、TypeScript プロジェクトでは後者を指定する。

2. JSX 内では JSX コメント形式を使う

return (
  <div>
    {/* eslint-disable-next-line react/no-unescaped-entities */}
    <p>It's working</p>
  </div>
);

JS の // 形式は JSX 子要素位置では構文エラーになるか、コメントとして処理されず効かない。

3. 対象行の直前に置く

// eslint-disable-next-line no-console
console.log("debug");   // ← 直前の disable が効く

空行や別コメントを挟むと、-next-line が指す行がずれて抑止されない。

4. 不要な disable を削除する

eslint --report-unused-disable-directives を CI で有効にしておくと、すでに違反していない箇所の disable が逆に警告される。
CLI ドキュメント(新しいタブで開く) を参照しつつ、不要なコメントは消す。

よくある原因

  1. ルール名が一致していない。
    no-unused-vars と @typescript-eslint/no-unused-vars を取り違えるのがその例である。
  2. JSX 内のコメント形式が違う。
    JSX 子要素として書く場合は、{/* ... */} でないと parse されない。
  3. 対象行がずれている。
    空行・別のコメントを挟むと、-next-line の指す行が変わる。
  4. unused-disable の警告が出ている。
    既に違反していない箇所に disable があると、逆に警告される。