如何屏蔽Angular Ivy不兼容angular2-wizard模块的报错？

临时屏蔽报错继续使用的方法 #

方法1：全局禁用Ivy #

在项目的tsconfig.app.json文件中，修改angularCompilerOptions配置：

{
  "angularCompilerOptions": {
    "enableIvy": false
  }
}

同时确保angular.json中对应项目的build选项里aot设置为false（若之前开启），整个项目会回退到View Engine模式，兼容旧版库。

方法2：允许单个库跳过Ivy检查 #

若不想全局禁用Ivy，可在angular.json的项目build配置中添加允许非兼容依赖：
找到projects -> [你的项目名] -> architect -> build -> options，添加：

"allowedNonPeerDependencies": ["angular2-wizard"]

同时在tsconfig.app.json的angularCompilerOptions里补充：

"allowNonNgModuleDependencies": true

该配置会让Angular跳过对该库的Ivy兼容性校验。

修改库代码适配Ivy的入手方向 #

如果要硬编码修改库代码，按以下步骤操作：

1. 从node_modules/angular2-wizard复制所有源码到项目src目录下（比如新建libs/angular2-wizard文件夹）。
2. 找到声明FormWizardModule的文件（通常是form-wizard.module.ts），重点检查：
   • 模块类顶部是否正确导入@NgModule装饰器，且类被@NgModule()正确装饰。
   • @NgModule的元数据（declarations、imports、exports等）必须是静态数组，不能使用动态生成的内容（比如函数返回的数组）。
   • 移除Angular 9+不再需要的entryComponents配置（Ivy会自动处理组件入口）。
   • 检查模块内所有组件、指令的装饰器（如@Component、@Directive）是否符合Ivy要求，比如模板路径是否正确、无废弃API调用。
3. 在项目模块中，将原导入语句import { FormWizardModule } from 'angular2-wizard'替换为本地路径引用，例如import { FormWizardModule } from '../libs/angular2-wizard/form-wizard.module'。
4. 编译项目，根据新报错逐步调整代码（比如修复模板语法、替换过时API等）。

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