できない.dev

ESLint のプラグインで「Cannot find module」が出る原因と直し方

Cannot find module 'eslint-plugin-xxx' は、プラグインのインストール漏れや綴り違いで出る。
npm install -D で入れ、flat config では import して渡せば直る。

公開: 更新:

症状できない · exit 2
npx eslint app.js
…
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'eslint-plugin-example' imported from /tmp/tmp.eacOnUII1s/eslint.config.mjs
    at packageResolve (node:internal/modules/esm/resolve:873:9)
    at moduleResolve (node:internal/modules/esm/resolve:946:18)
    at defaultResolve (node:internal/modules/esm/resolve:1188:11)
解決後できた · exit 0
npx eslint app.js

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

要約

「Cannot find module 'eslint-plugin-xxx'」が出るときは 依存インストール・命名・flat config 記法 の 3 点でほぼ片付く。
ESLint v9 以降は flat config が既定になり、プラグインは文字列で指定せず、オブジェクトを直接 import して渡す形に変わった。

実行例

node:20 環境で上記の手順を動かすと、eslint-plugin-example を未インストールのまま flat config で文字列 import しようとした時点で Cannot find package 'eslint-plugin-example' が発生した(ESLint の終了コードは 2)。
プラグインをオブジェクトとして直接渡す形に書き直すと、終了コードは 0 に変わった。

v9.39.5
$ npx eslint app.js
Oops! Something went wrong! :(
 
ESLint: 9.39.5
 
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'eslint-plugin-example' imported from /tmp/tmp.eacOnUII1s/eslint.config.mjs
    at packageResolve (node:internal/modules/esm/resolve:873:9)
    at moduleResolve (node:internal/modules/esm/resolve:946:18)
    at defaultResolve (node:internal/modules/esm/resolve:1188:11)
    at ModuleLoader.defaultResolve (node:internal/modules/esm/loader:708:12)
    at #cachedDefaultResolve (node:internal/modules/esm/loader:657:25)
    at ModuleLoader.resolve (node:internal/modules/esm/loader:640:38)
    at ModuleLoader.getModuleJobForImport (node:internal/modules/esm/loader:264:38)
    at ModuleJob._link (node:internal/modules/esm/module_job:168:49)
$ echo $?
2
$ npx eslint app.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. インストールを確認する

npm install -D eslint-plugin-import
npm ls eslint-plugin-import   # 実際に解決されているか確認

npm ls が (empty) を返す場合、別ワークスペースに入っているか、node_modules 破損の可能性が高い。

2. flat config で書き直す

公式のプラグイン設定ドキュメント(新しいタブで開く) のとおり、import してオブジェクトとして登録する。

import importPlugin from "eslint-plugin-import";
 
export default [
  {
    plugins: {
      import: importPlugin,
    },
    rules: {
      "import/no-unresolved": "error",
    },
  },
];

旧形式 (.eslintrc.json) からの移行は 公式の設定ファイル解説(新しいタブで開く) を参照する。

3. monorepo 構成での確認

pnpm why eslint-plugin-import

hoist や workspace 設定で resolve できないなら、ルートにも明示的に dev dep として追加すると解決することが多い。

よくある原因

  1. プラグインのインストールが漏れている。
    package.json に書いてあっても npm install が走っていないか、別ワークスペースに入っている。
  2. プラグイン名にタイプミスがある。
    eslint-plugin-import を eslint-plugins-import と書いたり、スコープ付きの名前(@typescript-eslint/eslint-plugin)を書き間違えたりしている。
  3. flat config の記法が違う。
    旧 .eslintrc.json の "plugins": ["foo"] を、新しい eslint.config.js にそのまま持ち込んでいる。
  4. monorepo で、ルートからプラグインが見えない。
    pnpm の strict hoist や Yarn workspace の resolve 設定によって起きる。
  5. バージョンが合っていない。
    ESLint v9 と、それに対応していないプラグインを組み合わせている。