JSDoc + IDE与TypeScript

Question

使用适当维护的JSDoc，几乎任何现代的IDE都可以识别类型不匹配(赋值、函数的签名/参数)以及非强类型语言引入的许多其他问题。除此之外，现代JS还提供了可预测的变量范围、免费提升行为、模块化、内置类支持等。

在哪种情况下，TypeScript可以比JS+JSDoc更好地满足开发人员的需求？

Answer 1

我觉得比较起来有点奇怪。JSDoc面向文档，而类型记录为js添加了可选的静态类型。这些工具确实有一些共同之处，例如，它们允许类型检查，但它们的用途不同。

不过，这是个有趣的问题。我想鼓励大家就这个话题进行讨论，所以我将从我使用这些工具的经验来谈谈。

我与jsdoc的主要问题是，以下部分至关重要：

维护得当的JSDoc

jsdoc对于自动完成的有用性直接取决于jsdoc注释的努力和质量。我发现在大型项目中很难执行。复杂的类型/接口也很难描述和维护，非常冗长。另一方面，Ts比jsdoc要简洁得多。

此外，ts中的类型和接口是一流的公民，而不仅仅是为了文档的缘故而添加的。它们是源代码中的实体，可以导出供其他模块使用。类型不匹配是在编译过程中(和之前)强制执行的。还有一些机制，如仿制药或装潢工，与ts一起出现。

回到执行指南部分。使用ESLint，您可以设置灵活的规则，允许您对类型的限制/样式/指南进行微调。你想要死板的静态类型？还是你想要宽大处理？

如果你愿意的话，你可以让你的确切需求被强制执行并连接到ci/cd上。在我看来，在做大项目的时候，这是一个很大的好处。

工具也是一个重要的因素，jsdoc和ts都已经足够成熟，可以将生态系统围绕在它们周围。虽然此时jsdoc不是一个活跃的项目非常流行，但它周围有一个庞大的社区，有大量的活动。

因此，这取决于您的需求，如果您对jsdoc可以为您做的事情感到满意，并且文档是您的主要关注点，那么ts将不会为您做什么。

P.S. Ts和jsdoc不是相互排斥的。您可以两者兼得，尽管您可能希望切换到类似于TSDoc的东西。

Answer 2

各种Js编译器，如类型记录和闭包，正式支持使用JSDoc https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html进行类型检查。

如果您想输入check源代码，这是一个有效的选项。