{"canonical_url":"https://engineer.company/ja/glossary/eslint/","content_markdown":"# ESLint\n\n## どのようなものか\n\nESLintは、JavaScriptのソースコードを読み、設定した規則に照らし、違反する場所を一つずつ報告する、オープンソースの静的解析ツールです。求められれば、簡単なものは自動で修正します。コマンドラインでは`eslint`というコマンドで、検査するプロジェクトの開発用依存パッケージとして、npmからインストールします。Nicholas C. Zakasが2013年6月に始めたプロジェクトで、現在も、自らを設定可能なJavaScriptリンターと紹介しています。\n\n対象のプログラムは、一度も実行しません。パーサーが各ファイルをESTree形式の抽象構文木に変えます。各規則は、小さいモジュールです。関数、比較、`await`など、特定の種類のノードごとに呼ばれるよう要求します。渡されたものを調べ、問題があれば、メッセージと位置を報告します。自動修正を持つ規則もあります。プロジェクトが修正として認めるのは、プログラムの動作を変えずに問題を直す変更だけで、`eslint --fix`がファイルへ適用します。代わりに提案を出す規則もあります。動作を変える場合があるため、人がエディターで一つずつ適用します。\n\nこの中心部分の周りは、ほぼすべて交換できます。プラグインは、規則、共有できる設定、プロセッサー、ほかの言語への対応を追加するnpmパッケージです。別のパーサーを使えば、TypeScriptなど、既定のパーサーが理解しない構文も読めます。プロセッサーは、Markdown文書のコードブロックなど、別のファイルからJavaScriptを取り出します。フォーマッターは、報告の表示方法を変えます。プロジェクト自身が述べる考え方は、各規則が独立し、無効にでき、それぞれの基準で警告や失敗を設定できる、というものです。\n\nすべてを設定するのは、プロジェクトのルートに置く、一つのJavaScriptファイルです。通常は`eslint.config.js`か、`.mjs`、`.cjs`の形式で、オブジェクトの配列をエクスポートします。各オブジェクトが、対象ファイルと、適用する規則、グローバル変数、パーサーのオプションを示し、後のオブジェクトが前を上書きします。この構成をフラット設定と呼び、2024年4月5日のESLint v9.0.0で既定になりました。2026年2月6日公開のESLint v10.0.0は、古い`.eslintrc`形式と`.eslintignore`ファイルを、完全に廃止しました。\n\n## なぜ重要なのか\n\nリンターが役立つ決定的な場面は、変更のマージを止めるときです。ESLintは、終了コードで判断を伝え、その値は重大度に従います。各規則は、`\"off\"`、`\"warn\"`、`\"error\"`のいずれかです。エラーがあれば、コマンドは1で終了します。警告は表示しても、`--max-warnings`で上限を設けなければ、終了コードは0のままです。この上限は、既定では無効です。終了コード2は、設定の不備か内部の異常終了に使います。\n\nつまり、ESLintを使うチームが本当に決めるのは、警告の意味です。ビルドを失敗させない警告は、助言です。端末に四十行も並べば、読み飛ばされます。リンターに基準を守らせたいチームは、必要な規則をすべて`\"error\"`にするか、品質ゲートで`--max-warnings 0`を使います。どちらでも、健全なブランチは、何の指摘もなく検査を通ります。新しい一行が出れば、気付いて読まれる知らせになります。\n\n効果が分かるのは、JavaScriptが通してしまうコードです。宣言のない変数を参照する、オブジェクトリテラルで同じキーを二回定義する、`NaN`を`===`で比較する、`return`の後に実行不能なコードを残す。言語は、こうしたファイルも読み込みます。問題が読み込みを通過して気付かれないことも、実行時に、本番を含めて誤動作を起こすこともあります。ESLintの推奨規則は、四つともレビュー前に検出します。レビューする人は、設計を読むことへ集中できます。\n\n負担もあります。設定には、好みが積み重なります。正しいコードに反応する規則は、出力を読まない習慣を付け、規則がないより悪い結果になります。リンターの価値は、いつ実行するかによっても制限されます。一部のマシンのエディターでしか動かないものは、限られた機会に、一部のコードしか調べません。\n\n## 実際の活用例\n\nESLintは、[六つの言語へ警告ゼロの基準を設けた仕事](/ja/portfolio/set-a-zero-warnings-bar-across-six-languages/)で使った、六つのリンターの一つでした。TypeScriptを担当し、Goのgolangci-lint、SQLのSQLFluff、PythonのRuff、シェルスクリプトのShellCheck、Markdownのmarkdownlintと並びました。基準を支えたのは、重大度について、全員に共通する答えを一度に決めたことです。すべての指摘はエラーで、逃げ込める「warn」の段階はなく、コード内の抑制指定は禁止しました。コミット前とプッシュ前のフックが、リンターとテストを実行します。対象となる規則やテストに違反すると、対応するコミットまたはプッシュを止めます。\n\n同じリポジトリには、その後、公開パッケージにはない規則も必要になりました。そのコードベース特有の作り方を守る規則です。[独自のESLint規則十五個で、TypeScriptのプロジェクト固有のパターンを守りました](/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/)。ほかに274個の検査スクリプトがあり、268個をコミットフックへ登録しました。一つのバリデーターは、コード内の抑制指定を、気付かれないまま追加していないかを確かめます。検査機構自体にも、146個のテストがあります。壊れた検査は、すべてを通し、誰も気付かないためです。事例は代償も明記します。コミットに時間がかかります。\n\nこのサイトも、より小さい規模で、ビルドスクリプトに同じ基準を適用します。`eslint.config.mjs`は`js.configs.recommended`から始め、測定時に、コードがすでに満たしていた規則だけを加えます。コメントには、2026-10-15に、非推奨に指定されていない199個の規則全体を再測定し、好みではなく正しさを調べる規則を、さらに21個有効にした記録があります。すべての規則は、違反をエラーとします。既定では警告の`reportUnusedDisableDirectives`も、エラーへ上げます。何も抑制しなくなった無効化コメントが、検査を失敗させるためです。スクリプトは、Nodeとブラウザーのグローバル変数を、両方宣言します。`page.evaluate`へ渡す関数本体は、Nodeで動くコードの数行隣にあっても、ブラウザー内で動くためです。\n\n## 問題が起きるところ\n\nESLintの問題の多くは、リンターが、設定どおりに動いていることです。その設定の意味が、チームの理解と一致するとは限りません。\n\n**ビルドは緑なのに、端末が警告で埋まります。** 警告では終了コードが0のままなので、継続的インテグレーションは通ります。一覧は毎週数行ずつ増え、やがて本物の欠陥が、読まれないまま紛れ込みます。必要な規則を決め、`\"error\"`にし、ほかは無効にします。品質ゲートに`--max-warnings 0`も加え、警告を蓄積できなくします。\n\n**無効化コメントだけが、理由を失って残ります。** かつて正当な理由で、その行の指摘を抑えました。下のコードが変わってもコメントは残り、その行の次の問題を隠すか、何も抑えなくなります。`linterOptions.reportUnusedDisableDirectives`を`\"error\"`にし、何も抑えない指定が検査を失敗させるようにします。残すものには、`--`の後に理由を求め、レビューで判断できるようにします。\n\n```js\n// eslint-disable-next-line no-console -- 出力を表示するのがこのCLIの役割\nconsole.log(report);\n```\n\n**更新で、検査するファイルが変わります。** v10へ移ると、`.eslintignore`で除外していたパスが、突然報告されたり、一つのフォルダーが違う規則に従い始めたりします。バージョン10は、`.eslintrc.*`も`.eslintignore`も使いません。検査するファイルごとに、そのファイルのディレクトリーから`eslint.config.*`を探します。そのため、サブフォルダーに残った予定外の設定が、そのフォルダーに適用されます。除外は、グローバルな`ignores`項目へ移します。`npx @eslint/migrate-config .eslintrc.json`で古いファイルを変換し、出力をレビューします。その後、ツリー内のすべての`eslint.config.*`を一覧にし、残すつもりのなかったものを削除します。\n\n**ブラウザーのコードが、未定義と報告されます。** ブラウザーへ関数を渡すNodeスクリプトで、`document`や`window`に`no-undef`エラーが出ます。そこで`no-undef`を無効にすると、本物のタイプミスも隠れます。各ファイルが実際に動くすべての環境を、`languageOptions.globals`で、そのファイルに対して宣言します。\n\n**独自の規則が、すべてを通します。** 規則のビジターが、対象のコードに一度も現れない種類のノードを指定したり、条件が逆だったりすると、何も報告しません。沈黙は、規則を守った結果と同じに見えます。各独自規則をESLintの`RuleTester`で試し、通るべきコードと、失敗すべきコードを渡します。報告しなくなった規則が、コードベースを守れなくなる前に、自分のテストで失敗するようにします。\n\n## 参考資料\n\n- [基本概念](https://eslint.org/docs/latest/use/core-concepts/)\n  — プロジェクトが定義する、規則、修正、プラグイン、パーサー、プロセッサーです。\n- [設定ファイル](https://eslint.org/docs/latest/use/configure/configuration-files)\n  — フラット設定の配列、ファイルパターン、グローバルな除外、オブジェクトの結合方法です。\n- [規則の設定](https://eslint.org/docs/latest/use/configure/rules)\n  — 重大度、規則のオプション、特定の行で規則を無効にするコメントです。\n- [コマンドラインインターフェースのリファレンス](https://eslint.org/docs/latest/use/command-line-interface)\n  — `--max-warnings`を含むすべてのオプションと、各終了コードの意味です。\n- [ESLint v10.0.0公開](https://eslint.org/blog/2026/02/eslint-v10.0.0-released/)\n  — eslintrcの廃止と、新しい設定の探索方法を説明するリリースノートです。\n- [独自規則](https://eslint.org/docs/latest/extend/custom-rules)\n  — 構文木を調べる規則を書き、`RuleTester`で確かめる方法です。\n\n\u003chttps://engineer.company/ja/glossary/eslint/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"ESLintがJavaScriptの構文木を調べる仕組みを解説します。警告でビルドを失敗させる条件と、設定の変化で検査対象が気付かないうちに減る原因も説明します。","formats":{"gemtext":"https://engineer.company/ja/glossary/eslint/index.gmi","gopher":"https://engineer.company/ja/glossary/eslint/gophermap","html":"https://engineer.company/ja/glossary/eslint/","json":"https://engineer.company/ja/glossary/eslint/index.json","markdown":"https://engineer.company/ja/glossary/eslint/index.md","pdf":"https://engineer.company/ja/glossary/eslint/index.pdf"},"kind":"page","language":"ja","title":"ESLintとは？","url":"https://engineer.company/ja/glossary/eslint/","version":1}