之前寫了一個(gè) GitHub 系列，反響很不錯(cuò)，突然發(fā)現(xiàn)竟然還落下點(diǎn)東西沒寫，前段時(shí)間 GitHub 也改版了，借此機(jī)會(huì)補(bǔ)充下。

我們都說(shuō)開源社區(qū)***的魅力是人人多可以參與進(jìn)去，發(fā)揮眾人的力量，讓一個(gè)項(xiàng)目更完善，更強(qiáng)壯。那么肯定有人疑問，我自己目前還沒有能力開源一個(gè)項(xiàng)目，但是想一起參與到別的開源項(xiàng)目中，該怎么操作呢?那么今天，就來(lái)給大家一起介紹下 GitHub 上的一些常見的操作，看完之后你就知道方法了。

我們姑且以 Square 公司開源的 Retrofit 為例來(lái)介紹。

打開鏈接：

https://github.com/square/retrofit

然后看到如下的項(xiàng)目主頁(yè)：

可以看到一個(gè)項(xiàng)目可以進(jìn)行的操作主要就是兩部分，***部分包括 Watch、Star、Fork ，這三個(gè)操作之前的系列介紹過了，這里就不啰嗦了。

我們著重來(lái)介紹第二部分，分別包括 Code、Issues、Pull requests、Projects、Wiki、Pulse、Graphs。接下來(lái)我們來(lái)一個(gè)個(gè)解釋下。

Code

這個(gè)好理解，就是你項(xiàng)目的代碼文件而已，這里說(shuō)明一下，每個(gè)項(xiàng)目通常都會(huì)有對(duì)該項(xiàng)目的介紹，只需要在項(xiàng)目的根目錄里添加一個(gè) README.md 文件就可以，使用 markdown 語(yǔ)法，GitHub 自動(dòng)會(huì)對(duì)該文件進(jìn)行渲染。

Issues

Issues 代表該項(xiàng)目的一些問題或者 bug，并不是說(shuō) Issues 越少越好，Issues 被解決的越多說(shuō)明項(xiàng)目作者或者組織響應(yīng)很積極，也說(shuō)明該開源項(xiàng)目的作者很重視該項(xiàng)目。我們來(lái)看下 Retrofit 的 Issues 主頁(yè)，截至目前 close(解決) 了 1305 個(gè) Issue，open (待解決)狀態(tài)的有 37 個(gè)，這解決問題的比例與速度值得每位開源項(xiàng)目的作者學(xué)習(xí)。

同樣的，大家在使用一些開源項(xiàng)目有問題的時(shí)候都可以提 Issue，可以通過點(diǎn)擊右上角的 New Issue 來(lái)新建 Issue，需要添加一個(gè)標(biāo)題與描述就可以了，這個(gè)操作很簡(jiǎn)單。

Pull requests

我們都知道 GitHub 的***魅力在于人人都可參與，比如別人開源一個(gè)項(xiàng)目，我們每個(gè)人都可以一起參與開發(fā)，一起來(lái)完善，而這都通過 Pull requests 來(lái)完成，簡(jiǎn)稱 PR。這個(gè)沒法在 Retrofit 演示，下面我就以我自己在 GitHub 上的一個(gè)項(xiàng)目 9GAG 來(lái)給大家詳細(xì)演示下怎么給一個(gè)項(xiàng)目發(fā)起 PR：

提前說(shuō)明下，你必須確保你可以正常向 GitHub 提交代碼，如果不可以的話，請(qǐng)看我之前的系列文章。

***步登錄你的 GitHub 賬號(hào)，然后找到你想發(fā)起 PR 的項(xiàng)目，這里以 [9GAG](https://github.com/stormzhang/9GAG) 為例，點(diǎn)擊右上角的 Fork 按鈕，然后該項(xiàng)目就出現(xiàn)在了你自己賬號(hào)的 Repository 里。

請(qǐng)注意，這個(gè)項(xiàng)目原本是屬于 GitHub 賬號(hào) stormzhang 下的，為了演示，我自己又重新注冊(cè)了另一個(gè)賬號(hào)叫 googdev 單純?yōu)榱搜菔径谩?/p>

Fork 之后，在賬號(hào) googdev 下多了一個(gè) 9GAG 的項(xiàng)目，截圖顯示如下：

可以看到 Fork 過來(lái)的項(xiàng)目標(biāo)題底部會(huì)顯示一行小字：fork from stormzhang/9GAG，除此之外，項(xiàng)目代碼跟原項(xiàng)目一模一樣，對(duì)于原項(xiàng)目來(lái)說(shuō)，相當(dāng)于別人新建了一個(gè)分支而已。

