一、关于手册

在引入编程社区20多年后，JavaScript现在是有史以来最广泛的跨平台语言之一。从一种为网页添加简单交互性的小型脚本语言开始，JavaScript已经发展成为各种规模的前端和后端应用程序的首选语言。虽然用 JavaScript 编写的程序的大小、范围和复杂性呈指数级增长，但 JavaScript 语言表达不同代码单元之间关系的能力却没有。结合JavaScript相当奇特的运行时语义，语言和程序复杂性之间的这种不匹配使得JavaScript开发成为一项难以大规模管理的任务。

程序员编写的最常见类型的错误可以被描述为类型错误：在期望不同类型值的地方使用了某种类型的值。这可能是由于简单的拼写错误、无法理解库的 API 图面、对运行时行为的错误假设或其他错误。TypeScript 的目标是成为 JavaScript 程序的静态类型检查器 - 换句话说，它是一个在代码运行（静态）之前运行的工具，并确保程序的类型正确（类型检查）。

如果你在没有JavaScript背景的情况下来到TypeScript，并且打算让TypeScript成为你的第一语言，我们建议您首先开始阅读Microsoft Learn JavaScript教程中的文档，或者在Mozilla Web Docs上阅读JavaScript。如果你有其他语言的经验，你应该能够通过阅读手册来快速掌握JavaScript语法。

二、手册结构

本手册分为两部分：

1. 手册

TypeScript 手册旨在成为一个全面的文档，向日常程序员解释 TypeScript。您可以通过在左侧导航栏中从上到下阅读手册。

您应该期望每个章节或页面都能为您提供对给定概念的深刻理解。TypeScript 手册不是一个完整的语言规范，但它旨在成为该语言所有功能和行为的全面指南。

完成本演练的读者应该能够：

  • 阅读并理解常用的 TypeScript 语法和模式
  • 解释重要编译器选项的效果
  • 在大多数情况下正确预测类型系统行为
  • 为了清楚和简洁起见，《手册》的主要内容不会探讨所涵盖特征的每一个边缘情况或细节。您可以在参考文章中找到有关特定概念的更多详细信息。

2. 参考文件

导航中手册下方的参考部分旨在更全面地了解 TypeScript 的特定部分的工作原理。你可以从上到下阅读它，但每个部分都旨在为单个概念提供更深入的解释 - 这意味着没有连续性的目标。

三、非目标

该手册还旨在成为一份简明扼要的文件，可以在几个小时内舒适地阅读。为了保持简短，某些主题不会被涵盖。

具体来说，手册没有完全介绍核心JavaScript基础知识，如函数，类和闭包。在适当的情况下，我们将包含指向背景阅读的链接，您可以使用这些链接来阅读这些概念。

该手册也不打算取代语言规范。在某些情况下，边缘情况或行为的正式描述将被跳过，取而代之的是高级，更易于理解的解释。相反，有单独的参考页面可以更精确，更正式地描述TypeScript行为的许多方面。参考页面不适合不熟悉 TypeScript 的读者，因此它们可能使用您尚未阅读的高级术语或参考主题。

最后，除非必要，否则手册不会介绍TypeScript如何与其他工具进行交互。诸如如何使用 webpack、rollup、parcel、react、babel、closure、lerna、rush、bazel、preact、vue、angular、svelte、jquery、yarn 或 npm 来配置 TypeScript 等主题超出了范围 - 您可以在 Web 的其他地方找到这些资源。

四、参考链接