TypeScript 手册
这是一份面向日常开发者的 TypeScript 中文手册,内容整理自 TypeScript 官方文档,按本站文档形态重新组织:章节顺序与官方 Handbook 一致,示例代码与结论保持与原文一致,讲解按中文表达习惯重写。
为什么需要 TypeScript
JavaScript 进入编程社区二十多年后,已经是应用最广泛的跨平台语言之一。它最初只是给网页加一点交互的小脚本语言,如今已成长为各类规模前后端应用的首选。然而,程序的规模、范围与复杂度指数级增长的同时,JavaScript 表达代码单元之间关系的能力并没有同步增长;再加上它颇为特殊的运行时语义,语言能力与程序复杂度之间的错位,让大规模 JavaScript 开发变得难以管理。
程序员最常写出的错误可以概括为类型错误:在期望某种值的地方用了另一种值。原因可能是笔误、对库 API 理解不足、对运行时行为做了错误假设等等。
TypeScript 的目标就是成为 JavaScript 程序的静态类型检查器——一个在代码运行之前(静态)运行、确保程序类型正确的工具(typechecked)。
如果你没有 JavaScript 基础、想以 TypeScript 作为第一门语言,建议先读 JavaScript 入门材料;有其他语言经验的话,通过本手册可以很快上手 JavaScript 语法。
手册如何组织
官方手册分为两部分:
Handbook(手册) —— 面向日常开发者,从上到下顺序阅读即可。每一章都力求让你扎实理解相关概念。它不是完整的语言规范,而是覆盖全部语言特性与行为的综合指南。读完整个手册后,读者应当能够:
- 读懂并理解常用的 TypeScript 语法与模式;
- 解释重要编译选项的作用;
- 在多数情况下正确预测类型系统的行为。
为清晰与简洁起见,手册不会穷举边界情况与细枝末节;某些概念的细节可以在参考(Reference)章节找到。
Reference(参考) —— 位于手册之后,用于更深入地理解 TypeScript 某一具体部分。它可以顺序读,但各节之间并不追求连贯性,每节都聚焦单个概念的深入解释。
手册不做什么
手册也力求「几小时内能读完」,因此有意略去一些主题:
- 不完整介绍 JavaScript 的核心基础(函数、类、闭包等),必要时给出延伸阅读链接;
- 不替代语言规范:某些情况会跳过边界行为与形式化描述,改以高层次、易懂的解释呈现,精确描述在参考页中;
- 基本不涉及 TypeScript 与其他工具的集成(webpack、rollup、parcel、react、babel、vue、angular 等),这些属于手册范围之外。
上手准备
先准备一个可运行的 TypeScript 环境:安装 Node.js 后,用 npm 全局安装编译器。
1 | npm install -g typescript |
新建一个 hello.ts:
1 | function greet(person: string, date: Date) { |
用 tsc hello.ts 编译,会在同目录生成 hello.js。也可以开启 --watch 在保存时自动编译:
1 | tsc --watch hello.ts |
也可以不做类型标注直接写 JavaScript——把文件后缀改成 .ts 就能获得类型检查与编辑器补全:
1 | function greet(person, date) { |
此时编译器会提示:greet 期望 2 个参数,但只传了 1 个。这正是静态类型检查在起作用——在你运行代码之前就把错误暴露出来。
本站章节目录
按建议顺序阅读:
版本与说明
- 内容以 TypeScript 官方 Handbook(
handbook/2/*系列)为底本整理,示例中的诊断码、错误文案按当前编译器版本表述。 - 章节内的「规则」提示保留官方原文的强调语气,方便快速回顾。
- 若与最新官方文档存在差异,以 typescriptlang.org 为准;也欢迎通过页面底部的「编辑此页」提交修正。
评论