第二步，把該項(xiàng)目 clone 到本地，然后修改的 bug 也好，想要新增的功能也好，總之把自己做的代碼改動(dòng)開發(fā)完，保存好。為了方便演示，我這里只在原項(xiàng)目的 README.md 文件添加了一行文字：Fork from stormzhang !

接著，把自己做的代碼改動(dòng) push 到 你自己的 GitHub 上去。

相信看過我前面教程的同學(xué)這一步應(yīng)該都會(huì)，不會(huì)的可以滾回去看前面的教程了。

第三步，點(diǎn)擊你 Fork 過來(lái)的項(xiàng)目主頁(yè)的 Pull requests 頁(yè)面，

點(diǎn)擊 New pull request 按鈕緊接著到如下頁(yè)面：

這個(gè)頁(yè)面自動(dòng)會(huì)比較該項(xiàng)目與原有項(xiàng)目的不同之處，最頂部聲明了是 stormzhang/9GAG 項(xiàng)目的 master 分支與你 fork 過來(lái)的 googdev/9GAG 項(xiàng)目 master 分支所做的比較。

然后最頂部可以方便直觀的看到到底代碼中做了哪些改動(dòng)，你們也看到我就是加了一句 Fork from stormzhang !

同樣的我寫好標(biāo)題和描述，然后我們點(diǎn)擊中間的 Create pull request 按鈕，至此我們就成功給該項(xiàng)目提交了一個(gè) PR。

然后就等著項(xiàng)目原作者 review 你的代碼，并且決定會(huì)不會(huì)接受你的 PR，如果接受，那么恭喜你，你已經(jīng)是該項(xiàng)目的貢獻(xiàn)者之一了。

Projects

這個(gè)是*** GitHub 改版新增的一個(gè)項(xiàng)目，這個(gè)項(xiàng)目就是方便你把一些 Issues、Pull requests 進(jìn)行分類，反正我覺得該功能很雞肋，起碼到目前為止基本沒人用該功能，你們了解下就好。

Wiki

一般來(lái)說(shuō)，我們項(xiàng)目的主頁(yè)有 README.me 基本就夠了，但是有些時(shí)候我們項(xiàng)目的一些用法很復(fù)雜，需要有詳細(xì)的使用說(shuō)明文檔給開源項(xiàng)目的使用者，這個(gè)時(shí)候就用到了 Wiki。

使用起來(lái)也很簡(jiǎn)單，直接 New Page ，然后使用 markdown 語(yǔ)法即可進(jìn)行編寫。

Pulse

Pulse 可以理解成該項(xiàng)目的活躍匯總。包括近期該倉(cāng)庫(kù)創(chuàng)建了多少個(gè) Pull Request 或 Issue，有多少人參與了這個(gè)倉(cāng)庫(kù)的開發(fā)等，都可以在這里一目了然。

根據(jù)這個(gè)頁(yè)面，用戶可以判斷該項(xiàng)目受關(guān)注程度以及項(xiàng)目作者是否還在積極參與解決這些問題等。

Graphs

Graphs 是以圖表的形式來(lái)展示該項(xiàng)目的一個(gè)整體情況。比如項(xiàng)目的全部貢獻(xiàn)人，比如 commits 的圍度分析，比如某天代碼提交的頻繁程度等。

Settings

如果一個(gè)項(xiàng)目是自己的，那么你會(huì)發(fā)現(xiàn)會(huì)多一個(gè)菜單 Settings，這里包括了你對(duì)整個(gè)項(xiàng)目的設(shè)置信息，比如對(duì)項(xiàng)目重命名，比如刪除該項(xiàng)目，比如關(guān)閉項(xiàng)目的 Wiki 和 Issues 功能等，不過大部分情況下我們都不需要對(duì)這些設(shè)置做更改。感興趣的，可以自行看下這里的設(shè)置有哪些功能。

以上就包含了一個(gè) GitHub 項(xiàng)目的所有操作，相信大家看完之后對(duì) GitHub 上一些常用的操作都熟悉了，從現(xiàn)在開始，請(qǐng)一起參與到開源社區(qū)中來(lái)吧，開源社區(qū)需要我們每個(gè)人都貢獻(xiàn)一份力，這樣開源社區(qū)才能越來(lái)越強(qiáng)大，也才能對(duì)更多的人有幫助!

【本文為51CTO專欄作者“stormzhang”原創(chuàng)稿件，轉(zhuǎn)載請(qǐng)聯(lián)系原作者(微信號(hào)：googdev)】