报告错误

建议编辑

感谢您对项目的贡献兴趣!公共错误跟踪是开放开发过程的重要组成部分。为了确保有效的错误报告,请遵循以下指南:

使用 GitHub 问题跟踪器

我们使用公共问题跟踪器 GitHub Issues Tracker 来跟踪当前和已解决的问题。在提交新的错误报告之前,建议先搜索问题列表,查看您的报告是否已被提交。如果发现已有的报告,请添加一个反应以表明您也受到影响。只有在能帮助识别问题来源时,才在评论中提供额外信息。像“我也有这个问题”或“这是一个非常重要的问题”这样的评论没有必要。

提交新问题

如果您的错误报告尚未提交,您可以继续创建一个新问题。在填写“新问题”页面时,请注意以下几点:

在摘要中具体说明

您的错误报告摘要将在错误跟踪器中作为标题。确保它具体且准确地描述问题。具体的摘要有助于开发人员和错误管理人员轻松搜索现有报告,避免重复报告。避免使用像“应用程序无法工作”或“提高性能”这样的模糊摘要。相反,使用像“进程完成时未发送通知”这样的摘要。

避免主观或模糊的语言

为了增加报告被确认的机会,请提供客观细节,而不是使用主观或模糊的语言。不要将某事标记为“刺耳”或“不直观”,而是描述发生了什么以及它如何与您的期望相悖。例如,您可以说“Toast 突然出现而不是动画显示”,这提供了可操作的和客观的信息。

简明扼要,但要解释问题

错误报告应以英语书写,注意语言和语法。提供足够的信息以便开发人员重现问题是至关重要的。如有必要,包括清晰和编号的步骤以重现错误。

请记住,错误报告旨在汇集面临类似问题的用户,共同努力解决问题。虽然您的报告可能会导致合作,但不要期望其他人单独解决您的问题。将错误报告作为联合解决问题的起点。

准备好提供更多信息

报告中信息不足可能导致其被标记为“不完整”。开发人员可能会通过评论请求具体的额外细节。如果未能提供所需信息,您的报告可能会被关闭。

如果您不小心将问题报告到错误的应用程序,可能会被标记为“无效”。如果知道正确的应用程序,开发人员可能会要求您重新提交报告。否则,您应该找到正确的应用程序并自行重新提交报告。

对于像功能请求这样的“愿望清单”问题,开发人员可能会将其标记为“意见”或“不会修复”。请记住,开发人员通常愿意讨论这些话题,但必须尊重他们的决定,不要因为他们这样标记您的报告而骚扰他们。

感谢您为项目做出的贡献!您的错误报告对于改进我们的软件非常宝贵。

我们的朋友