ng-packagr 20.0.0 版本深度解析：Angular 库构建工具的重大升级

ng-packagr 是 Angular 生态系统中一个重要的库构建工具，专门用于将 Angular 组件和库打包成符合 Angular Package Format (APF) 规范的格式。作为 Angular 官方推荐的打包工具，它简化了 Angular 库的构建、打包和发布流程，使开发者能够专注于业务逻辑而非构建配置。

重大变更概览

本次 20.0.0 版本带来了几项重要的变更，开发者需要特别注意：

1. Node.js 版本支持调整：不再支持 Node.js v18 和 Node.js 22.0 至 22.10 版本。现在要求最低版本为 Node.js 20.19、22.12 或 24.0。这一变更反映了 JavaScript 生态系统的持续演进，确保工具链能够利用最新的 Node.js 特性和性能优化。

2. TypeScript 版本要求提升：最低支持的 TypeScript 版本提升至 5.8。这一变更使 ng-packagr 能够利用 TypeScript 最新版本的类型系统改进和性能优化，同时也意味着使用旧版 TypeScript 的项目需要进行升级。

核心新特性

1. 增强的浏览器兼容性支持

ng-packagr 20.0.0 引入了对 Baseline 浏览器的广泛支持。Baseline 是一个由 Web 开发者社区维护的项目，定义了现代 Web 开发中普遍可用的功能集。这一改进意味着：

• 构建输出的代码将更好地适配现代浏览器环境
• 减少了不必要的转译和 polyfill，优化了包体积
• 开发者可以更精确地控制目标浏览器环境

2. 声明文件(DTS)打包优化

长期以来，TypeScript 声明文件的生成和打包一直是 Angular 库开发中的痛点。20.0.0 版本针对这一问题进行了重大改进：

• 为每个入口点生成优化的 DTS 包
• 改善了类型定义的分布和组织方式
• 提升了类型检查的准确性和开发体验

这一特性特别适合大型库项目，能显著改善类型系统的可靠性和开发者的使用体验。

3. Angular 20 全面支持

作为与 Angular 核心团队紧密协作的工具，ng-packagr 20.0.0 版本提供了对 Angular 20 的完整支持，包括：

• 兼容 Angular 20 的新编译器特性
• 支持 Angular 20 引入的 API 变更
• 优化了与 Angular CLI 20 的集成体验

4. Sass 包导入器支持

对于使用 Sass 作为样式预处理器的项目，新版本增加了对 Sass 包导入器的支持：

• 可以直接从 node_modules 导入 Sass 包
• 支持自定义 Sass 导入解析逻辑
• 改善了 Sass 模块的解析性能和准确性

这一改进特别有利于共享样式库和主题系统的开发。

重要问题修复

20.0.0 版本修复了多个影响开发体验的关键问题：

1. SCSS 资源解析：修复了嵌套路径中 SCSS 资源解析不正确的问题，解决了长期存在的资源定位错误。

2. 构建缓存优化：改进了 watch 模式下的构建策略，避免了不必要的入口点重建，显著提升了开发效率。

3. CSS 嵌套处理：防止了组件中 CSS 嵌套导致的样式污染问题，确保了样式隔离。

4. TypeScript 配置：禁用了与 Angular 编译器冲突的 TypeScript composite 选项，避免了潜在的构建错误。

性能优化

新版本在性能方面做出了多项改进：

1. 节点删除优化：使用 Set 数据结构优化了依赖图中的节点删除操作，提升了大型项目的构建速度。

2. 构建缓存策略：改进了增量构建的缓存策略，减少了重复工作，特别在 monorepo 场景下效果显著。

3. 警告抑制：禁用了空 chunk 警告，减少了构建输出的噪音，改善了开发体验。

升级建议

对于计划升级到 ng-packagr 20.0.0 的团队，建议采取以下步骤：

1. 首先确保开发环境和 CI 环境中的 Node.js 版本符合新要求（20.19+、22.12+ 或 24.0+）。

2. 将项目中的 TypeScript 版本升级到至少 5.8，并测试类型检查是否正常。

3. 检查项目中的 Sass 导入语句，利用新的导入器特性优化样式引用。

4. 对于大型项目，建议在升级后监控构建性能变化，可能需要调整自定义构建配置。

5. 特别注意 Angular 版本兼容性，确保与 Angular 20 配合使用以获得最佳体验。

ng-packagr 20.0.0 的这些改进标志着 Angular 库开发工具链的又一次重要演进，为开发者提供了更强大、更高效的构建体验，同时也为未来的 Angular 生态系统发展奠定了更坚实的基础。