安装Angular Material后出现TS1005等TypeScript编译错误如何解决

报错原因 #

该编译错误的核心原因是项目本地安装的TypeScript版本低于Angular Material要求的最低版本。Angular CLI编译时默认调用项目node_modules目录内的TypeScript依赖包，不会使用全局安装的TypeScript版本，因此仅升级全局TS版本无法解决该问题。

解决步骤 #

• 确认项目本地TypeScript版本，在项目根目录执行以下命令：
  npm list typescript
  若输出的版本低于4.2，即可确认是版本不兼容导致的语法解析错误（抽象构造函数类型语法为TypeScript 4.2版本新增支持特性，低版本TS无法识别该语法）。
• 根据当前使用的Angular版本，安装对应兼容的TypeScript版本，示例命令如下：
  npm install typescript@~4.5.0 --save-dev
  版本需匹配本地Angular核心包的兼容要求：Angular 13对应TS 4.4~4.5版本区间，Angular 14对应TS 4.6~4.7版本区间。
• 清理依赖缓存并重新编译：
  1. 删除项目根目录下的node_modules文件夹、package-lock.json或yarn.lock文件
  2. 执行npm install重新安装所有依赖
  3. 执行ng serve或ng build验证报错是否已解决
• 若升级TS版本后仍存在报错，可检查Angular Material版本是否与本地Angular核心版本匹配，两者大版本号需保持一致（例如Angular 13对应Angular Material 13）。

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