之前一直在自己搭建的博客中寫文章,后續(xù)會把之前寫的博客逐步遷過來包竹。今天先來一篇,介紹一下全球最大的基友社區(qū)——GitHub的簡單使用,原文寫于2017-03-09劫乱。
GitHub
是一個面向開源及私有軟件項目的托管平臺,支持Git作為版本庫格式對項目進行托管锥涕。本文盡量用較少的篇幅對其介紹衷戈,讓大家花更少的時間學會其基本使用,若需要其他更復雜的應用层坠,可以參考網(wǎng)上其他的教程或者官方指南殖妇。
基本概念
repository版本庫,簡單理解就是用來存儲你的多個版本代碼的一個倉庫破花。
branch:分支谦趣,簡單理解為版本庫中存在的多條獨立存在的版本線,常用于一些臨時性的修改座每。
GitHub使用
使用GitHub之前需要先注冊GitHub用戶,普通用戶可以注冊成為免費用戶前鹅,但免費用戶創(chuàng)建的所有項目都是公開的,別人都可以看得到峭梳,若你不希望別人訪問你的項目舰绘,可以注冊付費賬號。
注冊完畢登錄成功之后即可開啟GitHub之旅葱椭。
創(chuàng)建repository
點擊頁面右上角的 +
號捂寿,再點擊展開的 New repository
:
打開新建repository頁面,填入名稱孵运、描述后即可點擊 Create repository
創(chuàng)建一個新的版本庫秦陋。如下,我們新建一個名為HelloWorld的repository:
注意勾選 Initialize this repository with a README
治笨,這樣新建的repository將會被初始化踱侣,同時會在版本庫下新建READE.md文件,默認的內容是版本庫名稱和描述大磺。
內容編輯
新建repository后就可以使用GitHub來編輯抡句、管理你的內容了。
除了可以版本化管理代碼杠愧,其實GitHub可以管理一切數(shù)據(jù)待榔,文檔、圖片、音樂锐锣、視頻等都可以托管再GitHub上腌闯,只是文本型的數(shù)據(jù)可以方便的進行各版本間的差異比較從而有效地進行版本管理,而二進制的數(shù)據(jù)則不能進行比較雕憔,也就相當于把GitHub當作網(wǎng)盤一樣存儲數(shù)據(jù)姿骏。
可以在網(wǎng)頁中新建文件或者從本機上傳文件到GitHub中。
上傳文件
點擊文件列表右上方的 Upload files
按鈕斤彼,
將本地的文件夾或者文件拖到頁面中分瘦,填寫本次操作的描述信息,點擊 Commit changes
,即可將上傳的內容提交到GitHub琉苇,并生成一個版本庫嘲玫。
新建文件
點擊文件列表右上方的 Create new file
! 按鈕,
進入文件編輯頁面并扇,輸入文件名和文件內容去团,以及本次保存提交的描述,點擊 Commit new file
穷蛹,即可將新建的文件提交到版本庫土陪,并生成一個新版本。
文件內容更新
在項目根目錄下肴熏,點擊需要編輯的文件旺坠,在打開的頁面中點擊右方的小鉛筆按鈕,
進入文件編輯模式扮超,編輯完畢后取刃,填寫本次編輯的描述,點擊 Commit changes
,提交本次更改出刷。
刪除文件
在項目根目錄下璧疗,點擊需要編輯的文件,在打開的頁面中點擊右方的垃圾筐按鈕,
在打開的頁面中填寫提交的描述馁龟,點擊 ·Commit changes`,提交本次的文件刪除崩侠。
版本歷史查看
文件列表上方會標出最后一次提交的7位簡短版本號,點擊可以查看該版本的改動的所有文件以及對應的父版本坷檩。
在打開的頁面中同樣標出了本次提交的版本號以及父版本簡短號却音,點擊可繼續(xù)查看父版本的變動。這樣逐層向上矢炼,可以追溯每個文件變動的情況系瓢,這也是使用版本控制系統(tǒng)的優(yōu)勢。
針對某一個文件句灌,可以點擊 History
按鈕夷陋,
查看該文件的版本歷史以及每個版本的改動,還可以點擊 <>
按鈕,查看某個版本對應時間節(jié)點下的repository欠拾。
分支管理
創(chuàng)建分支
默認情況下,repository使用的是master分支(即主分支)骗绕。點擊項目文件列表左上方的 Branch:master
藐窄,輸入新的分支名,點擊下 Create branch:[你輸入的分支名]酬土,即可以當前的repository狀態(tài)為基準創(chuàng)建一個分支荆忍。
在新分支中編輯內容
在新分支下可以獨立的進行內容的編輯。內容編輯完成后撤缴,提交的更改將作為新分支下的版本刹枉,其和默認的master分支將沒有關系。如在UseGit文件中增加了一行內容:
切換到master分支下再次查看該文件的內容腹泌,可以看到該文件并沒有新增的那行內容:
分支內容對比
點擊項目文件列表右上方的 Compare
按鈕嘶卧,
可以對比分支間的差異:
分支合并
在新分支下編輯的內容后尔觉,也可以合并到主分支凉袱。合并分支需要對內容進行更改一方的作者發(fā)起一個請求合并 Pull request
,對修改的內容進行討論,由項目的擁有者查看后決定是否同意合并侦铜。(示例中合并請求的發(fā)起者和項目的擁有者都是作者自己专甩,所以可以直接處理請求)
點擊項目列表左上方的 New pull request
按鈕,或者項目列表右上方的 Pull request
按鈕钉稍,或者在分支內容對比頁面中的 Create pull request
按鈕涤躲,均可進入pull request頁面。
在打開的頁面中贡未,選擇進行編輯的分支和希望合并到的分支种樱,并填寫發(fā)起請求合并的描述信息,點擊 Create pull request
,發(fā)送一個 pull request俊卤。
點擊頁面上方的 Pull requests
嫩挤,在打開的頁面中可以看到當前所有的合并請求。點擊一個請求消恍,可以看到請求發(fā)起者填寫的描述信息和提交的更改及詳細的內容變化岂昭。
若有沖突,需要點擊 resolve conflicts
處理沖突狠怨。
在打開的頁面中根據(jù)實際處理內容约啊,并刪掉沖突標記(標紅的<<<<<<<佣赖、 =======恰矩、 >>>>>>>等行)枢里,點擊頁面上方的 Mark as resolved
,完成沖突處理栏豺,并將此次沖突處理提交作為一個版本庫彬碱。完成后,會回到 合并請求頁面奥洼,此時可以看到已沒有沖突巷疼。項目擁有者可以決定合并該請求或者駁回請求(Close pull request)。
點擊 Merge pull request
,填寫描述信息灵奖,點擊 Confirm merge
,即可將新分支中的內容合并到請求發(fā)起者選定的分支中嚼沿。
合并完成后,可以選擇將新分支刪除:
我們可以檢查合并后文件的內容瓷患÷饩。回到項目文件列表中,可以看到最新的一次提交描述即為之前合并時的提交描述擅编。
點擊該版本的文件攀细,可以看到原來在測試分支
中的內容確實合并到了master分支
,并且可以在上方的提示中看到改版本擁有兩個父版本。
注: 團隊合作或者貢獻開源代碼時爱态,一般是先fork別人的項目到自己的賬戶下谭贪,然后進行修改,修改完成后再 Pull request
锦担,提交請求給原作者合并俭识。
另外,對于Windows用戶洞渔,GitHub發(fā)布了GitHub for Windows套媚,為Windows平臺開發(fā)者提供了一個易于使用的Git圖形客戶端,理解了上面的操作后再使用GitHub for Windows就比較容易磁椒。后面我將專門寫一篇博客介紹 GitHub for Wondows 的使用堤瘤。
本文的介紹到此結束,歡迎大家給我留言交流衷快。