大家都知道,在可以解决一个问题之前,你必须先了解这个问题。所以创建问题是一个帮助开源项目的很好的方式。不知道大家有没有下载过开源项目代码,然后把它引入到你的项目中,但是你发现代码中存在问题,不能满足你的要求?你翻来覆去的终于弄清楚,在你需要用到的一个函数里面有一个错误。但是你不知道如何修复错误,这个时候,可以通过GitHub issue的形式构建一个非常好的错误报告,来帮助项目维护者和其他贡献者完善这个开源项目。 现在,我们就来学习如何在我的代码仓库中创建一个错误报告。 首先,转到代码仓库。 图 4-13 在顶部栏上,单击issue。 图 4-14 在这里,您将看到项目的所有打开issue的列表。 所以,首先,你需要检查当前的问题列表中是否已经存在您要报告的问题。您可以使用搜索框查找有关您的问题的关键字,或者扫描现有列表。 通过事先查找问题,您可以帮助项目维护人员减少他们处理重复的问题的工作量。 现在,我们假装没有找到重复的问题。所以我们要创建一个全新的问题。很多人可能不以为然,碰到一个问题就直接提交,其实这样对于开源项目没有太多好处,所以,我们需要确保为项目创建一个真正有用的问题。 那么,对于这个项目,我将尝试在本地计算机中运行项目。 首先,我将回到主代码仓库页面,然后复制克隆链接。 图 4-15 现在,我们将运行git clone并粘贴代码仓库链接。 图 4-16 我将进入我们刚刚克隆的代码仓库。仔细一看: 图 4-17 这里居然没有放虚幻账号的详细介绍链接,这是一个大bug,所以如果你不知道如何自己解决这个问题,你可以为开源项目创建issue。 所以让我们回到GitHub。要创建新问题,让我们点击“issue”选项卡,然后在最右边,我们将单击新问题。 图 4-18 提问题的第一个原则就是要清楚、明确。一个好的问题从标题开始。所以输入:“居然没有放虚幻账号的详细介绍链接” 图 4-19 这很清楚,对吧。 然后在正文中,我们应该把出现的问题的步骤描述清楚,所以维护者和贡献者就方便重现问题。首先,我要描述我看到的: 建议加上虚幻账号的链接:​​http://www.oxox.work/web/virtual-account/​

图 4-20 然后,你还可以在描述中包括你的系统详细信息,因为有些错误可能与你的计算机有关。这里因为和系统肯定没关系,所以我就不添加了。 很好,现在我们需要做的就是点击提交新问题: 图 4-21 这就是我们的问题。与我们有相同问题的其他人可以添加补充的信息到我们的问题中,任何可能的修复都可以引用这个存在的问题。然后把这个问题关闭掉。 在下一个视频中,我们将介绍通过打开一个pull request来修复这个bug。 更多精彩内容尽在视频中!  ​