不升级TypeScript版本解决@types/node类型定义编译错误

• 锁定兼容的@types/node版本
  错误来自过高版本的@types/node（ts4.8版本的类型文件），TypeScript 4.1.6不支持该版本的语法和泛型定义。安装TS4.1兼容的@types/node版本，比如14.x系列的稳定版：

  npm install @types/node@14.17.34 --save-dev
  

  同时在package.json中将@types/node的版本号锁定为具体值，避免后续依赖更新自动拉取不兼容版本。

• 排除不兼容的类型文件
  在项目根目录的tsconfig.json中，将node_modules/@types/node/ts4.8目录加入exclude数组，让TypeScript编译时跳过该目录下的文件：

  "exclude": [
    "node_modules",
    "node_modules/@types/node/ts4.8"
  ]
  

• 开启跳过库类型检查选项
  在tsconfig.json的compilerOptions中设置skipLibCheck为true，跳过第三方库的类型检查，直接忽略这类来自@types/node的编译错误：

  "compilerOptions": {
    // 其他编译选项保持不变
    "skipLibCheck": true
  }
  

• 清理依赖缓存并重装
  若存在依赖缓存导致的版本混乱，执行以下步骤：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

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