Angular 15迁移至16：禁用独立组件并保留模块式开发指南

1. 禁用/退出独立组件特性的配置步骤 #

独立组件在Angular 16中是可选特性，默认不会强制启用，只需通过以下配置确保不会意外开启：

• 完善项目全局Schematics配置：在angular.json的项目schematics节点中，为组件、指令、管道统一设置standalone: false，确保CLI生成的新代码默认不使用独立组件：

  "projects": {
    "oto-link-dealer-admin-angular": {
      "projectType": "application",
      "schematics": {
        "@schematics/angular:component": {
          "style": "scss",
          "standalone": false
        },
        "@schematics/angular:directive": {
          "standalone": false
        },
        "@schematics/angular:pipe": {
          "standalone": false
        }
      }
    }
  }
  

• 全局CLI配置：如果需要所有新项目都默认禁用独立组件，执行以下命令设置全局Schematics：

  ng config schematics.@schematics/angular:component.standalone false
  ng config schematics.@schematics/angular:directive.standalone false
  ng config schematics.@schematics/angular:pipe.standalone false
  

• 避免手动添加standalone: true：不要在现有或新创建的组件、指令、管道装饰器中设置该属性。

2. 确保项目保持Angular 15运行状态的核心要点 #

• 维持原有模块结构：继续使用NgModule声明组件、指令、管道，通过declarations、imports、exports管理依赖，不直接在组件中导入其他独立组件。
• 保留传统启动方式：保持main.ts中使用platformBrowserDynamic().bootstrapModule(AppModule)启动应用，不要切换为bootstrapApplication。
• 沿用旧版路由配置：继续使用RouterModule.forRoot()/forChild()定义路由，避免使用Angular 16新增的基于独立组件的路由API。
• 不使用独立组件专属API：避免调用importProvidersFrom等独立组件相关的依赖注入工具，保持模块式的依赖导入方式。

3. 处理迁移中的弃用警告与问题 #

• 区分警告类型：
  • 仅推荐使用独立组件的警告：这类提示不影响现有功能，可直接忽略；若想屏蔽，可在tsconfig.json的angularCompilerOptions中添加"suppressWarnings": true，或执行CLI命令时添加--no-warnings参数。
  • 真正的API弃用警告：若警告涉及模块式开发中确实被弃用的API，需按照Angular官方迁移指南替换为兼容API，确保不依赖已废弃的功能。
• 更新第三方依赖：将项目中所有第三方库（如UI组件库、工具库）升级到兼容Angular 16的版本，避免因库内部逻辑导致的冲突。
• 验证编译与运行：每次迁移步骤后，执行ng build、ng test、ng serve验证项目功能，确保模块式的组件、路由、依赖注入逻辑完全正常运行。

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