NG-ALAIN 项目升级至 v18 版本指南

NG-ALAIN 作为基于 Angular 的企业级中后台前端解决方案，其 v18 版本的升级带来了诸多改进和新特性。本文将详细介绍如何将现有项目从 v17 版本平滑升级至 v18 版本。

升级前准备

在开始升级前，开发者需要做好以下准备工作：

1. 确保开发环境中的 Node.js 版本不低于 18.19.1
2. 使用版本控制系统创建新分支，或通过其他方式备份当前项目
3. 清理项目中的锁定文件（package-lock.json 或 yarn.lock）
4. 移除 package.json 中的 postinstall 脚本配置

核心升级步骤

升级过程主要涉及 Angular 核心框架及其相关生态的版本更新：

1. 执行 Angular 全家桶升级命令，一次性更新核心依赖：

ng update @angular/core@18 @angular/cli@18 @angular-eslint/schematics@18 ng-zorro-antd@18 ng-alain@18

2. 若项目中单独使用了 Angular CDK，需额外执行：

ng update @angular/cdk@18

升级注意事项

升级过程中开发者可能会遇到以下典型问题：

LESS 编译错误
当出现 throw new Error(Not found ${lessLangPath}) 错误时，表明项目中存在旧的 LESS 处理配置。解决方案是确保在升级前已移除 package.json 中的 ng-less-javascript-enabled-patch 相关配置。

升级后验证

完成升级后，建议开发者：

1. 全面测试项目功能，特别是与 UI 组件相关的交互
2. 检查构建流程是否正常执行
3. 验证生产环境打包结果

NG-ALAIN v18 版本带来了性能优化和新特性支持，升级后开发者可以充分利用这些改进来提升项目质量。如果在升级过程中遇到特殊问题，建议参考官方变更记录进行针对性排查。