本课程使用指南（先读这里）

0.1 TypeScript 类型能力速查#

从 JavaScript 到 TypeScript 的升级路径#

第一周必须掌握的编译器选项#

类型设计小练习#

type CourseStatus = 'draft' | 'published' | 'archived';

interface Course {
  id: string;
  title: string;
  status: CourseStatus;
  lessons: number;
}

function canPublish(course: Course): boolean {
  return course.status === 'draft' && course.lessons > 0;
}

练习重点不是语法，而是把业务约束提前写进类型，让编辑器在保存前发现错误。

0. 这份资料怎么用#

本模块有 75 篇文档，文件名前缀（010、020……730）大致就是学习顺序。不要跳着读，也不要一次读完。文档分三类：

必读（零基础主线，约 3-4 周）

1. TypeScript 概述与环境配置：先装环境、跑通第一个 TypeScript 程序；
2. 变量与基础类型到泛型基础：变量、函数、类、泛型四篇前篇；
3. 基础类型系统到索引签名与动态属性：类型系统核心（接口、字面量与联合、交叉、枚举、守卫）；
4. 类型兼容性、类型推断深入、as const、never 语义：理解”为什么能赋值、为什么报错”；
5. 命名空间与模块到模块声明与全局类型增强：声明文件与模块解析；
6. 工程化配置、项目示例：API 客户端、项目实战：TODO 应用：工程化与实战收尾。

按需查阅（遇到问题再回来看）

• 高频疑问 FAQ：高频疑问合集，先查这里再搜；
• tsc 编译命令速查：tsc 命令速查；
• 类型测试与断言：类型测试与断言；
• 环境配置末尾的核心术语表与进阶新特性速览。

进阶原理（有项目经验后再读）

• 类型论与理论：TypeScript 理论知识点、satisfies 的形式语义、协变与逆变、this 类型与多态；
• 类型体操：实用模式、深水区、条件类型三部曲、模板字面量类型；
• 编译器与性能：编译与性能优化、TS 6.0 与 7.0。

1. 为什么环境配置排在最前面#

早期版本把”概述与环境配置”排在四篇前篇之后，零基础学习者会在前四篇里反复追问：“我写的代码在哪里运行？tsc 是什么？“。本版已经调整：第 01 课先装环境、跑通 tsc，再学语法。语法学完立刻能在真实工程里验证，认知负担最小。

flowchart LR
    A["020 本指南"] --> B["030 环境配置<br/>跑通 tsc"]
    B --> C["040-070 前篇<br/>变量/函数/类/泛型"]
    C --> D["080-150 类型系统核心"]
    D --> E["160-200 兼容性/推断/const/never"]
    E --> F["290-350 声明文件/模块/工程配置"]
    F --> G["690-700 项目实战"]
    G --> H["370/550/720 命令/类型测试/FAQ 按需查阅"]

2. 三条阅读规则#

规则一：环境先行。 先读环境配置并完成安装；前四篇前篇里的每一段代码都建议放进自己的工程里跑一遍，而不是只读。

规则二：看到公式直接跳过。 少数进阶文档会使用类型论记号（如 Γ ⊢ e : τ）。零基础第一遍只读代码示例、表格和”动手试试”，公式一律跳过。正文不再出现这类记号，需要了解时再看各篇文末的”进阶附录”（如基础类型系统附录 A）。

规则三：新特性速览可跳过。 环境配置末尾的 TS 5.x 新特性速览（const 类型参数、satisfies、using、NoInfer 等）是给有基础的人看的，第一遍读到正文”9. 总结”即可。satisfies 与 as const 都有独立成篇的系统讲解（satisfies 操作符、as const 完整讲解）。

3. 术语不认识怎么办#

1. 先查环境配置末尾的”核心术语表”（零基础速查版）；
2. 再查高频疑问 FAQ的”概念对比”小节；
3. 进阶术语在各篇末尾的”术语表/附录”中查找。

4. 常见误区#

5. 预期时间与验收标准#

6. 一句话记住#

先跑通环境，再学语法；公式跳过、代码必敲；遇到问题先查 FAQ 和术语表。