Angular项目编译报错：NgxTypeaheadModule非NgModule类怎么解决？

问题场景 #

安装NgxTypeahead库后，编译Angular项目时出现以下错误：

'NgxTypeaheadModule' does not appear to be an NgModule class.(-996002)
ngx-typeahead.module.d.ts(1, 22): This likely means that the library (ngx-typeahead) 
which declares NgxTypeaheadModule is not compatible with Angular Ivy. Check if a newer 
version of the library is available, and update if so. Also consider checking with the 
library's authors to see if the library is expected to be compatible with Ivy.
(alias) class NgxTypeaheadModule

当前Angular版本信息：

"@angular/cli": "~16.2.0",
"@angular/compiler-cli": "^16.2.0",

解决方案 #

1. 升级NgxTypeahead到兼容版本 #

• 先查看当前安装的库版本：

  npm list ngx-typeahead
  

• 确认库的最新版本是否支持Angular 16及Ivy编译模式，找到对应版本后执行升级命令：

  npm install ngx-typeahead@<兼容版本号>
  # 或使用yarn
  yarn add ngx-typeahead@<兼容版本号>
  

2. 启用跳过库检查（临时 workaround） #

如果暂时无法升级库，可以通过跳过第三方库类型检查来绕过该错误：

• 在项目根目录的tsconfig.json中添加或修改angularCompilerOptions：

  "angularCompilerOptions": {
    "skipLibCheck": true
  }
  

• 或者在angular.json的项目构建配置中添加该选项：

  "projects": {
    "你的项目名称": {
      "architect": {
        "build": {
          "options": {
            "skipLibCheck": true
          }
        }
      }
    }
  }
  

注意：这只是临时解决方案，长期来看还是建议升级兼容的库版本，避免潜在的类型错误。

3. 替换为维护活跃的替代库 #

如果NgxTypeahead长期未更新，不支持Angular 16，可以考虑替换为以下成熟组件：

• Angular Material的Autocomplete组件：官方维护，完美兼容Ivy和最新Angular版本
• ng-bootstrap的Typeahead组件：基于Bootstrap的实现，支持最新Angular版本

内容的提问来源于stack exchange，提问作者h.z.