できない.dev

ESLint「Could not find "valid-jsdoc" in plugin "@"」の原因と直し方

Could not find "valid-jsdoc" in plugin "@" は、ESLint 9 で本体から消えたルールが設定に残っていると出る。
eslint-plugin-jsdoc の同じ役目のルールに置き換えれば直る。

公開:

症状できない · exit 2
npx eslint src
…
TypeError: Key "rules": Key "valid-jsdoc": Could not find "valid-jsdoc" in plugin "@".
    at throwRuleNotFoundError (/tmp/Kp3b/node_modules/eslint/lib/config/config.js:119:16)
    at Config.validateRulesConfig (/tmp/Kp3b/node_modules/eslint/lib/config/config.js:725:5)
    at new Config (/tmp/Kp3b/node_modules/eslint/lib/config/config.js:581:9)
解決後できた · exit 0
npx eslint src

2026-11-07 に node:24(ESLint 10.14.0 / Node.js 24.22.2) で実際に打って取った出力。検証環境の詳細

要約

TypeError: Key "rules": Key "valid-jsdoc": Could not find "valid-jsdoc" in plugin "@". は、設定の rules に書いたルールが見つからないときに出るエラーだ。
"@" は ESLint 本体のルールの置き場を指す。
valid-jsdoc と require-jsdoc は 2018 年から非推奨で、ESLint 9.0 で本体から消えた。
どのファイルも検査する前に止まり、終了コードは 2 になる。

eslint-plugin-jsdoc の同じ役目のルールに置き換えれば直る。
設定に valid-jsdoc と require-jsdoc の 2 つを書いていても、エラーに出るのは valid-jsdoc だけだ。
valid-jsdoc だけを消して打ち直すと、次は require-jsdoc で止まる。

実行例

node:24 のコンテナで ESLint 10.14.0 を動かすと、設定に 2 つ書いた消えたルールのうち valid-jsdoc だけがエラーに出て、eslint-plugin-jsdoc に置き換えると終了コード 0 で通った。
/opt/ts は typescript-eslint 8.72.1 のプロジェクトで、ban-types も同じ形のエラーになり、置き換え先のルールで通った。

$ cat eslint.config.mjs
import { defineConfig } from "eslint/config";
 
