新发布的 TypeScript 手册！先睹为快！

原文地址：Announcing the New TypeScript Handbook

原文做者：Orta Therox

译文出自：掘金翻译计划

本文永久连接：github.com/xitu/gold-m…

译者：zenblo

校对者：itcodes、PassionPenguin

嘿！开发者们，咱们很高兴地向你们宣布，一个彻底重写的 TypeScript 手册如今已经转入正式版了，而且将会成为咱们网站学习 TypeScript 的主要资源！html

经过 Web、Epub 或 PDF 阅读新发布的 TypeScript 手册。前端

在过去的一年里，团队高度重视提高 TypeScript 文档的规模、时效性和范围。TypeScript 手册是咱们的文档中最关键的部分，它是你在大多数代码库中都会看到的 TypeScript 代码的导览。咱们但愿这本手册能让你以为是学习 TypeScript 的首选资料。android

去年新版网站的发布中，咱们已经将一些渐进式的改进归入到手册中，同时新版手册为新网站的不少功能提供了指引。ios

而在这个从 2018 年启动的新 TypeScript 手册项目中，咱们编写手册的方式增长了一套规范。git

将 JavaScript 的教学工做交给专家去作

经过网络和书籍学习 JavaScript 的资源很是多。咱们没有必要在这个领域竞争。这本手册旨在帮助开发者理解 TypeScript 构建在 JavaScript 上的方式。这个重点意味着咱们的文档能够对背景进行假设，避免从头开始解释 JavaScript 的特性。github

咱们但愿不一样技术水平的开发者都能使用这本手册。例如，咱们在网站上添加了一个新功能，让人们根据本身的技术背景，初步了解 TypeScript 与其余语言的区别，做为阅读手册以前的准备。你能够在文档概述中看到。web

按部就班的教学

咱们但愿以一种按部就班的方式来学习 TypeScript 的概念 —— 避免使用还没有解释的 TypeScript 特性。这种约束很好地使咱们从新思考语言概念的顺序和类别。这种教学方式让前几页的手册编写变得有点困难，但对开发者来讲确实变得颇有价值，并支持从头至尾的阅览风格。typescript

让编译器说了算

若是你已经使用了网站上新发布的 TypeScript 文档，那么你应该已经注意到咱们提供了一些代码示例，这些示例提供了内联的上下文，例如快速信息提示和错误提示，甚至还能够显示 output.js 和 .d.ts 文件。npm

做为手册的编写者，咱们必须处理好 TypeScript 的变化对文档的影响。当咱们把网站迁移到一个新的 TypeScript 版本时，也会迁移手册。若是结果不一致，咱们很容易发现，并决定须要作哪些改变。后端

使人兴奋的是，咱们正在使用这些工具，将编辑经验中的一些最好的功能带入 Web 页面，并以 epub 或 pdf 格式静态地展现手册。这项技术也能够为你的应用程序提供帮助。

对开发者来讲，这意味着网站中全部的代码示例都是最新的、准确的和交互式的！

针对平常案例进行编写

TypeScript 已经有 8 年的历史了，整体来讲，并无删除功能。咱们在参考页部分记录全部可能的用途，以及任何概念的可行选择。咱们认为这应该能够减小在 TypeScript 启蒙道路上的干扰。

对咱们中的一些人来讲，了解 JavaScript 捆绑模式的历史或者更深奥的 TypeScript 选项如何改变代码流分析可能会颇有趣（对我来讲就是这样！），但大多数人要么是为了 greenfield 项目而学习，要么是在代码库中工做时已经了解了全部这些。

这些规范为咱们提供了一个更有针对性的且更容易学习的 TypeScript 语言指引。咱们会一直是 TypeScript 的忠实粉丝（即便咱们可能更偏心 TypeScript）。

虽说是由我来发布 TypeScript 新手册，并把它推送到网站上的，但在 TypeScript 团队中，新手册业已经是一个持续多年的项目，有了不少的贡献了。在过去的几个月里，咱们得到了你们的好评，这也有助于给咱们如何解释想法提供一些新的视角。因此在这里，我想对每个参与的人说声谢谢!

若是你一直在经过这个博客中的季度性发布说明了解 TypeScript 的最新状况，那你极可能会从新阅读一遍咱们的手册！咱们在其中展现了全部的功能，不管新旧，相互关联，有序介绍。但愿你不会错过那些精彩内容！另外若是你发现了咱们遗漏的内容，请随时在 TypeScript 仓库中提出 Issue 告诉咱们一声。

快来在咱们的官网上或经过下载最新的 Epub、PDF 文件来阅读咱们最新发布的 TypeScript 手册吧！。

若是发现译文存在错误或其余须要改进的地方，欢迎到掘金翻译计划对译文进行修改并 PR，也可得到相应奖励积分。文章开头的 本文永久连接 即为本文在 GitHub 上的 MarkDown 连接。

掘金翻译计划是一个翻译优质互联网技术文章的社区，文章来源为掘金上的英文分享文章。内容覆盖 Android、iOS、前端、后端、区块链、产品、设计、人工智能等领域，想要查看更多优质译文请持续关注掘金翻译计划、官方微博、知乎专栏。