Angular项目npm start报rxjs类型错误：关于版本降级的疑问

问题回顾 #

你用 Angular CLI 创建新项目后，执行 npm start 时遇到了以下 TypeScript 编译错误：

ERROR in node_modules/rxjs/internal/types.d.ts(81,44): error TS1005: ';' expected.
node_modules/rxjs/internal/types.d.ts(81,74): error TS1005: ';' expected.
node_modules/rxjs/internal/types.d.ts(81,77): error TS1109: Expression expected.

对比正常运行的同版本 Angular 项目，发现报错项目的 rxjs 版本是 6.4.0，而正常项目是 6.3.3，修改 package.json 中 rxjs 版本为 6.3.3 后问题解决。下面针对你的两个疑问逐一解答：

疑问1：为什么降级 rxjs 版本能解决问题？ #

核心原因是 rxjs 6.4.0 引入了当前项目 TypeScript 版本不支持的语法特性。

rxjs 从 6.4.0 开始，在类型定义文件中使用了 TypeScript 3.4 及以上版本才支持的语法（比如类型系统的新特性）。而你的 Angular 项目对应的 TypeScript 版本可能低于 3.4（比如 Angular 7.x 配套的 TS 版本上限是 3.2.x），旧版本 TS 编译器无法识别这些新语法，因此抛出了类型文件的编译错误。

至于两个项目的版本差异：你提到报错项目额外使用了 Angular Material，可能 Material 的依赖声明没有严格锁定 rxjs 的兼容版本范围，导致 npm/yarn 在安装时自动拉取了当时最新的 rxjs 6.4.0；而正常项目因为没有引入 Material，依赖树中 rxjs 被 Angular 本身的版本约束锁定在了兼容的 6.3.3 版本。

疑问2：没有可对比项目时，如何排查出需要降级 rxjs？ #

如果没有参考项目，可以按照以下步骤逐步排查：

• 第一步：聚焦错误来源
  错误提示指向 node_modules/rxjs/internal/types.d.ts，这说明不是你自己的代码问题，而是依赖库的类型文件与当前 TypeScript 环境不兼容。
• 第二步：核对版本兼容性
  1. 用 ng -version 查看当前项目的 TypeScript 版本，再去 rxjs 的官方发布记录中，查找 6.4.0 版本对 TypeScript 的要求（通常 rxjs 的 release notes 会明确标注依赖的 TS 版本范围）。
  2. 同时查 Angular 官方的版本兼容性对照表，每个 Angular 大版本都有对应的 rxjs 和 TypeScript 版本范围（比如 Angular 7.x 要求 rxjs 6.3.x，TS 3.1-3.2）。对比后就能发现 rxjs 6.4.0 超出了当前 Angular 版本的兼容范围。
• 第三步：验证兼容版本
  在 package.json 中将 rxjs 版本锁定到 Angular 官方推荐的范围内（比如 6.3.3），执行 npm install 重新安装依赖后再启动项目，验证问题是否解决。
• 备选方案：谨慎升级 TypeScript
  如果你想保留 rxjs 6.4.0，也可以尝试升级 TypeScript 到 rxjs 要求的版本，但必须确保新的 TS 版本与当前 Angular 版本兼容——盲目升级可能会引发更多编译错误，所以优先推荐降级 rxjs 到适配版本。

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