TypeScript配合ESLint报模块路径无法解析等多项报错如何解决
TypeScript + React 项目 ESLint 全报错修复方案
核心配置错配根因
当前配置存在三类TS场景适配缺口:
- 仅引入了JS版本的
airbnb规则集,未正确接入已安装的eslint-config-airbnb-typescript适配规则,导致所有TS文件校验完全按照JS项目逻辑执行 - 模块解析的扩展名列表遗漏
.tsx/.jsx格式,无法正确匹配项目内的组件文件 - 未针对TS开发场景调整import校验、JSX文件后缀校验的规则阈值
分场景修复操作
1. 解决import/no-unresolved、import/extensions类报错
- 替换extends配置中的
'airbnb'项为'airbnb-base'+'airbnb-typescript'组合,后者已内置TS场景下的import校验逻辑,可避免和TS规则集冲突 - 修正
settings.import/resolver.node的扩展名列表,补充遗漏的格式:extensions: ['.js', '.jsx', '.ts', '.tsx', '.d.ts'] - 在rules中追加规则,允许TS项目省略组件文件的扩展名,取消强制带后缀的校验:
'import/extensions': ['error', 'ignorePackages', { js: 'never', jsx: 'never', ts: 'never', tsx: 'never', }]
2. 解决react/jsx-filename-extension报错
- 在rules中追加规则,将
.tsx加入允许编写JSX的文件后缀列表:'react/jsx-filename-extension': ['error', { extensions: ['.js', '.jsx', '.tsx'] }]
3. 调整@typescript-eslint/explicit-module-boundary-types警告
- 该规则默认要求所有跨模块导出的函数显式标注返回值类型,如果希望保留TypeScript自动类型推导能力,可将规则等级关闭:
'@typescript-eslint/explicit-module-boundary-types': 'off'
修正后可直接使用的完整ESLint配置
module.exports = { env: { browser: true, es2020: true, }, extends: [ 'plugin:react/recommended', 'plugin:import/typescript', 'airbnb-base', 'airbnb-typescript', 'plugin:@typescript-eslint/recommended', 'plugin:jest/recommended', 'prettier', 'prettier/react', 'prettier/@typescript-eslint', 'plugin:prettier/recommended' ], plugins: ['react', '@typescript-eslint', 'jest'], parser: '@typescript-eslint/parser', parserOptions: { ecmaFeatures: { jsx: true, }, ecmaVersion: 12, sourceType: 'module', project: './tsconfig.json' }, settings: { 'import/resolver': { 'node': { 'paths': ['src'], 'extensions': ['.js', '.jsx', '.ts', '.tsx', '.d.ts'] }, }, }, rules: { 'linebreak-style': 'off', 'no-use-before-define' : 'off', '@typescript-eslint/no-use-before-define': 'warn', 'import/extensions': ['error', 'ignorePackages', { js: 'never', jsx: 'never', ts: 'never', tsx: 'never', }], 'react/jsx-filename-extension': ['error', { extensions: ['.js', '.jsx', '.tsx'] }], '@typescript-eslint/explicit-module-boundary-types': 'off' }, };
补充说明:配置修改完成后,重新执行
yarn lint即可消除全部报错;如果仍存在路径解析问题,可安装eslint-import-resolver-typescript依赖,在settings.import/resolver中追加'typescript': {}配置项,即可自动匹配tsconfig中的路径别名设置。
内容的提问来源于stack exchange,提问作者Richard Rublev
相关产品推荐
相关产品推荐

