trae报错提示需贴合国内开发场景：用三字段填空法（code/message/reason）和四段式写法（用户看到什么/做了什么/系统拦在哪一步/应提示什么）还原中文业务现场，并按空值、格式错、查无此码、已过期四类给出修复指引，最后生成可直接粘贴至openapi文档的错误描述。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让Trae报错提示词真正贴合国内开发场景
国内前端在调试时看到“TypeError: Cannot read property 'data' of undefined”这种英文堆栈，第一反应不是查源码而是截图发群问“这个错到底哪来的”，因为错误信息没绑定具体页面、没说明用户刚点了什么、也没告诉该清缓存还是重登账号。你需要的不是翻译英文，而是把错误还原成中文业务现场。
直接替换模板：三字段填空法
打开Trae侧边栏→输入指令 /fix →粘贴控制台报错原文后，紧接着按顺序补上这三行（用英文冒号+空格分隔）：
【code】:4002
【message】:优惠码已失效或不存在
【reason】:用户在结算页输入了已过期、已被使用或系统未配置的 promo_code 值
注意：code必须是纯数字业务码，【不要填HTTP状态码如400/500】；message必须是终端用户能看懂的话，不能出现 promo_code 这种参数名。
绑定真实动作的四段式写法
当错误涉及具体操作路径时，强制关联用户行为与接口调用链：
用户看到什么：点击“立即支付”后弹出红色提示框，文字为“优惠码无效”
做了什么：在订单确认页手动输入了“SUMMER2026”并提交
系统拦在哪一步：POST /api/v1/orders 接口校验 promo_code 时返回 code=4002
应提示什么：“优惠码已过期，请更换其他优惠券”
这一步必须对应到真实接口路径和按钮动作，否则前端无法快速定位是UI层传参错了，还是后端校验逻辑漏了分支。
区分子因：空值/格式错/查无此码/已过期
方法一：空值校验失败
请求体示例：{"promo_code": ""}
修复指引：检查输入框是否为空，前端需加非空校验
方法二：正则匹配失败
请求体示例：{"promo_code": "ABC-123-"}
修复指引：优惠码格式应为8位字母+数字组合，如“SUMMER25”
方法三：数据库查无此码
请求体示例：{"promo_code": "WINTER2026"}
修复指引：该优惠码未在运营后台配置，请联系活动负责人
方法四：有效期已过
请求体示例：{"promo_code": "SPRING2026"}
【关键前提】必须从数据库读取 actual_end_time 字段做比对，不能只校验字符串是否包含“2026”】
一键生成中文错误文档片段
把上面四段内容整理成一段可直接粘贴进OpenAPI文档的描述：
客户端请求错误。错误码 4002:优惠码已失效或不存在。（用户在结算页输入了已过期、已被使用或系统未配置的 promo_code 值；典型请求体：{"promo_code": "SUMMER2026"}）
这一步操作起来很简单，复制整段文字→粘贴进接口文档的“错误响应”章节→保存即可。不需要额外改句式，也不用担心术语不统一。
