Ubuntu系统IntelliJ 2023.1中ESLint加载eslint-plugin-jsdoc失败求助

排查与修复步骤 #

• 清理依赖并重装
  删除项目目录下的node_modules、package-lock.json（或yarn.lock）文件，重新安装依赖：

  rm -rf node_modules package-lock.json
  npm install
  

  用yarn的话执行：

  rm -rf node_modules yarn.lock
  yarn install --force
  

• 校验版本兼容性
  打开项目的package.json，核对eslint与eslint-plugin-jsdoc的版本号，两者版本不匹配是常见诱因。确认兼容范围后调整版本：

  # 示例：降级eslint-plugin-jsdoc到兼容版本
  npm install eslint-plugin-jsdoc@39.6.0 --save-dev
  

• 重置IDE的ESLint配置
  打开IntelliJ的File > Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint，选择Automatic ESLint configuration，点击Apply后重启IDE。若之前手动指定过路径，改回自动检测。

• 检查Node.js版本
  部分ESLint插件对Node.js版本有要求，用node -v查看当前版本，若不符合插件要求，可通过nvm切换：

  # 安装nvm（未安装时执行）
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  # 切换到18.x版本（示例）
  nvm install 18
  nvm use 18
  

• 临时禁用插件排查
  在项目的.eslintrc（或.eslintrc.json）中临时禁用jsdoc插件规则，验证ESLint是否能正常加载：

  {
    "plugins": ["jsdoc"],
    "rules": {
      "jsdoc/*": "off"
    }
  }
  

  若恢复正常，再逐一开启规则定位具体出错的规则项。

额外提示 #

• 确保IntelliJ的ESLint插件为最新版，打开Settings > Plugins搜索ESLint，检查并安装更新。
• 若项目使用TypeScript，同步校验@typescript-eslint/eslint-plugin与ESLint的版本兼容性。

内容的提问来源于stack exchange，提问作者Péter Békési