用 TypeScript 类型做接口文档，怎么让它跟后端返回保持同步
解决前后端接口类型不一致的核心方案：将 TypeScript 类型定义作为唯一真相来源，通过工具链实现自动化校验。具体做法是用 ts-json-schema-generator 将类型编译为 JSON Schema，再在 CI 中用 Ajv 校验实际响应数据。也可从后端代码直接生成前端类型，或用 OpenAPI 作为中间契约，配合 openapi-diff 检测破坏性变更。针对泛型、联合类型等复杂场景需注意工具版本和配置优化。