javascript - 手写或生成 typescript .d.ts？

Question

Typescript 允许你在 tsconfig 中使用 "declaration": true" 来生成基于现有 Typescript 代码的 d.ts 文件。它们不像我自己写的那样简洁，但我'我想知道是否有理由不依赖这些，因为它们看起来有些准确。

编辑:我们正在用 Typescript 创建一个库。

Answer 1

根据经验，您应该让 TypeScript 在创建库时为您构建声明文件。当您拥有 JavaScript 库时，手写 *.d.ts 文件很好，但您想用类型描述其行为。

也有异常(exception)——例如，您可能希望通过删除不需要的注释来清理生成的文件。有人可能会争辩说，这可以通过将它们标记为 @internal 来解决。