視訊教程觀看地址：http://study.163.com/course/courseMain.htm?courseId=1003674052

大家都知道，在可以解決一個問題之前，你必須先了解這個問題。所以建立問題是一個幫助開源專案的很好的方式。不知道大家有沒有下載過開源專案程式碼，然後把它引入到你的專案中，但是你發現程式碼中存在問題，不能滿足你的要求？你翻來覆去的終於弄清楚，在你需要用到的一個函式裡面有一個錯誤。但是你不知道如何修復錯誤，這個時候，可以通過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。

更多精彩內容盡在視訊中！

 

本文固定連結：http://www.oxox.work/web/github/bug/ | 虛幻大學
 


檢視原文：http://www.oxox.work/web/github/bug/