轉, 原文: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'
更多文章的目錄在這裏