加载@typescript-eslint/dot-notation规则报错需配置parserOptions.project如何解决

该报错的核心原因是@typescript-eslint/dot-notation规则需要依赖TypeScript类型解析服务，必须将ESLint与项目的tsconfig配置关联才能正常运行。

步骤1：调整ESLint配置 #

找到项目根目录下的ESLint配置文件（.eslintrc.js、.eslintrc.json等任意你正在使用的格式），新增parserOptions.project配置：

若使用.js格式配置 #

module.exports = {
  // 原有其他配置保留
  parser: '@typescript-eslint/parser',
  parserOptions: {
    // 指向项目根目录的tsconfig.json文件
    project: './tsconfig.json',
    // 存在多份tsconfig时可使用数组配置，例如 ['tsconfig.json', 'tsconfig.node.json']
    tsconfigRootDir: __dirname, // 可选配置，避免ESLint识别tsconfig路径出错
  },
  plugins: ['@typescript-eslint'],
  // 原有rules等配置保留
}

若使用.json格式配置 #

{
  "parser": "@typescript-eslint/parser",
  "parserOptions": {
    "project": "./tsconfig.json"
  }
  // 其他原有配置保留
}

步骤2：校验tsconfig覆盖范围 #

检查项目根目录的tsconfig.json文件，确保include字段覆盖了所有需要lint校验的文件：

{
  "compilerOptions": {
    // 原有编译配置保留
  },
  "include": ["src/**/*"], // 确保src目录下所有文件被tsconfig覆盖
  "exclude": ["node_modules"]
}

配置修改完成后如果仍报错，可重启IDE的ESLint服务，或重新执行一次lint命令验证。

可选快速解决方法（无需配置类型服务） #

如果不需要dot-notation对应的代码风格校验，可直接在ESLint的rules配置中禁用该规则，无需修改parser配置：

{
  "rules": {
    "@typescript-eslint/dot-notation": "off"
  }
}

注意：该方案会丢失对应的代码规范校验能力，仅适合临时快速解决问题，正式项目建议优先选择配置parserOptions的方案

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