📘 TypeScript 入门到工程实战
从 JS 到 TS:先看懂别人的类型,再写出自己的类型。
面向有 Python / Java / JavaScript 基础、准备接手前端或 Node 项目的人。不追类型体操,只求读懂、写对、少踩坑。
🗺️ 学习路线图
| 阶段 | 章节 | 内容 |
|---|---|---|
| 📗 入门篇 | 第 1 ~ 3 章 | 认识 TypeScript、搭好环境、基础类型与推断 |
| 📘 核心篇 | 第 4 ~ 8 章 | 函数、对象与接口、联合与收窄、泛型、枚举与常量 |
| 📙 进阶篇 | 第 9 ~ 11 章 | 类与面向对象、模块与 tsconfig 工程化、类型运算入门 |
| 📕 实践篇 | 第 12 ~ 14 章 | 声明文件、真实项目阅读实战、最佳实践与速查 |
📚 章节导航
| 章节 | 难度 · 阅读 | 一句话概要 |
|---|---|---|
| 1 · 初识 TypeScript | ⭐ · 10 min | 为什么需要类型、编译与类型擦除 |
| 2 · 开发环境与第一个项目 | ⭐ · 12 min | Node、tsc 与 tsx、最小 tsconfig |
| 3 · 基础类型与类型推断 | ⭐ · 15 min | 数组与元组、any/unknown/never |
| 4 · 函数与参数类型 | ⭐⭐ · 12 min | 可选参数、回调类型、函数重载 |
| 5 · 对象、接口与类型别名 | ⭐⭐ · 12 min | interface 与 type、只读、索引签名 |
| 6 · 联合、交叉与类型收窄 | ⭐⭐⭐ · 18 min | 判别式联合、四种收窄、穷尽检查 |
| 7 · 泛型 | ⭐⭐⭐ · 15 min | 约束、keyof、常见库类型怎么读 |
| 8 · 枚举、常量与 as const | ⭐⭐ · 10 min | enum 的代价与 as const 替代 |
| 9 · 类、修饰符与面向对象 | ⭐⭐ · 12 min | 修饰符、参数属性、抽象类 |
| 10 · 模块与 tsconfig 工程化 | ⭐⭐⭐ · 15 min | ESM 与 CJS、别名、strict 家族 |
| 11 · 类型运算入门 | ⭐⭐⭐ · 15 min | keyof、映射类型、内置工具类型 |
| 12 · 声明文件与第三方类型 | ⭐⭐⭐ · 12 min | .d.ts、模块扩充、治理 any |
| 13 · 真实项目阅读实战 | ⭐⭐⭐ · 20 min | 按类型走链路、五类报错诊断 |
| 14 · 最佳实践与速查 | ⭐⭐⭐⭐ · 15 min | 目录组织、边界校验、速查表 |
🎯 适合人群
| 人群 | 推荐起点 | 阅读建议 |
|---|---|---|
| 完全没写过 TS | 第 1 章 | 按顺序读,每章的代码直接在本机跑一遍 |
| 会 JS,被类型报错卡住 | 第 3 章 | 重点补第 6、7 章的类型收窄与泛型,其余按需查阅 |
| 后端转前端 / Node | 第 1 章 | 第 9、10 章可对照 Java、Python 的经验快速过 |
| 只想读懂现有项目 | 第 13 章 | 先看第 13 章的方法论,缺哪块类型知识再回查对应章节 |
📂 目录结构
typescript/
├── README.md # 本页:学习路线与章节导航
└── chapters/ # 14 个章节,每章独立文件
├── 01-what-is-typescript.md
├── ...
└── 14-best-practices.md图直接画在正文里(Mermaid),不单独存图片文件。7 张流程图分布在第 1、3、6、7、11、13、14 章。
🧭 怎么读这门课
- 每章开头有「学习目标」,末尾有「本章小结」和「下一章预告」,可以只读小结快速复习。
- 所有代码都写在正文里,可以直接复制到本机的
.ts文件运行;标了bash的是命令,标了json的是配置。 - 遇到类型报错先别急着
as any,第 6 章和第 13 章专门讲怎么从报错反推类型问题。
💡 一句话原则:类型不是写给编译器看的,是写给三个月后的自己看的。