Lit TypeScript启动项目中lint:eslint未捕获隐式any问题排查

你遇到的问题核心是命令行ESLint未启用类型依赖的规则检查，而VS Code插件自动处理了类型信息的读取，所以能检测到隐式any。以下是具体原因和解决步骤：

核心原因 #

@typescript-eslint/no-explicit-any规则在检测隐式any（比如未声明类型的类属性test;）时，需要依赖TypeScript的类型检查信息。如果你的ESLint配置没有正确配置类型检查相关选项，命令行执行时就无法触发该规则。

排查与解决步骤 #

1. 检查lint脚本的命令范围
   打开package.json，确认lint:eslint脚本是否包含TypeScript文件：

   "scripts": {
     "lint:eslint": "eslint . --ext .ts,.tsx,.js,.jsx"
   }
   

   如果只写了eslint .，可能默认只检测.js文件，需要加上--ext参数指定TS扩展名。

2. 完善ESLint配置的类型检查支持
   编辑项目根目录的.eslintrc.json（或其他格式的配置文件），确保包含以下关键配置：

   {
     "parser": "@typescript-eslint/parser",
     "parserOptions": {
       "ecmaVersion": "latest",
       "sourceType": "module",
       // 必须指向你的tsconfig.json，让ESLint读取类型信息
       "project": "./tsconfig.json"
     },
     "plugins": ["@typescript-eslint"],
     "extends": [
       "eslint:recommended",
       // 启用TypeScript基础规则集
       "plugin:@typescript-eslint/recommended",
       // 启用需要类型检查的规则（包含隐式any检测）
       "plugin:@typescript-eslint/recommended-requiring-type-checking"
     ],
     "rules": {
       "@typescript-eslint/no-explicit-any": "error"
     }
   }
   

   重点是parserOptions.project和extends中的recommended-requiring-type-checking，这两个配置是让ESLint能基于TS类型信息检测隐式any的关键。

3. 验证tsconfig.json的文件范围
   确保tsconfig.json的include数组覆盖了你的组件文件，比如：

   {
     "include": ["src/**/*.ts"]
   }
   

   如果目标文件不在include范围内，ESLint无法读取其类型信息，规则就会失效。

4. 检查依赖版本兼容性
   确保eslint和@typescript-eslint/*包的版本匹配（比如@typescript-eslint/eslint-plugin和@typescript-eslint/parser必须同版本）。可以运行以下命令更新到兼容版本：

   npm install eslint@latest @typescript-eslint/eslint-plugin@latest @typescript-eslint/parser@latest --save-dev
   

完成以上配置后，重新运行npm run lint:eslint，应该就能捕获到test属性的隐式any错误了。

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