React Native Android项目tsconfig.json compilerOptions/lib配置报错

核心原因 #

@tsconfig/react-native的版本与本地TypeScript版本不兼容：低版本TypeScript不支持es2020.date这类细分的lib选项，而高版本的@tsconfig/react-native配置文件中默认包含了这类值，导致冲突报错。

可行解决方案 #

方案1：升级TypeScript版本 #

确保TypeScript版本支持细分lib选项（要求v4.5及以上），执行命令升级：

npm install typescript@latest --save-dev
# 或使用yarn
yarn add typescript@latest --dev

方案2：完全覆盖lib配置 #

在本地tsconfig.json中直接覆盖lib数组，只保留TypeScript支持的完整lib值，忽略继承来的细分项：

{
  "extends": "@tsconfig/react-native/tsconfig.json",
  "compilerOptions": {
    "lib": ["ES2020", "DOM"]
  }
}

方案3：降级@tsconfig/react-native版本 #

若必须保留当前TypeScript版本，可降级到适配的@tsconfig/react-native版本（比如针对TypeScript v4.4及以下，安装v3.x版本）：

npm install @tsconfig/react-native@3.0.2 --save-dev
# 或使用yarn
yarn add @tsconfig/react-native@3.0.2 --dev

验证修复 #

执行TypeScript编译检查确认错误消除：

npx tsc --noEmit

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