Bug写作指南

为什么你要读这份指南 简单地说，如果你报告Bug越有效, 工程师完全修复它的可能性就越大。 这份Bug写作指南是针对新手在书写有效的Bug报告方面进行指导的常规指南，并非每个建议都正好适用 于你的软件项目。 如何写一份有用的Bug报告 有用的Bug报告是用于正确修复Bug的。因此一份有用的Bug报告通常地有两个特征： 可复现：如果工程师不能发现或最终证明这一Bug存在,工程师或许会将它标记为 “WORKSFORME”或 ” INVALID “，并且继续进行下一个Bug的修复工作。任何你能提供的详尽描述将为工程师修复Bug提供帮 助。 详细精确：如果工程师能越早隔离、定位问题，就越可能方便地修复。（如果程序员或测试人员不得不像 破译密码一般去寻找跟踪分析Bug，那么他们将花费比修复或测试问题多的多时间去诅咒Bug提交人。） 让我们举一个例子：你正在测试一个Web阅览器，在访问foo.com网站时崩溃了，因此你想写一个Bug报 告: 糟糕的Bug报告：“我的浏览器崩溃了。我正在访问foo.com。我的计算机使用 Windows系统。这真是个 大问题，你们应该马上修复它。顺便说一下,你们的图标真恶心，如果你们保留那些丑陋的图标，没有人将 再使用你们的软件。还有我的祖母的主页看上去外观也不正确，或者，它们全被搞乱了。祝好运。” 有用的Bug报告：“每当我访问foo.com时应用程序就崩溃了，我使用的是在Win NT 4.0 (Service Pack 5) 系统上的 10.28.99版本。 我也曾重新引导进入 Linux，使用10.28.99 Linux版本，这个问题也出现了。我发现每次崩溃都发生在绘 制这个页面位于上端的 Foo横幅的时候。我分析了页面，发现除非你删除 ” border =0″属性，否则下 列图片链接将导致应用程序崩溃 ： ” 如何在Bugzilla中输入你有用的Bug报告 在你输入你发现的Bug前，应使用 Bugzilla查询页检查是否你发现的是已知并被报告的Bug。（如果你发 现的Bug同第37条已经知道的结果相同，你报告的话，就可能骚扰工程师，从而影响工程师修复Bug的效 率。） 下一步,确认你发现的Bug是在最新的版本中所发生的。（工程师更倾向于对那些他们正在编写的代码中的 严重问题感兴趣，而不是对以前那些废弃代码中数以百计的Bug进行修复。） 如果你已经在当前版本中发现了一个新的Bug，请在Bugzilla中报告： 从你的Bugzilla主页中,选择“Enter a new bug”。 选择你发现Bug的产品。 输入你的电子邮件地址、密码，然后按“Login”按钮。（如果你遗忘或还没有得到密码,让密码正文框空 白，并且按 ” E-mail me a password “按钮，不久你将收到包含你的密码的电子邮件。） 现在，填写那张出现的格。以下说明表格中的所有含义： 你在哪儿发现了Bug？ 产品：在哪一个产品中你发现了Bug？ 你在上一页已选择 版本：在产品的哪一个版本中你找到了Bug？ If applicable.如果有的话。 产品单元：在产品的哪一个单元中存在Bug？ Bugzilla在你输入一个Bug时，你必须选择一个产品单元。（如果你无法确定所列产品单元的意思， 单击产品单元链接，那将联接到对每个产品单元的详细描述，这会帮助你作出最好选择。） 平台：在哪一个硬件平台上你找到了这个Bug？ （例如Macintosh、SGI、Sun、PC。）如果你知道这个Bug会发生在所有硬件平台上，请选择“All”，否 则请选择相应的你发现Bug的硬件平台，如果列表中没有出现你的硬件平台，请选择“Other”。 OS：在哪一个操作系统（OS）中你找到了这个Bug？（例如Linux、Windows NT、Mac OS 8.5。） 如果你知道这个Bug会发生在所有OS中，请选择“All”，否则请选择相应的你发现Bug的OS，如果列表 中没有出现你的OS，请选择“Other”。 这个Bug有多重要？ 严重性：这个Bug的破坏性有多大？ 这项值默认为“normal”。（要为一个特定的Bug界定最适当的严重性，单击严重性链接，你将得到每个 选择的完全解释，从Critical到Enhancement。） 谁将跟踪解决Bug？ 分配给：哪一个工程师将负责修复这个Bug？ 在你提交Bug报告后，Bugzilla将自动把Bug分配给默认工程师；填写正文框将允许你用手工方式把它分 配给其他工程师。（要察看每个产品单元的默认工程师列表,请单击产品单元链接。） Cc：还有哪些人将收到这个Bug修复更新的电子邮件? 列出其他需要通过电子邮件收到这个Bug修复更新的人的完整的电子邮件地址。只要你愿意，你可以输入 足够多的电子邮件地址，电子邮件地址之间必须用逗号分隔,不可有空格。