技能 · 编程
JSON 转 TypeScript 类型：先定可选字段
把接口返回的 JSON 样本转成 TypeScript 类型，先判断哪些字段真的可选，避免把所有字段都标成 any 或者全加问号。
适用边界：适合前后端联调初期、字段还不稳定时快速建类型；已用 OpenAPI 或类型生成工具的项目应直接用生成器，手工转换容易和接口漂移。
怎么做
- 先收集三到五份真实响应样本，覆盖正常、空列表和错误三种情况。
- 合并样本，找出只在部分样本里出现的字段，那才是真正的可选字段。
- 给每种字段推断类型，日期用字符串并加注释说明，数组写明元素类型。
- 把类型文件放在请求函数同一目录，接口改字段时同步修改类型定义。
交付前检查
- 类型里没有 any，无法确定的字段标成 unknown 并加注释。
- 可选字段只包含样本中缺失的，不是把所有字段都加问号。
- 空数组和 null 都有对应处理，运行时不会直接报错。
可复制提示词
你是前端类型工程师。输入：【接口 JSON 样本】=____；【接口说明】=____；【项目类型规范】=____。请输出 TypeScript 接口定义：字段名、类型、是否可选、注释。要求可选字段只依据样本缺失判断，无法确定类型时用 unknown 而非 any，日期与枚举加注释。不要虚构接口没有的字段，最后指出三个最容易随接口变化而失配的字段。
相关工具
同类技能
正则编写：先写测试串再写表达式
先写一批应该匹配和不该匹配的样本串，再写正则，逐条跑通才收工，避免表达式只在作者想到的那一种格式上正确。
查看 →SQL 慢查询定位：先看执行计划再改索引
先看执行计划和扫描行数，再判断是缺索引、索引失效还是写法导致全表扫描，改完用同一语句复测耗时。
查看 →接口联调：用 curl 复现再改代码
先用 curl 把接口请求原样复现，排除前端参数和请求头的干扰，确认问题在服务端还是调用方，再动手改代码。
查看 →更新时间：2026-10-29 · 步骤是通用做法，平台/客户规则以实际页面为准；不承诺排名、过稿或收益。
跨库学习路径
按共同关键词匹配，不是随机推荐；从任务到提示词/教程/项目继续走。