phase 5 part 1: typescript, vue, react, ssr(Next.js 16) topics with lessons, scenarios, interviews, verified examples
This commit is contained in:
1 parent
7a32d2c9a6
commit
7b5cae7d24
39 files changed
+2482
-48
No files matched your search
@@ -0,0 +1,89 @@
|
||||
---
|
||||
id: frontend.typescript.type-system
|
||||
title: TypeScript 类型系统进阶:泛型、条件类型、类型收窄、satisfies 和严格配置
|
||||
type: lesson
|
||||
domain: frontend
|
||||
stack: [typescript]
|
||||
tags: [TypeScript, 泛型, 条件类型, infer, 映射类型, 可辨识联合, satisfies, tsconfig]
|
||||
level: intermediate
|
||||
prerequisites: []
|
||||
est_hours: 3
|
||||
related: [frontend.typescript.scenario.api-contract, frontend.vue.index, frontend.typescript.interview]
|
||||
week: [7]
|
||||
order: 1
|
||||
---
|
||||
|
||||
# TypeScript 类型系统进阶:泛型、条件类型、类型收窄、satisfies 和严格配置
|
||||
|
||||
> 你已有 7 年前端经验,这一课只查漏面试常追问的部分。示例基于 TypeScript 5.9 检查通过;TypeScript 7(Go 原生实现的编译器)已发布,语言特性一致,工具链细节以官方文档为准:https://www.typescriptlang.org/docs/
|
||||
|
||||
## 解释说明
|
||||
|
||||
| 主题 | 要点 |
|
||||
| --- | --- |
|
||||
| 泛型约束 | `function get<T, K extends keyof T>(o: T, k: K): T[K]` |
|
||||
| 条件类型 + `infer` | `type Awaited2<T> = T extends Promise<infer U> ? U : T`;联合类型上会**分配**执行 |
|
||||
| 映射类型 | `{ [K in keyof T]?: T[K] }`,`as` 重映射键名;内置 `Partial`、`Pick`、`Omit`、`Record` |
|
||||
| 模板字面量类型 | `` `${M} ${string}` `` 解析字符串结构 |
|
||||
| 可辨识联合 | 共同的字面量字段(`kind`、`ok`)+ `switch` 收窄 + `never` 穷尽检查 |
|
||||
| 类型收窄 | `typeof`、`in`、`instanceof`、自定义类型守卫 `x is T`、断言函数 `asserts x is T` |
|
||||
| `satisfies` | 检查值满足某个类型,同时保留更精确的推断类型(对比 `: Type` 会拓宽) |
|
||||
| `unknown` vs `any` | 外部数据用 `unknown`,必须校验后才能使用 |
|
||||
| 结构化类型 | 只看形状不看名字;需要区分同形状的 ID 时用“品牌类型” |
|
||||
|
||||
**严格配置**(新项目建议):`strict`、`noUncheckedIndexedAccess`(数组 / 索引访问带 `undefined`)、`exactOptionalPropertyTypes`、`verbatimModuleSyntax`;如果要让 Node 直接运行 TS,开启 `erasableSyntaxOnly`(禁止 `enum`、`namespace`、参数属性等需要编译的语法)。
|
||||
|
||||
**最重要的一点**:TS 类型只在编译期存在。后端返回的 JSON、`localStorage`、URL 参数都是 `unknown`,**必须在运行时校验**(手写守卫或 zod / valibot 等库)。
|
||||
|
||||
## 案例
|
||||
|
||||
前端调用订单接口时,后端某次发版把 `status` 新增了 `"refunding"`,前端类型没更新,页面显示空白。改进:接口返回值用运行时校验;状态用可辨识联合 + 穷尽检查,新增状态时编译报错提醒补齐展示逻辑;错误用 `Result` 类型表达,调用方必须处理失败分支。
|
||||
|
||||
## 代码示例
|
||||
|
||||
完整版本:[examples/api-client/api-client.ts](examples/api-client/api-client.ts)(`node api-client.ts` 运行,`tsc -p .` 严格模式检查通过)。
|
||||
|
||||
```ts
|
||||
type Result<T, E = ApiError> = { ok: true; data: T } | { ok: false; error: E };
|
||||
|
||||
type MethodOf<K extends string> = K extends `${infer M} ${string}` ? M : never;
|
||||
const m: MethodOf<"POST /orders"> = "POST";
|
||||
|
||||
const validators = {
|
||||
"GET /orders/:id": isOrder,
|
||||
"POST /orders": isOrder,
|
||||
} satisfies { [K in EndpointKey]: Validator<Endpoints[K]["res"]> }; // 少写一个接口会报错
|
||||
|
||||
function errorText(e: ApiError): string {
|
||||
switch (e.kind) {
|
||||
case "network": return "网络异常,请稍后重试";
|
||||
case "http": return e.status === 404 ? "订单不存在" : `服务异常(${e.status})`;
|
||||
case "validation": return `数据格式错误:${e.issues.join(";")}`;
|
||||
default: return assertNever(e); // 新增 kind 忘了处理会编译报错
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
开启 `noUncheckedIndexedAccess` 后,下面的写法会报错(`results[0]` 可能是 `undefined`),这正是它的价值:
|
||||
|
||||
```ts
|
||||
const [first] = results;
|
||||
if (!first || !first.ok) throw new Error("失败");
|
||||
console.log(first.data.amount); // 收窄后才能访问 data
|
||||
```
|
||||
|
||||
## 易错点
|
||||
|
||||
- 用 `as` 断言代替校验:`resp.json() as Order` 只是骗过编译器。
|
||||
- 滥用 `any`,一处 `any` 会传染到调用链。
|
||||
- `enum` 在“只剥离类型”的运行方式(Node 直接运行、部分构建工具的隔离编译)下不可用,可以用字面量联合 + `as const` 对象代替。
|
||||
- 函数参数的类型推断:泛型参数无法从返回值推断。
|
||||
- `interface` 的声明合并可能导致意外的字段扩展;对外的类型库要注意。
|
||||
- 类型体操写得过于复杂,团队看不懂、编译变慢:类型是为了降低理解成本。
|
||||
|
||||
## 面试常问
|
||||
|
||||
- `type` 和 `interface` 的区别?
|
||||
- `unknown`、`any`、`never` 的区别和使用场景?
|
||||
- 实现一个 `DeepPartial` / `Awaited`?条件类型的分配特性是什么?
|
||||
- `satisfies` 解决什么问题?
|
||||
@@ -0,0 +1,106 @@
|
||||
// 类型安全的 API 客户端:可辨识联合、泛型、类型收窄、穷尽检查、satisfies、运行时校验。
|
||||
// 运行:node api-client.ts(Node 23.6+ 可直接运行 TS,只做类型剥离不做类型检查)
|
||||
// 类型检查:npx tsc --noEmit --strict api-client.ts(也可以用项目的 tsconfig)
|
||||
// 注意:Node 的类型剥离不支持 enum、namespace、构造函数参数属性等需要编译的语法,这里都没有使用。
|
||||
|
||||
// ---------- 1. 用可辨识联合表达“结果”,不用抛异常 ----------
|
||||
type ApiError =
|
||||
| { kind: "network"; message: string }
|
||||
| { kind: "http"; status: number; message: string }
|
||||
| { kind: "validation"; issues: string[] };
|
||||
|
||||
type Result<T, E = ApiError> = { ok: true; data: T } | { ok: false; error: E };
|
||||
|
||||
// ---------- 2. 接口契约:路径 -> 请求 / 响应类型(真实项目可由 OpenAPI 生成) ----------
|
||||
type OrderStatus = "pending" | "paid" | "shipped" | "cancelled";
|
||||
interface Order {
|
||||
id: string;
|
||||
amount: number;
|
||||
status: OrderStatus;
|
||||
}
|
||||
|
||||
interface Endpoints {
|
||||
"GET /orders/:id": { params: { id: string }; body: never; res: Order };
|
||||
"POST /orders": { params: Record<string, never>; body: { amount: number }; res: Order };
|
||||
}
|
||||
type EndpointKey = keyof Endpoints;
|
||||
|
||||
// 模板字面量类型 + infer:从 "GET /orders/:id" 中取出方法
|
||||
type MethodOf<K extends string> = K extends `${infer M} ${string}` ? M : never;
|
||||
const m: MethodOf<"POST /orders"> = "POST";
|
||||
|
||||
// ---------- 3. 运行时校验:TS 类型在运行时不存在,后端返回的数据必须校验 ----------
|
||||
type Validator<T> = (x: unknown) => Result<T>;
|
||||
|
||||
const isOrder: Validator<Order> = (x) => {
|
||||
const issues: string[] = [];
|
||||
const o = x as Partial<Order> | null;
|
||||
if (typeof o?.id !== "string") issues.push("id 应为字符串");
|
||||
if (typeof o?.amount !== "number" || o.amount < 0) issues.push("amount 应为非负数");
|
||||
if (!["pending", "paid", "shipped", "cancelled"].includes(o?.status as string)) issues.push("status 不合法");
|
||||
return issues.length ? { ok: false, error: { kind: "validation", issues } } : { ok: true, data: o as Order };
|
||||
};
|
||||
|
||||
const validators = {
|
||||
"GET /orders/:id": isOrder,
|
||||
"POST /orders": isOrder,
|
||||
} satisfies { [K in EndpointKey]: Validator<Endpoints[K]["res"]> }; // satisfies:检查完整性,同时保留字面量类型
|
||||
|
||||
type Fetcher = (method: string, url: string, body?: unknown) => Promise<{ status: number; json: unknown }>;
|
||||
|
||||
async function request<K extends EndpointKey>(
|
||||
fetcher: Fetcher,
|
||||
key: K,
|
||||
params: Endpoints[K]["params"],
|
||||
body?: Endpoints[K]["body"],
|
||||
): Promise<Result<Endpoints[K]["res"]>> {
|
||||
const [method, pattern] = key.split(" ") as [string, string];
|
||||
const url = pattern.replace(/:(\w+)/g, (_, p: string) => encodeURIComponent((params as Record<string, string>)[p] ?? ""));
|
||||
let resp;
|
||||
try {
|
||||
resp = await fetcher(method, url, body);
|
||||
} catch (e) {
|
||||
return { ok: false, error: { kind: "network", message: String(e) } };
|
||||
}
|
||||
if (resp.status >= 400) return { ok: false, error: { kind: "http", status: resp.status, message: `HTTP ${resp.status}` } };
|
||||
return (validators[key] as Validator<Endpoints[K]["res"]>)(resp.json);
|
||||
}
|
||||
|
||||
// ---------- 4. 穷尽检查:新增错误类型而忘了处理时,编译报错 ----------
|
||||
function assertNever(x: never): never {
|
||||
throw new Error(`未处理的情况:${JSON.stringify(x)}`);
|
||||
}
|
||||
|
||||
function errorText(e: ApiError): string {
|
||||
switch (e.kind) {
|
||||
case "network":
|
||||
return "网络异常,请稍后重试";
|
||||
case "http":
|
||||
return e.status === 404 ? "订单不存在" : `服务异常(${e.status})`;
|
||||
case "validation":
|
||||
return `数据格式错误:${e.issues.join(";")}`;
|
||||
default:
|
||||
return assertNever(e);
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 5. 演示 ----------
|
||||
const fakeServer: Fetcher = async (method, url) => {
|
||||
if (url === "/orders/A1") return { status: 200, json: { id: "A1", amount: 99, status: "paid" } };
|
||||
if (url === "/orders/BAD") return { status: 200, json: { id: "BAD", amount: -1, status: "unknown" } };
|
||||
if (url === "/orders/DOWN") throw new Error("ECONNRESET");
|
||||
return { status: 404, json: null };
|
||||
};
|
||||
|
||||
const results = await Promise.all(
|
||||
["A1", "BAD", "NOPE", "DOWN"].map((id) => request(fakeServer, "GET /orders/:id", { id })),
|
||||
);
|
||||
for (const r of results) {
|
||||
console.log(r.ok ? `订单 ${r.data.id} 状态 ${r.data.status}` : errorText(r.error));
|
||||
}
|
||||
// 开启 noUncheckedIndexedAccess 后 results[0] 的类型带 undefined,必须先判断;
|
||||
// 判断 ok 之后,TS 才知道是哪一个分支,才能访问 data / error(类型收窄)
|
||||
const [first, second] = results;
|
||||
if (!first || !first.ok || first.data.amount !== 99) throw new Error("断言失败");
|
||||
if (!second || second.ok || second.error.kind !== "validation") throw new Error("断言失败");
|
||||
console.log("方法类型:", m);
|
||||
@@ -0,0 +1 @@
|
||||
{"type":"module"}
|
||||
@@ -0,0 +1,15 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2022",
|
||||
"module": "NodeNext",
|
||||
"moduleResolution": "NodeNext",
|
||||
"strict": true,
|
||||
"noUncheckedIndexedAccess": true,
|
||||
"exactOptionalPropertyTypes": true,
|
||||
"verbatimModuleSyntax": true,
|
||||
"erasableSyntaxOnly": true,
|
||||
"noEmit": true,
|
||||
"skipLibCheck": true
|
||||
},
|
||||
"files": ["api-client.ts"]
|
||||
}
|
||||
@@ -4,12 +4,37 @@ title: TypeScript
|
||||
type: index
|
||||
domain: frontend
|
||||
stack: [typescript]
|
||||
tags: []
|
||||
tags: [TypeScript, 类型系统, 运行时校验, 接口契约]
|
||||
week: [7]
|
||||
---
|
||||
|
||||
# TypeScript
|
||||
|
||||
类型系统、泛型、类型收窄、工程配置。
|
||||
你的强项之一,这里只做查漏和面试准备:类型系统进阶、严格配置、运行时校验、前后端类型契约。BOSS直聘 2026-10-23 的调研中约 10 个岗位要求 TS / JS。
|
||||
|
||||
> 本专题建设中:课程、企业场景、面试题和示例代码会陆续补充。
|
||||
## 学习路线
|
||||
|
||||
| 顺序 | 课程 | 级别 | 预计 |
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | [TypeScript 类型系统进阶:泛型、条件类型、类型收窄、satisfies 和严格配置](01-type-system.md) | 进阶 | 3 小时 |
|
||||
|
||||
## 企业场景
|
||||
|
||||
- [前后端类型契约:OpenAPI 生成类型、运行时校验和接口变更管理](scenarios/api-contract.md)
|
||||
|
||||
## 面试题
|
||||
|
||||
- [TypeScript 面试题](interview.md)
|
||||
|
||||
## 示例代码
|
||||
|
||||
- [examples/api-client](examples/api-client/):类型安全的 API 客户端(`Result` 可辨识联合、模板字面量 + `infer`、`satisfies`、穷尽检查、手写运行时校验),`node api-client.ts` 运行,严格 `tsconfig.json` 检查通过
|
||||
|
||||
## 在 16 周计划中
|
||||
|
||||
- [第 7 周:前端工程化查漏](../../../plan/week07-frontend.md)
|
||||
|
||||
## 官方资料
|
||||
|
||||
- https://www.typescriptlang.org/docs/
|
||||
- Node.js 直接运行 TS:https://nodejs.org/api/typescript.html
|
||||
@@ -0,0 +1,67 @@
|
||||
---
|
||||
id: frontend.typescript.interview
|
||||
title: TypeScript 面试题
|
||||
type: interview
|
||||
domain: frontend
|
||||
stack: [typescript]
|
||||
tags: [TypeScript, 面试]
|
||||
level: intermediate
|
||||
related: [frontend.typescript.type-system]
|
||||
week: [7, 16]
|
||||
---
|
||||
|
||||
# TypeScript 面试题
|
||||
|
||||
## 基础
|
||||
|
||||
### 【基础】`type` 和 `interface` 有什么区别?
|
||||
|
||||
**参考答案**:都能描述对象形状。`interface` 可以声明合并、用 `extends` 继承,错误信息更友好;`type` 能表示联合、交叉、条件类型、映射类型、元组等任意类型。常见做法:对象结构用 `interface`,组合和复杂类型用 `type`,团队统一即可。
|
||||
|
||||
**追问**:声明合并有什么用?→ 扩展第三方库的类型,例如给 `Window` 或 Vue 的 `ComponentCustomProperties` 增加字段。
|
||||
|
||||
### 【基础】`any`、`unknown`、`never` 的区别?
|
||||
|
||||
**参考答案**:`any` 关闭类型检查;`unknown` 是安全的顶层类型,使用前必须收窄;`never` 表示不可能出现的值,用于穷尽检查、总是抛异常的函数返回值。
|
||||
|
||||
**追问**:外部数据应该用哪个?→ `unknown`,校验后再转为具体类型。
|
||||
|
||||
### 【基础】什么是类型收窄?有哪些方式?
|
||||
|
||||
**参考答案**:在条件分支中把宽类型缩小为具体类型:`typeof`、`instanceof`、`in`、字面量比较(可辨识联合)、自定义类型守卫 `x is T`、断言函数 `asserts x is T`。
|
||||
|
||||
**追问**:类型守卫写错了会怎样?→ 编译器会相信你的判断,运行时出错;类型守卫要和真实判断逻辑一致,最好有测试。
|
||||
|
||||
## 进阶
|
||||
|
||||
### 【进阶】条件类型的分配特性是什么?
|
||||
|
||||
**参考答案**:当条件类型的检查对象是“裸”类型参数且传入联合类型时,会对联合的每个成员分别计算再合并,例如 `T extends string ? 1 : 0` 传入 `string | number` 得到 `1 | 0`。用 `[T] extends [string]` 包一层可以阻止分配。
|
||||
|
||||
**追问**:实现 `Exclude<T, U>`?→ `type MyExclude<T, U> = T extends U ? never : T`,正是利用了分配特性。
|
||||
|
||||
### 【进阶】`satisfies` 解决什么问题?
|
||||
|
||||
**参考答案**:用 `: Type` 标注变量会把类型拓宽为标注的类型,丢失字面量信息;`as` 不安全。`satisfies` 检查值满足类型约束,同时保留推断出的精确类型,适合配置对象、路由表、映射表。
|
||||
|
||||
**追问**:举个例子?→ `const routes = {...} satisfies Record<string, Route>`,既保证每项是 `Route`,又能用 `keyof typeof routes` 得到精确的键名联合。
|
||||
|
||||
### 【进阶】TS 的类型在运行时存在吗?怎么保证接口数据安全?
|
||||
|
||||
**参考答案**:不存在,编译后被擦除。接口数据要在运行时校验:手写守卫、zod / valibot 等 Schema 库,或者从 OpenAPI 生成校验器;校验失败要降级和上报。
|
||||
|
||||
**追问**:每个接口都校验会不会太重?→ 关键接口和不可信来源必须校验;其余可以依赖生成类型 + 契约测试,权衡包体积和收益。
|
||||
|
||||
## 场景题
|
||||
|
||||
### 【场景题】前后端经常因为接口字段不一致出问题,怎么解决?
|
||||
|
||||
**参考答案**:以 OpenAPI 为契约,前端生成类型,关键接口运行时校验并上报违约,后端 CI 检测破坏性变更,统一错误格式。详见[前后端类型契约场景](scenarios/api-contract.md)。
|
||||
|
||||
**追问**:后端没有 OpenAPI 怎么办?→ 先从最常用的接口开始补;FastAPI 自带,Go 可以用注释生成或手写规范;同时前端先做运行时校验发现问题。
|
||||
|
||||
### 【场景题】大型项目 TS 编译很慢,怎么优化?
|
||||
|
||||
**参考答案**:开启 `skipLibCheck`;使用项目引用(project references)和增量编译;减少复杂的类型体操和巨大的联合类型;类型检查和构建分离(构建只剥离类型,类型检查在 CI 和编辑器中进行);关注 TS 原生编译器(TypeScript 7)带来的速度提升。
|
||||
|
||||
**追问**:怎么找出慢在哪里?→ `tsc --extendedDiagnostics` 查看各阶段耗时,`--generateTrace` 分析具体是哪些类型计算慢。
|
||||
@@ -0,0 +1,87 @@
|
||||
---
|
||||
id: frontend.typescript.scenario.api-contract
|
||||
title: 前后端类型契约:OpenAPI 生成类型、运行时校验和接口变更管理
|
||||
type: scenario
|
||||
domain: frontend
|
||||
stack: [typescript, fastapi, gin]
|
||||
tags: [OpenAPI, 类型生成, 运行时校验, zod, 接口变更, 契约测试]
|
||||
level: intermediate
|
||||
prerequisites: [frontend.typescript.type-system]
|
||||
est_hours: 2.5
|
||||
related: [frontend.typescript.interview, python.fastapi.index, backend.gin.scenario.unified-api-response]
|
||||
week: [7]
|
||||
---
|
||||
|
||||
# 前后端类型契约:OpenAPI 生成类型、运行时校验和接口变更管理
|
||||
|
||||
## 业务背景与问题
|
||||
|
||||
一个后台系统,前端 Vue + TS,后端有 Go(Gin)和 Python(FastAPI)两套服务。常见问题:
|
||||
|
||||
1. 前端的接口类型是手写的,和后端实际返回不一致(字段改名、可空性不同);
|
||||
2. 后端新增了枚举值,前端没有处理,页面空白;
|
||||
3. 接口改了,前端直到联调才发现;
|
||||
4. 错误响应的格式两个后端不一样,前端处理逻辑很乱。
|
||||
|
||||
## 约束
|
||||
|
||||
- 两个后端技术栈不同。
|
||||
- 不能要求后端一次性全部改造。
|
||||
|
||||
## 方案设计
|
||||
|
||||
1. **以 OpenAPI 为契约**:FastAPI 自动生成 OpenAPI;Gin 使用 swag 等工具从注释生成,或者先写 OpenAPI 再生成代码(以对应工具文档为准)。
|
||||
2. **生成前端类型和客户端**:CI 中用 `openapi-typescript` 等工具从 OpenAPI 生成 TS 类型,提交到前端仓库;类型变化在 PR 中可见。
|
||||
3. **运行时校验**:关键接口的返回值用 zod / valibot 或生成的校验器校验,校验失败上报监控(发现后端违约),并降级展示。
|
||||
4. **统一错误格式**:两个后端统一为 `{ code, message, details }`(见 [Gin 统一响应场景](../../../backend/gin/scenarios/unified-api-response.md)),前端用可辨识联合处理。
|
||||
5. **变更管理**:后端改接口时,CI 对比新旧 OpenAPI,检测破坏性变更(删除字段、改类型、必填变化)并阻止合并,除非版本号升级。
|
||||
6. **枚举处理**:前端对未知枚举值有兜底展示,同时穷尽检查保证已知值都被处理。
|
||||
|
||||
## 关键代码
|
||||
|
||||
```ts
|
||||
// 由 OpenAPI 生成(示意):import type { paths } from "./generated/api";
|
||||
// type Order = paths["/orders/{id}"]["get"]["responses"]["200"]["content"]["application/json"];
|
||||
|
||||
import { z } from "zod";
|
||||
|
||||
const OrderSchema = z.object({
|
||||
id: z.string(),
|
||||
amount: z.number().nonnegative(),
|
||||
status: z.enum(["pending", "paid", "shipped", "cancelled"]).or(z.string().transform(() => "unknown" as const)),
|
||||
});
|
||||
type Order = z.infer<typeof OrderSchema>;
|
||||
|
||||
export async function getOrder(id: string): Promise<Result<Order>> {
|
||||
const resp = await fetch(`/api/orders/${encodeURIComponent(id)}`);
|
||||
const json: unknown = await resp.json();
|
||||
const parsed = OrderSchema.safeParse(json);
|
||||
if (!parsed.success) {
|
||||
reportContractViolation("/orders/{id}", parsed.error.issues); // 上报:后端违约
|
||||
return { ok: false, error: { kind: "validation", issues: parsed.error.issues.map((i) => i.message) } };
|
||||
}
|
||||
return { ok: true, data: parsed.data };
|
||||
}
|
||||
```
|
||||
|
||||
不依赖库的手写校验和 `Result` 处理见 [examples/api-client](../examples/api-client/)。zod 的 API 以官方文档为准:https://zod.dev/
|
||||
|
||||
## 取舍
|
||||
|
||||
| 选择 | 优点 | 缺点 |
|
||||
| --- | --- | --- |
|
||||
| **OpenAPI 生成类型 + 关键接口运行时校验(本方案)** | 类型准确,违约能发现 | 需要后端维护准确的 OpenAPI |
|
||||
| 手写类型 | 简单 | 容易和后端不一致 |
|
||||
| 所有接口都运行时校验 | 最安全 | 包体积和性能开销;Schema 维护成本 |
|
||||
| tRPC / 全栈 TS 共享类型 | 体验最好 | 要求后端也是 TS,本项目不适用 |
|
||||
|
||||
## 易错点
|
||||
|
||||
- 生成的类型和实际部署的后端版本不一致(生成时机不对)。
|
||||
- 校验失败直接让页面崩溃,没有降级。
|
||||
- 把后端的 `null` 和“字段不存在”混为一谈。
|
||||
- 破坏性变更检测只在前端做,后端合并时没有拦截。
|
||||
|
||||
## 面试怎么讲
|
||||
|
||||
> “前后端类型我用 OpenAPI 做契约:后端生成 OpenAPI,前端在 CI 里生成 TS 类型,类型变化在 PR 里能看到;关键接口的返回值用 zod 做运行时校验,校验失败上报监控并降级,这样能发现后端违约;错误响应两个后端统一成一种格式,前端用可辨识联合处理;后端 CI 对比 OpenAPI 检测破坏性变更。新增枚举值时,前端有未知值兜底,已知值用穷尽检查保证都处理了。”
|
||||
Reference in new issue
Block a user