如何有效报告Bug

  1. 良好的态度: 礼貌提问, 保持谦卑,保持好奇; 得到回答请说“谢”。
  2. 准确描述问题:
    1. 报错信息(文本和截图)要完整
      不要以为截图了就完整了,不要自以为关键报错都截进去了,都在里面的话您还来问什么呢?
    2. 预期结果要讲清楚
    3. 不符合预期的现象要标明
  3. 常见的错误原因:
    1. 看不懂报错:
      1. 报错信息中有单词不认识(技术层面不了解),干扰了理解,忽略了路径等问题
      2. 眼神不好使,或者错误信息本身不够清晰(例如C++模板相关编译报错)
    2. 路径错误:
      1. 报错信息包含了路径,但被你忽略;
      2. 报错信息没有直观的路径,你不知道如何查看/懒得查看
      3. 找人提问对方提示了检查路径,你没听进去
    3. 环境变量问题:
      1. 终端程序, 需要新开 shell/terminal/cmd 生效
      2. GUI软件需要重启生效
  4. 提升问题描述准确度的方法:
    1. ”剥洋葱“法: 整理最小复现例子、用 gdb 调试并查看 callstack、查看C/C++的反汇编
    2. 打 log 法: 查看现有log,增加打印 log, 开启 verbose 输出
    3. 检查系统法: 重启系统、查看CPU/内存信息等
    4. 版本控制法: 用 git 管理代码, 二分查找
    5. 搜索提问法: 问 GPT4, 查google, 在 stackoverflow/QQ群提问
    6. 笔记/博客记录法:吃一堑长一智,准确记录错误现象、根因和解决步骤,下次遇到同样问题可快速查询已有解决方案。
posted @ 2024-04-26 22:25  ChrisZZ  阅读(2)  评论(0编辑  收藏  举报