Angular 5.5安装配置NGXS遇Rxjs报错，求问题根源解析

Hey there, let's break down exactly why you hit that TS2305 error when setting up NGXS in your Angular 5.5 project, and why copying the NGXS main branch's package.json fixed the issue.

1. 版本不兼容是核心问题 #

The NGXS main branch you referenced is built for Angular 6+ environments, which rely on RxJS 6.x and above. Your original project was on Angular 5.5, paired with RxJS 5.5.6—these two dependency sets have breaking API differences that directly caused your error.

2. OperatorFunction 是关键差异点 #

The specific error "'rxjs/Rx"' has no exported member 'OperatorFunction' happens because:

• In RxJS 6, OperatorFunction was formally exported and became a foundational type for operators like map, filter, etc.
• RxJS 5.5.x doesn't include this exported type at all—it uses older, incompatible type definitions for operators.

Since NGXS's main branch code is written to use RxJS 6's type system, trying to compile it against RxJS 5.5.6 throws that type mismatch error.

3. 为什么复制主分支的package.json解决了问题 #

When you replaced your project's package.json with the one from NGXS's main branch, you're telling your package manager (npm/yarn) to install:

• A compatible Angular 6+ version
• RxJS 6.x (which includes the OperatorFunction type NGXS expects)
• All other peer dependencies that align with NGXS's current version requirements

This aligns your project's dependency versions with what NGXS is built for, eliminating the type mismatch.

额外建议：如果想保留Angular 5.5 #

If you need to stick with Angular 5.5 instead of upgrading, you shouldn't use NGXS's main branch. Instead, install a version of NGXS that explicitly supports Angular 5—NGXS 3.x is the last major version compatible with Angular 5.x. You can install it with:

npm install @ngxs/store@3.x --save

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