marscode中高效生成可复现bug描述需三步:首行用控制台第一条红色错误(如“typeerror: cannot read property 'map' of undefined”)激活上下文锚点;接着用动词路径+耗时(如“点击‘导出excel’→3.2秒后弹‘network error’”)或编号步骤(含fmp/耗时)绑定操作链;最后嵌入真实环境约束(如“macbook pro m2 + chrome 126,复现率100%”)和原始报错片段(大小写/空格/括号原样保留)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在MarsCode里快速生成能被开发同事一眼看懂、直接复现的Bug描述,但搜出来的全是“请详细描述问题”“需包含环境信息”这类空泛提示——你真正要的是别人刚贴进飞书工单里的那三行字,带着具体路径、真实报错、操作耗时,连“点开就崩”这种口语都原样保留。
用控制台第一条红字错误当起点
打开浏览器开发者工具→切换到Console标签页→找到最顶部那条红色错误(不是warning,不是堆栈末尾,是第一条)→全选→复制→粘贴到MarsCode搜索框最开头。
这一步不能跳过,【MarsCode会优先匹配报错关键词来激活上下文锚点】。如果只写“页面加载失败”,它默认扫描整个API层;但写成“TypeError: Cannot read property 'map' of undefined”,它立刻锁定UserList.tsx里渲染逻辑那段。
删掉报错后面的括号内容(如“(at src/pages/UserList.tsx:87:12)”),只留核心错误描述,用中文冒号接后续动作。
绑定真实操作路径和耗时
方法一:动词+路径+动作+耗时
例如:“点击‘导出Excel’按钮→触发useExport()→3.2秒后弹出‘Network Error’弹窗→控制台同步出现‘Failed to fetch’”
方法二:分步编号式(必须带时间戳)
① 打开 http://localhost:3000/admin/users → 页面加载完成(FMP=1.4s);
② 在搜索框输入“张三”→回车 → 列表刷新;
③ 点击第二行“编辑”图标 → 2.7秒后页面白屏,Console报“Cannot destructure property ‘id’ of ‘undefined’”。
注意:耗时必须精确到小数点后一位,MarsCode会据此判断是否为异步超时而非语法错误。
嵌入角色权限与现场限制
把你在实际调试中卡住的真实约束条件直接写进去,比如:“前端无nginx access_log权限,无法确认是网关超时还是服务端慢查询”“测试环境未开启Sentry,仅能依赖console.error原始输出”“iOS真机上必现,Simulator里正常”。
【不要写“请说明环境”,要写“我在MacBook Pro M2上用Chrome 126跑,复现率100%”】——后者能让MarsCode自动关联同设备同浏览器版本的历史修复方案。
混入一句调试过程中的原始报错片段
在描述末尾手动加一行你刚复制的、未加工的终端报错片段,例如:
“点击提交后列表不更新,network面板显示200但response.data为空:Uncaught (in promise) TypeError: Cannot convert undefined or null to object at Object.keys (
这句必须保留原始大小写、空格和括号位置,MarsCode靠它识别JS引擎底层错误类型,而不是靠你概括的“数据解析失败”。











