【轉】git幫助閱讀開源項目

 

轉, 原文:https://segmentfault.com/a/1190000009475214

-------------------------------

 

爲什麼要閱讀開源項目

  • 源碼是唯一的真實

  • 加深對項目的理解

  • 學習自己沒有的知識

  • 學習他人的寫法,有助於自己代碼質量的提高

開源項目難點

  • 不知道從哪兒開始

  • 文件太多,無法屢清楚結構

  • 代碼太多,測試編譯時耗費太多時間

  • 內容太多,難以全面理解

開源項目特點

開源項目最早只是一個idea, 這個idea是這個項目的根,隨着項目的發展,特性會越來越多,架構可能會調整,但這個idea總是不變的,它是整個項目的精華.
而我們如果想要理解一個開源項目,弄懂這個idea是必須的, 很多時候我們就是爲了深入理解這個idea才產生閱讀源碼的動機。

隨者這個idea的實現,這個項目算是誕生了。但隨着越來越多特性的加入,越來越多代碼的提交,這個idea越來越深的掩藏起來。所以我們可以從早期版本入手.

最早完成idea的版本中這個idea是最清晰的,代碼量是最少的,也是我們理解這個項目的最佳時機.

使用git幫助理解開源項目

早期版本是切入開源項目的好時機,git是版本控制領域的佼佼者,使用git幫助理解開源項目

逆序查看日誌
git log --reverse
找一個感興趣的版本切入
git checkout <commit-id>
導航與對比
  • 切換當前提交的上一次提交

git checkout HEAD~
  • 切換當前提交的下一次提交

git log --reverse --pretty=%H master | grep -A 1 $(git rev-parse HEAD) | tail -n1 | xargs git checkout;
  • 比較上一個分支與當前分支

git diff HEAD~..HEAD
追蹤文件的變更歷史
git log --follow path/to/source_file

根據需要,可以專門閱讀該文件相關的某個特定的commit,很多時候項目第一版的代碼會比最新版的代碼簡單很多,閱讀舊版的代碼可能會比較容易。如果是爲了修復bug而讀代碼,這樣的變更歷史有時候可以提示我們哪個commit可能引入了bug。

查找字段(函數名,變量名)
git grep -w func -A100 -B100

假設有一個內部函數叫做func(), 沒有文檔,如何知道這個函數怎麼用?除了閱讀內部函數的實現和閱讀實例,基本上沒有其他方法。對於這種情況
可以批量找到func的用例,在vim裏從上往下先掃一遍,找到儘可能簡單的用例,然後再返回到源文件中閱讀這個用例的上下文.

git alias

有些常用的git操作,我們可以通過設置git alias加快輸入

git config --global alias.prev 'checkout HEAD~'
git config --global alias.next '! f() { git log --reverse --pretty=%H ${1:-master} | grep -A 1 $(git rev-parse HEAD) | tail -n1 | xargs git checkout; }; f'
git config --global alias.difp 'diff HEAD~..HEAD'

更多文章的目錄在這裏

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章