真实遇到的问题
🐛 真实问题档案：记录开发中实际出现的 Bug，不只保存结论，还保留现象、复现路径、错误假设、根因、修复方案与回归验证。
记录原则
- 先复现，后修改：确认最小复现条件，避免被偶发现象误导
- 区分现象与根因：页面溢出、抖动、光标跳转都只是表象
- 保留排查证据：截图、Trace、DOM、Computed Style、日志和版本信息
- 记录失败尝试：说明方案为什么无效，减少重复踩坑
- 补充回归验证：覆盖浏览器、尺寸、数据边界和交互路径
单个问题记录模板
1. 问题现象
- 用户看到了什么？
- 期望行为是什么？
- 发生频率和影响范围是什么？
2. 环境与复现
- 浏览器、操作系统、设备和版本
- 最小代码或页面路径
- 稳定复现步骤
3. 排查过程
- 已确认的事实
- 做过的实验
- 排除的假设及原因
4. 根因
描述触发条件、底层机制和因果链，而不只是指出出错的代码行。
5. 修复与权衡
记录最终修改、备选方案、兼容性、性能和维护成本。
6. 回归验证
- 原始场景已通过
- 边界数据已测试
- 主流浏览器或设备已验证
- 自动化测试已补充
- 相似模块已排查