16、TypeScript 类型声明与使用的最佳实践

TypeScript 类型声明与使用的最佳实践

在 TypeScript 的开发过程中，类型声明和使用有着许多关键的要点和最佳实践，掌握这些内容能够帮助我们编写出更加健壮、易于维护的代码。下面将详细介绍这些重要的知识点。

1. 发布包时类型声明的处理

当我们发布包时，需要权衡将类型声明捆绑在一起还是发布到 DefinitelyTyped 上。官方建议，如果库是用 TypeScript 编写的，最好将类型声明捆绑在一起，因为 tsc 可以使用 declaration 编译器选项自动为你生成类型声明。而对于 JavaScript 库，手工编写的类型声明更容易包含错误，并且需要更多的更新。如果将类型声明发布到 DefinitelyTyped 上，社区会帮助你支持和维护它们。

需要记住的要点 ：
- @types 依赖涉及三个版本：库版本、 @types 版本和 TypeScript 版本。
- 更新库时，确保更新相应的 @types 。
- 理解捆绑类型和在 DefinitelyTyped 上发布类型的优缺点。如果库是用 TypeScript 编写的，优先选择捆绑类型；如果不是，则选择 DefinitelyTyped。

2. 导出公共 API 中出现的所有类型

在使用 TypeScript 时，我们可能会遇到想要使用第三方模块中的类型或接口，但发现它们没有被导出的情况。作为库的作者，应该直接导出这些类型。因为如果一个类型出现在函数声明中，实际上它已经被导出了