整体替换还是局部更新
收录 2026-10
更新接口分不清整体替换和局部修改，没传的字段被当成置空清掉
这个更新接口 [接口名] 用同一种请求体处理整体替换和字段修改，客户端漏传字段时会被当成置空。请区分两种语义，明确哪些字段可空、哪些字段缺省表示不修改、哪些必须整体提交。输出：接口语义说明、请求体字段表（必填、可空、缺省含义）、客户端调用建议、以及历史数据的兼容处理。
本站原创
中文原文
使用示例
示例输入
更新接口用同一个请求体处理整体替换和字段修改，客户端漏传就变置空，帮我区分两种语义。
输出应包含
- 两种语义分开说明并给字段表
- 标出可空与缺省不修改的字段
- 历史数据的兼容处理给做法
复制前替换这些占位符 1
把方括号里的内容换成你的具体信息，替换后再粘贴给 AI。
[接口名]
使用建议
「缺省」和「显式置空」必须能区分，否则这个坑永远修不干净。
可以这样改
- 要求它先复述需求与约束，确认无误再写代码。
- 让它给出最小改动 + 回滚方式，而不是整文件重写。
交付物（这次应拿到什么）
- 可运行的最小改动（含直接可用的代码块）
- 影响面清单：改了哪些文件、哪些调用点要跟着改
常见错法
- 一次让它改十个文件，最后分不清哪处改动导致了新问题。
- 只贴报错不贴代码和版本，拿到无法落地的修法。
输出验收（怎么判断能用）
- 改动可运行、可回滚，且没顺手改无关代码。
- 边界条件（空值、超长、并发）有说明或测试。
适用场景与注意
- 适合：让它先复述需求和约束，再给最小可运行改动。
- 注意：贴报错时同时给版本号与最小复现，否则它容易给出看似合理但不适配的写法。