Angular项目迁移ESLint后所有TS文件首行报错排查

问题原因 #

报错"Definition for rule 'jsdoc/check-alignment' was not found"是因为项目缺少eslint-plugin-jsdoc插件——这个规则属于该插件，并非Angular ESLint自带规则集。

修复步骤 #

1. 安装兼容版本的依赖插件
   由于你使用ESLint 7.x版本，需安装匹配的eslint-plugin-jsdoc（推荐36.x系列）：

   npm install eslint-plugin-jsdoc@^36.1.0 --save-dev
   

   或用yarn：

   yarn add eslint-plugin-jsdoc@^36.1.0 --dev
   

2. 在ESLint配置中注册插件
   在.eslintrc.json（或.eslintrc.js）里，把jsdoc加入plugins数组：

   {
     "plugins": [
       "@angular-eslint",
       "jsdoc"
     ],
     "rules": {
       // 现在可正常将规则设为警告
       "jsdoc/check-alignment": "warn"
     }
   }
   

3. 验证修复效果
   重新运行ng lint，规则会正常识别并以警告形式触发，不再出现"规则未找到"的错误。

补充说明 #

• 之前直接关闭规则能生效，是因为ESLint会忽略未找到规则的关闭指令，但启用（warn/error）时必须确保插件已安装并注册。
• 注意版本兼容性：ESLint 7.x对应eslint-plugin-jsdoc 36.x；ESLint 8.x对应37.x及以上版本，这也是你降级ESLint到7.x后需要匹配的关键点。

内容的提问来源于stack exchange，提问作者peterc