@typescript-eslint/typescript-estree 版本警告解决方案

问题描述

在使用 TypeScript 4.4.2 及以上版本时，您可能会遇到以下警告信息：

=============

WARNING: You are currently running a version of TypeScript which is not 
officially supported by @typescript-eslint/typescript-estree.

You may find that it works just fine, or you may not.

SUPPORTED TYPESCRIPT VERSIONS: >=3.3.1 <4.4.0

YOUR TYPESCRIPT VERSION: 4.4.2

Please only submit bug reports when using the officially supported 
version.

=============

这个警告表示您当前使用的 TypeScript 版本与 @typescript-eslint/typescript-estree 包不兼容。

根本原因

@typescript-eslint/typescript-estree 是 ESLint 用于解析 TypeScript 代码的核心依赖包，它通常作为其他 ESLint 相关包的依赖项存在，而不是直接安装在项目中。

每个版本的 @typescript-eslint/typescript-estree 都只支持特定范围的 TypeScript 版本：

typescript-estree 版本	支持的 TypeScript 版本
8.26.0	TS 5.8
8.10.0	TS 5.6
7.14.0	TS 5.5
7.2.0	TS 5.4
6.13.0	TS 5.3
6.5.0	TS 5.2
5.61.0	TS 5.1
5.55.0	TS 5.0

解决方案

方法一：更新 ESLint 相关包（推荐）

更新所有相关的 ESLint 包到最新版本：

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

更新后，您的 package.json 应该包含类似以下的版本：

{
  "devDependencies": {
    "eslint": "^8.38.0",
    "@typescript-eslint/parser": "^6.9.0",
    "@typescript-eslint/eslint-plugin": "^6.9.0",
    "typescript": "^5.0.4"
  }
}

TIP

如果您使用的是 React 项目，可能还需要更新 eslint-config-next：

npm i eslint-config-next@latest --save-dev

方法二：检查依赖链并更新过时包

使用以下命令查找哪个包引入了不兼容版本的 @typescript-eslint/typescript-estree：

npm why @typescript-eslint/typescript-estree

这个命令会显示依赖关系树，帮助您确定哪些包需要更新。例如，如果是 eslint-plugin-testing-library 引入了旧版本，您需要更新它：

npm i eslint-plugin-testing-library@latest --save-dev

方法三：使用包管理器的覆盖功能

对于 yarn 用户，可以在 package.json 中添加 resolutions 字段：

{
  "resolutions": {
    "@typescript-eslint/typescript-estree": "^6.9.0"
  }
}

对于 npm 用户，可以使用 overrides 字段：

{
  "overrides": {
    "@typescript-eslint/typescript-estree": "^6.9.0"
  }
}

添加后运行 npm install 或 yarn install。

方法四：禁用警告（临时解决方案）

如果您暂时无法更新包，可以禁用这个警告。在 ESLint 配置文件中添加：

// eslint.config.js 或 .eslintrc.js
export default [
  {
    languageOptions: {
      parserOptions: {
        warnOnUnsupportedTypeScriptVersion: false,
      },
    },
  },
];

WARNING

这种方法只是隐藏了警告，并没有真正解决兼容性问题。建议只在临时情况下使用。

方法五：降级 TypeScript（不推荐）

作为最后的手段，您可以降级 TypeScript 到兼容的版本：

npm install typescript@5.0.4 --save-dev

不推荐

降级 TypeScript 意味着您将无法使用新版本的特性，这不是一个长期的解决方案。

预防措施

1. 定期更新依赖：定期运行 npm outdated 检查过时的包
2. 锁定版本兼容性：在升级 TypeScript 前，检查相关 ESLint 包的支持情况
3. 查看官方文档：参考 typescript-eslint 官方文档 获取最新的版本兼容性信息

总结

@typescript-eslint/typescript-estree 版本警告通常是由于 ESLint 相关包与 TypeScript 版本不兼容导致的。最佳解决方案是更新所有相关的 ESLint 包到最新版本，确保它们支持您使用的 TypeScript 版本。

通过定期维护项目依赖关系，您可以避免这类兼容性问题，确保开发环境的稳定性和安全性。