JavaScript / TypeScript / 系统课时
重构与课程总结
重构与课程总结
项目完成后,真正提升质量的步骤是回看类型是否准确、边界是否可信、错误是否可处理。本课通过一次小型重构移除 any 和重复模型,并总结后续进入框架开发前应保留的 TypeScript 习惯。
学习目标
- 识别常见的不安全类型写法
- 用单一模型和运行时校验完成重构
- 建立后续框架学习的 TypeScript 检查清单
识别重构信号
下面代码可以编译,但问题集中:
ts
async function loadOrder(id: any): Promise {
const response = await fetch(`/api/orders/${id}`);
const data = await response.json();
return data as {
id: string;
status: string;
};
}风险包括:参数允许任意值;返回值丢失类型约束;响应未检查状态码;status 过宽;类型断言没有验证数据。
重构边界与模型
ts
type OrderStatus =
| "pending"
| "paid"
| "cancelled";
interface Order {
id: string;
status: OrderStatus;
}
function isOrder(value: unknown): value is Order {
if (typeof value !== "object" || value === null) {
return false;
}
if (!("id" in value) || typeof value.id !== "string") {
return false;
}
if (!("status" in value)) {
return false;
}
return (
value.status === "pending" ||
value.status === "paid" ||
value.status === "cancelled"
);
}
async function loadOrder(id: string): Promise {
const response = await fetch(
`/api/orders/${encodeURIComponent(id)}`
);
if (!response.ok) {
throw new Error(`Request failed: ${response.status}`);
}
const data: unknown = await response.json();
if (!isOrder(data)) {
throw new Error("Invalid order response");
}
return data;
}重构后的边界是:调用方提供 string 编号,网络响应进入 unknown,校验通过后才返回 Order。这与 TypeScript 将 unknown 作为更安全顶层类型、通过控制流进行收窄的设计一致。:contentReference[oaicite:12]{index=12}
验证重构结果
使用模拟 fetch 的完整运行示例:
ts
globalThis.fetch = async () =>
new Response(
JSON.stringify({
id: "ORD-1001",
status: "paid"
}),
{
status: 200,
headers: { "Content-Type": "application/json" }
}
);
const order = await loadOrder("ORD-1001");
console.log(order.id, order.status);预期输出
text
ORD-1001 paid项目级检查清单
完成一个 TypeScript 模块后,重点检查:
- 是否仍有无理由的
any、双重断言或非空断言 - 外部数据是否先作为
unknown校验 - 状态是否使用字面量联合或判别联合
- 公共函数的输入、输出和错误是否明确
- 类型检查、测试和构建是否能由一条命令完成
- 生成产物是否与运行环境的模块规则一致
不要追求“类型越复杂越高级”。稳定项目更看重模型清楚、错误可定位、边界可验证和代码易读。
后续学习路线
进入 React、Vue、Node.js 或服务端框架时,继续沿用本课程的核心顺序:先建模,再验证外部数据,再实现业务逻辑,最后通过类型检查与测试验收。随后可深入泛型约束、条件类型、声明文件、模块发布和项目引用,但应由真实需求驱动复杂度。
本课总结
- 重构优先消除不安全边界,而不是增加复杂类型技巧
unknown → 校验 → 业务类型是处理外部数据的稳定路径- 类型设计、测试、构建和发布应形成同一套工程闭环
下一课预告
本课程到此完成。接下来可选择一个前端或 Node.js 框架项目,把类型建模、API 校验、测试与构建流程应用到真实业务中。
按自己的节奏,确认真正理解。