新建Angular 14.1项目出现TS2502类型注解错误求助

以下是针对@types/node类型文件报TS2502错误的具体解决步骤：

• 锁定兼容的@types/node版本
  Angular 14.1适配TypeScript 4.7.x，对应@types/node建议选用16.x系列版本。执行以下命令安装指定版本：

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

  之后删除本地依赖和锁文件，重新安装：

  # macOS/Linux
  rm -rf node_modules package-lock.json && npm install
  # Windows
  rmdir /s /q node_modules && del package-lock.json && npm install
  

• 校验TypeScript版本匹配度
  Angular 14.1要求TypeScript版本范围为4.7.2~4.8.x，检查package.json中的typescript版本是否符合要求，若不匹配，执行：

  npm install typescript@4.7.4 --save-dev
  

• 清理npm缓存
  缓存损坏可能导致依赖包异常，执行缓存清理后重新安装：

  npm cache clean --force
  npm install
  

• 使用npm ci确保依赖一致性
  npm ci会严格按照package-lock.json的版本安装依赖，避免版本浮动带来的问题：

  rm -rf node_modules package-lock.json
  npm ci
  

• 临时修复类型文件（应急方案）
  若上述方法均无效，可临时修改报错的web.d.ts文件：
  打开node_modules/@types/node/stream/web.d.ts，将报错的3处类型声明修改为：

  // 第484行
  var ReadableByteStreamController: typeof globalThis extends { ReadableByteStreamController: infer T } ? T : never;
  // 第503行
  var ReadableStreamBYOBReader: typeof globalThis extends { ReadableStreamBYOBReader: infer T } ? T : never;
  // 第513行
  var ReadableStreamBYOBRequest: typeof globalThis extends { ReadableStreamBYOBRequest: infer T } ? T : never;
  

  注意：此修改会在下次npm install时被覆盖，仅作为临时应急手段。

内容的提问来源于stack exchange，提问作者mr.louis