其他語言版本: 英語, 西班牙語, 荷蘭語, 印度語, 俄語, 日語, 越南語, 波蘭語, 韓語, 德語, 簡體中文, 繁體中文, Greek.
如果你的電腦上尚未安裝 git, 請按照這個 安裝指引 進行安裝。
通過點擊圖示中的按鈕,Fork 這個代碼倉庫。 這個操作會將這個代碼倉庫複製到你的賬戶名下。
接下來將複製後的代碼倉庫克隆到你的電腦上,點擊圖示中的綠色按鈕,接著再點擊複製到剪切版按鈕(將代碼倉庫地址複製下來)
隨後打開命令行窗口,敲入如下 git 命令:
git clone "才複製的 url 鏈接"
"才複製的 url 鏈接"(去掉雙引號)就是複製到你賬戶名下的代碼倉庫地址。如何獲取這個鏈接地址請見上一步。
譬如:
git clone https://github.com/你的Github用戶名/first-contributions.git
'你的 Github 用戶名' 指的就是你的 Github 用戶名。在這一步中,你是將複製到你賬戶名下的 first-contributions 這個代碼倉庫克隆到本地電腦上。
通過下面這個命令在命令行窗口中切換到 first-contributions 這個目錄下面
cd first-contributions
接下來使用 git checkout
命令新建一個代碼分支
git checkout -b <新分支的名稱>
譬如:
git checkout -b 新分支的名稱
打開 Contributors.md
這個文件,更新文件內容,將你的名字加上去,保存修改。通過 git status
這個命令你可以看到被改動了的文件被列了出來。接著通過 git add
命令則可以添加你的改動(以便隨後提交改動),就像如下這條命令。
git add Contributors.md
現在就可以使用 git commit
命令 commit 你的修改了。
git commit -m "Add <你的名字> to Contributors list"
將 <你的名字>
替換為你的名字
使用 git push
命令提交代碼
git push origin <分支的名稱>
將 <分支的名稱>
替換為之前新建的分支名稱
前往 Github 你的代碼倉庫,你會看到一個 Compare & pull request
的按鈕。點擊該按鈕。
接著再點擊 Create pull request
按鈕,正式提交 pull request。
收到你提交的變動後,我會將你提交到新分支中的改動,合併到 master(主分支)中。而你複製的代碼倉庫不會自動獲取到合併後的更新內容。為了讓你複製的代碼倉庫和我的代碼倉庫內容保持一致,首先你需要將我的代碼倉庫的地址使用 upstream remote url
命令添加到你的倉庫配置信息中。
git remote add upstream https://github.com/multunus/first-contributions
如此一來,你就讓 git 知道了你本地的這個代碼倉庫在遠端還存在另一個版本(即我的代碼倉庫),而那個版本我們將其叫做 upstream。一旦我合併了你提交的改動到我的代碼倉庫後,你在本地通過下面這個命令便能將更新的內容同步到本地。
git fetch upstream
通過上面這個命令,我們便將遠端我的代碼倉庫(upstream remote)中所有新增的改動抓回到了本地。但這樣還沒有結束,接下來,你也需要將更新 rebase(按照 git 中文文檔將其翻譯為 '衍合')進入你本地的 master 主分支中。
git rebase upstream/master
通過上面這個命令,你就能夠將從遠端抓下來的所有改動衍合到本地的 master 主分支中。接著如果你再做一次 push master 提交你本地代碼到你自己的遠端主分支的操作,你在 Github 上複製的遠端代碼倉庫就也包含最新的代碼了。
git push origin master
注意,上面這個命令中,你遠端的代碼倉庫的名字叫做 origin。
教程使用其他工具
GitHub Desktop | Visual Studio 2017 | GitKraken |
通過下面這些鏈接,你能看到當前流行的眾多代碼倉庫中,適合初學者解決的問題列表,還等什麼,去吧 :)