执行lint-staged触发@typescript-eslint/dot-notation规则加载错误求助

这个问题我之前也碰到过，核心原因是@typescript-eslint/dot-notation这条规则依赖TypeScript的类型信息（也就是报错里提到的parserServices），而要生成这个服务，ESLint必须明确关联你的tsconfig.json文件。单独运行npm run eslint正常，是因为扫描整个src目录时ESLint能自动识别tsconfig，但lint-staged处理单个文件时，路径上下文的问题导致ESLint找不到正确的配置。

下面是几个亲测有效的解决方案：

方案一：修复.eslintrc.js的parserOptions配置 #

确保你的ESLint配置文件里明确指定parserOptions.project，并且加上tsconfigRootDir固定根目录，避免路径歧义：

module.exports = {
  parser: '@typescript-eslint/parser',
  parserOptions: {
    // 指向项目根目录的tsconfig.json，路径相对于当前.eslintrc.js
    project: './tsconfig.json',
    // 明确根目录为配置文件所在的目录，防止路径解析错误
    tsconfigRootDir: __dirname,
    ecmaVersion: 2020,
    sourceType: 'module',
    ecmaFeatures: {
      jsx: true
    }
  },
  plugins: ['@typescript-eslint'],
  // 其他规则配置...
};

方案二：在lint-staged命令中显式指定tsconfig #

如果方案一没解决问题，可以直接在lint-staged的ESLint命令里强制指定tsconfig路径：

{
  "lint-staged": {
    "src/**/*.tsx": [
      "eslint --fix -c .eslintrc.js --project ./tsconfig.json",
      "git add"
    ]
  }
}

方案三：检查tsconfig.json的包含范围 #

确认你的tsconfig.json的include字段覆盖了所有需要lint的文件，避免ESLint无法获取部分文件的类型信息：

{
  "compilerOptions": {
    // 你的编译配置...
  },
  "include": ["src/**/*.ts", "src/**/*.tsx"]
}

验证步骤 #

修改配置后，先手动执行eslint --ext .tsx,.ts --fix ./src -c .eslintrc.js确认没有报错，再运行npm run lint-staged测试，应该就能正常工作了。

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