用途:为使用 ng-zorro-antd 的 Angular 项目生成代码与开发指导,聚焦 NG-ZORRO 特有内容;可与 angular-developer 技能配合,后者提供 Angular 基础(signal、依赖注入、路由、表单、SSR、无障碍)。
版本兼容:跟踪 ng-zorro-antd@22.0.0,对齐 Angular ^22.0.0,主版本号始终与 @angular/core 一致。适用 NG-ZORRO v17 至 v22 项目,假设采用 v21/v22 API。要求 Angular v17 或更新(独立组件与新控制流),v22 匹配最佳。支持无 Zone 变更检测与 OnPush、SSR、通过 provideNzI18n(en_US) 配置国际化并在运行时用 NzI18nService 切换;不支持 v16 及以下。若项目主版本与 @angular/core 不匹配,npm peer 检查会失败,需按 migration.md 同步升级。
主要能力:覆盖 70+ 组件,按通用、布局、导航、数据录入、数据展示、反馈等分组;讲解指令、独立组件、可注入服务三类形态及选用建议;提供 LESS 变量主题(默认、暗色、紧凑、aliyun 预设)与实验性动态主题(CSS 变量);含表单与 ReactiveForms/Signal Forms 集成、无障碍与键盘导航、迁移指南。
使用方式:安装可执行 ng add ng-zorro-antd(schematic 处理 i18n、样式、动画、图标注册)。使用前先检查 package.json 判断版本与导入风格:v18+ 应使用独立类(如 NzButtonComponent)与少量指令(如 NzButtonDirective),不要在新项目使用 NzModule。生成代码后运行 ng build 验证。常见错误包括在独立组件中导入 NzModule、忘记 provideNzI18n 导致日期组件运行时报错、使用 v15 时期 APP_INITIALIZER 初始化 i18n、以及未注册图标却使用 <nz-icon>。
限制:v22 移除了多个废弃输入并改变日期组件配置,日期组件不再默认提供 adapter,需显式调用 provideNzDateFnsAdapter(),date-fns 为 v4;动态主题在 v21 仍属实验性。部分细节如官方文档地址与完整示例暂未提供。