Angular库应提供TypeScript源码还是编译后的JS包？

首先得明白为什么Angular 5.0之后会出现这个错误：从Angular 5开始，Angular CLI的构建流程默认不会编译node_modules目录下的TypeScript文件，除非你在项目的tsconfig.json里手动把对应文件加入include列表——这就是用户安装你的源码包时报错的核心原因。

接下来咱们聊聊两种方案的利弊，帮你做决定：

不建议继续发布TypeScript源码包的原因 #

• 用户体验差：每个使用你库的用户都得手动修改自己的tsconfig.json，这不仅麻烦，还容易因为配置失误引发更多问题，会大幅增加你的支持成本。
• 版本兼容风险高：不同用户的项目可能用不同版本的TypeScript或Angular，比如你的库依赖TS 4.8，但用户项目还在TS 3.9，编译时就会出现语法不兼容的报错，这种问题排查起来非常棘手。
• 拖慢用户构建速度：用户每次构建项目都得额外编译你的库源码，尤其是大型项目，会明显增加构建时间，影响开发效率。

推荐编译为JS后发布的优势 #

• 开箱即用：用户安装后直接就能导入使用，不需要任何额外配置，完全符合npm包的常规使用体验，彻底解决你遇到的那个编译错误。
• 兼容性可控：你可以在自己的开发环境中完成编译，确保用的TS版本、Angular版本和你的库完全兼容，同时把编译后的JS文件和对应的.d.ts类型定义文件一起发布——既保留了TypeScript用户需要的类型提示，又避免了用户编译的问题。
• 优化包体积：编译后的JS可以做压缩、Tree Shaking优化，用户安装的包体积更小，加载速度更快，对生产环境更友好。

额外的小提示 #

如果是Angular库，推荐用官方的ng-packagr工具来打包，它专门为Angular库设计，能自动生成符合Angular CLI要求的包结构，处理好编译、类型导出、依赖打包等细节，完美适配Angular 5及以上的所有版本。

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