升级Angular 16后ngx-virtual-scroll失效，报VirtualScrollerModule错误如何解决？

云上老周

2026-7-21

解决Angular 16升级后ngx-virtual-scroll组件失效问题

问题根源

终端报错明确指向：当前使用的ngx-virtual-scroller版本不兼容Angular 16默认启用的Ivy编译器，导致VirtualScrollerModule无法被识别为合法的NgModule类。

升级组件至兼容版本
优先尝试更新ngx-virtual-scroller到最新版，执行以下命令：
```
npm install ngx-virtual-scroller@latest --save
```
若最新版仍有问题，可查看组件版本说明，安装明确标注支持Angular 16的版本，例如指定16.x系列：
```
npm install ngx-virtual-scroller@16.x.x --save
```
临时禁用Ivy（过渡方案）
若组件暂未适配Ivy，可临时关闭Ivy编译器作为应急方案（不推荐长期使用，会丢失Angular 16部分新特性）：
修改项目根目录下的tsconfig.json，调整angularCompilerOptions：
```
{
  "angularCompilerOptions": {
    "enableIvy": false
  }
}
```
替换为官方兼容组件
如果ngx-virtual-scroller长期未更新适配，建议替换为Angular CDK提供的官方虚拟滚动组件CdkVirtualScrollViewport，它天然兼容所有Angular新版本，无需额外适配。