export default defineConfig([
  {
    rules: {
      "valid-jsdoc": "error",
      "require-jsdoc": "error",
    },
  },
]);
$ npx eslint src
Oops! Something went wrong! :(
 
ESLint: 10.14.0
 
TypeError: Key "rules": Key "valid-jsdoc": Could not find "valid-jsdoc" in plugin "@".
    at throwRuleNotFoundError (/tmp/Kp3b/node_modules/eslint/lib/config/config.js:119:16)
    at Config.validateRulesConfig (/tmp/Kp3b/node_modules/eslint/lib/config/config.js:725:5)
    at new Config (/tmp/Kp3b/node_modules/eslint/lib/config/config.js:581:9)
    at [finalizeConfig] (/tmp/Kp3b/node_modules/eslint/lib/config/flat-config-array.js:212:10)
    at FlatConfigArray.getConfigWithStatus (/tmp/Kp3b/node_modules/@eslint/config-array/dist/cjs/index.cjs:1411:55)
    at FlatConfigArray.getConfig (/tmp/Kp3b/node_modules/@eslint/config-array/dist/cjs/index.cjs:1429:15)
    at entryFilter (/tmp/Kp3b/node_modules/eslint/lib/eslint/eslint-helpers.js:325:27)
    at async NodeHfs.<anonymous> (file:///tmp/Kp3b/node_modules/@humanfs/core/src/hfs.js:574:24)
    at async NodeHfs.walk (file:///tmp/Kp3b/node_modules/@humanfs/core/src/hfs.js:614:3)
    at async globSearch (/tmp/Kp3b/node_modules/eslint/lib/eslint/eslint-helpers.js:366:20)
$ echo $?
2
$ npm install -D eslint-plugin-jsdoc
added 35 packages in 3s
$ echo $?
0
$ cat eslint.config.mjs
import { defineConfig } from "eslint/config";
import jsdoc from "eslint-plugin-jsdoc";
 
export default defineConfig([
  {
    plugins: { jsdoc },
    rules: {
      "jsdoc/require-jsdoc": "error",
      "jsdoc/require-param": "error",
      "jsdoc/check-param-names": "error",
      "jsdoc/require-returns": "error",
    },
  },
]);
$ npx eslint src
$ echo $?
0
$ cat eslint.config.mjs
import { defineConfig } from "eslint/config";
import tseslint from "typescript-eslint";
 
export default defineConfig([
  tseslint.configs.recommended,
  {
    rules: { "@typescript-eslint/ban-types": "error" },
  },
]);
$ npx eslint src
Oops! Something went wrong! :(
 
ESLint: 10.14.0
 
TypeError: Key "rules": Key "@typescript-eslint/ban-types": Could not find "ban-types" in plugin "@typescript-eslint".
    at throwRuleNotFoundError (/opt/ts/node_modules/eslint/lib/config/config.js:119:16)
    at Config.validateRulesConfig (/opt/ts/node_modules/eslint/lib/config/config.js:725:5)
    at new Config (/opt/ts/node_modules/eslint/lib/config/config.js:581:9)
    at [finalizeConfig] (/opt/ts/node_modules/eslint/lib/config/flat-config-array.js:212:10)
    at FlatConfigArray.getConfigWithStatus (/opt/ts/node_modules/@eslint/config-array/dist/cjs/index.cjs:1411:55)
    at FlatConfigArray.getConfig (/opt/ts/node_modules/@eslint/config-array/dist/cjs/index.cjs:1429:15)
    at entryFilter (/opt/ts/node_modules/eslint/lib/eslint/eslint-helpers.js:325:27)
    at async NodeHfs.<anonymous> (file:///opt/ts/node_modules/@humanfs/core/src/hfs.js:574:24)
    at async NodeHfs.walk (file:///opt/ts/node_modules/@humanfs/core/src/hfs.js:614:3)
    at async globSearch (/opt/ts/node_modules/eslint/lib/eslint/eslint-helpers.js:366:20)
$ echo $?
2
$ npm ls typescript-eslint
ts@1.0.0 /opt/ts
`-- typescript-eslint@8.72.1
$ cat eslint.config.mjs
import { defineConfig } from "eslint/config";
import tseslint from "typescript-eslint";
 
export default defineConfig([
  tseslint.configs.recommended,
  {
    rules: {
      "@typescript-eslint/no-wrapper-object-types": "error",
      "@typescript-eslint/no-unsafe-function-type": "error",
    },
  },
]);
$ npx eslint src
$ echo $?
0

— 2026-11-07 時点の出力

検証環境Node.js 24.22.2 / npm 11.19.1 / Python 3.11.2 / 2026-11-07 検証(ほか 2 件)
検証日
実行環境
node:24 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 24.22.2
  • npm 11.19.1
  • Python 3.11.2
  • Git 2.39.5
  • ESLint 10.14.0

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

解決策

1. eslint-plugin-jsdoc に置き換える

npm install -D eslint-plugin-jsdoc
import { defineConfig } from "eslint/config";
import jsdoc from "eslint-plugin-jsdoc";
 
export default defineConfig([
  {
    plugins: { jsdoc },
    rules: {
      "jsdoc/require-jsdoc": "error",
      "jsdoc/require-param": "error",
      "jsdoc/check-param-names": "error",
      "jsdoc/require-returns": "error",
    },
  },
]);

require-jsdoc は jsdoc/require-jsdoc が引き継ぐ。
valid-jsdoc が 1 つで見ていた @param の名前や @returns の有無は、jsdoc/check-param-names や jsdoc/require-returns などに分かれている。
対応表は 9.0 の移行ガイド(新しいタブで開く)からたどれる。

2. 名前を確かめる

打ち間違いは、エラーに出た名前をルールの一覧(新しいタブで開く)と照らして直す。
直したら npx eslint を打ち直し、次の名前が出ないことを確かめる。

3. プラグインの消えたルールを置き換える

@typescript-eslint/ban-types は typescript-eslint 8 で消え、no-restricted-types・no-empty-object-type・no-unsafe-function-type・no-wrapper-object-types の 4 つに分かれた(v8 の告知(新しいタブで開く))。
Object や Number を禁じていたなら no-wrapper-object-types を、Function なら no-unsafe-function-type を書く。

よくある原因

  1. 本体から消えたルールが残っている。
    ESLint 8 の設定を flat config に移すとき、rules をそのまま写すと残る。
    ESLint 10.14.0 でも同じ文面で止まった。
  2. ルールの名前を打ち間違えた。
    no-unused-vars を no-unused-var と書くと、Could not find "no-unused-var" in plugin "@". と出る。
  3. プラグインのルールが消えた。
    typescript-eslint 8 で ban-types が消え、Could not find "ban-types" in plugin "@typescript-eslint". と出た。
    "@" の位置に、ルールを探したプラグインの名前が入る。