ESLint の eslint-disable-next-line で警告を抑止できない
eslint-disable-next-line が効かないときは、ルール名をエラー出力末尾の (rule-id) と完全一致させれば直ることが多い。
JSX 内のコメント形式や対象行のずれも原因になる。
公開: 更新:
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)
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:20Debian 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 ドキュメント(新しいタブで開く) を参照しつつ、不要なコメントは消す。
よくある原因
- ルール名が一致していない。
no-unused-varsと@typescript-eslint/no-unused-varsを取り違えるのがその例である。 - JSX 内のコメント形式が違う。
JSX 子要素として書く場合は、{/* ... */}でないと parse されない。 - 対象行がずれている。
空行・別のコメントを挟むと、-next-lineの指す行が変わる。 unused-disableの警告が出ている。
既に違反していない箇所に disable があると、逆に警告される。