提问模板:让别人能复现你的问题
用目标、环境、复现步骤、实际结果、已尝试方法与帮助范围六项信息,把模糊的求助写成别人能够接手排查的问题,并在解决后补全结果。
ADadministrator社区实践者2026年9月13日 · 3 分钟20
#开发#Codex
执行信息
- 测试环境
- 通用提问模板;正文场景仅作演示。
- 输入
- 请查看正文中的输入说明
- 产出
- 请查看正文中的产出说明
- 实测结果
- 请以作者提供的实测记录为准
AgentField 编辑整理|提问资源。以下场景为示例,不代表已发生的用户问题或已验证的修复方案。
“页面打不开”“AI 改完还是不行”能表达困扰,却很难让别人开始排查。一个容易得到有效回复的问题,需要说明你想看到什么、实际发生什么,以及怎样再次遇到它。暂时不知道原因完全没关系,把现象写准就是好的起点。
标题尽量包含对象、触发动作和结果。例如,“求助网站问题”可以改成“手机打开作品首页后出现横向滚动”。正文不用很长,先把下面六项补齐:
1. 目标与预期
我正在做什么?正常情况下应该出现什么结果?
2. 使用环境
操作系统、浏览器或运行环境、相关工具与版本。
问题出现在本地、测试环境还是线上?不确定的明确标注。
3. 最短复现步骤
从哪个页面或命令开始?依次做了什么?哪一步出现问题?
4. 实际结果与证据
发生了什么?附相关截图、完整报错文字或必要的日志片段。
如果没有报错,也请写清页面表现。
5. 已经尝试
改过什么、怎样检查、检查后有什么变化?
不要只写“试了很多方法”。
6. 希望得到的帮助
需要定位方向、解释报错,还是复核某个修改?
说明本次不能改动的部分。
下面是一份简化示例,可替换为你自己的真实信息:
目标:作品首页在手机上正常显示。
环境:填写实际系统、浏览器、项目版本;发生在本地预览。
复现:打开首页 → 将视口设为 375 像素 → 横向拖动页面。
实际:右侧可以拖出空白;附整页截图与相关布局片段。
已尝试:缩短标题后仍能复现,尚未检查图片容器。
希望帮助:判断下一步该检查哪个元素,只调整首页布局。
贴代码时优先给能展示问题的最小片段,同时保留别人理解上下文需要的样式、输入和调用方式。删掉业务数据后如果问题消失,也要说明这一点;不要为了简短,把决定问题是否出现的条件一起删掉。
错误信息请保留原文,包括关键的英文和状态码,另外用自己的话说明当时做了什么。截图可以展示布局,文字更便于搜索和引用。不要要求读者仅凭一张局部截图猜出全部环境。
发送前检查配置、截图和日志,删除密码、密钥、Cookie、令牌、客户资料与私人地址。用“示例域名”“已脱敏”等占位说明被删去的内容,避免读者把占位文字误当实际报错。
收到建议后,一次验证一个关键改动,并回复检查方法和结果。若已经解决,请补充原因、有效修改及仍存在的限制;若没有解决,补上新增证据。后来的读者需要知道哪一步起作用,而不只是看到一句“谢谢,好了”。
参与讨论0 条主题 · 0 条回复
加载讨论