這幾期和大家分享下我自己在開發(fā)時的一些經驗,這次來說說關于Git在開發(fā)流程中的運用。
目的
- 保持提交歷史整潔,俗稱的一條線提交。
- 讓項目代碼有跡可循,提供清晰的開發(fā)歷程,亦稱:取其精華,去其糟粕。
- 幫助大家養(yǎng)成好的代碼開發(fā)習慣,即:如何更好地和他人合作。
- 提供一個思路,讓大家更深刻的理解git。
請先花時間閱讀
- 如果你沒有接觸過git,請先閱讀:http://git-scm.com/book/zh/v2
- 必讀:https://www.atlassian.com/git/tutorials/merging-vs-rebasing
示例系統(tǒng)
我們使用一個簡單的項目作為示例來進行說明。

sys.png
該系統(tǒng)由用戶管理模塊和角色管理模塊組成,該項目已經完成了角色模塊的開發(fā),現在在開發(fā)用戶模塊。
開發(fā)流程
第一步:獲取項目代碼
ligang@vm-xubuntu ~/devspace $ git clone /home/ligang/repository/gitflow.git
Cloning into gitflow...
remote: Counting objects: 6, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 6 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (6/6), done.
當前的提交歷史如下:

init.png
創(chuàng)建遠程合作分支
我們把這個分支命名為user_admin
ligang@vm-xubuntu ~/devspace/gitflow $ git push -u origin user_admin
Total 0 (delta 0), reused 0 (delta 0)
To /home/ligang/repository/gitflow.git
* [new branch] user_admin -> user_admin
Branch user_admin set up to track remote branch user_admin from origin.
操作完成后,提交歷史如下:

user_admin_init.png
說明:合作開發(fā)user_admin模塊的同學,會在這個分支上合并彼此的代碼。
第三步:創(chuàng)建個人分支(真正的開發(fā)工作在這里進行)
我們把這個分支命名為:user_admin_ligang
ligang@vm-xubuntu ~/devspace/gitflow $ git push -u origin user_admin_ligang
Total 0 (delta 0), reused 0 (delta 0)
To /home/ligang/repository/gitflow.git
* [new branch] user_admin_ligang -> user_admin_ligang
Branch user_admin_ligang set up to track remote branch user_admin_ligang from origin.

user_admin_ligang_init.png
請注意:
- 此分支是在遠程合作分支(user_admin)的基礎上創(chuàng)建的。
- 此分支只可合并遠程合作分支,不可以直接合并master。
分支合并流程
假設在user_admin_ligang的個人分支中已經完成了開發(fā),現在需要把這部分代碼提交給被人使用,那么請按照如下方式操作:
假設開發(fā)完成后的提交歷史如下:

user_admin_ligang_before_rebase.png
第一步:整理個人開發(fā)分支中待合并的提交,去掉無用的,僅保留有用的
- 切到user_admin_ligang分支
ligang@vm-xubuntu ~/devspace/gitflow $ git checkout user_admin_ligang
ligang@vm-xubuntu ~/devspace/gitflow $ git branch
master
user_admin
* user_admin_ligang
ligang@vm-xubuntu ~/devspace/gitflow $
- 查找newbase
在這個清理過程中,我需要清理掉tmp1和tmp2這2個臨時提交,所以newbase就是init,這里獲得它的版本號:

find_newbase.png
- 執(zhí)行清理
這一步是不可逆的,請謹慎操作,亦可先備份。

user_admin_ligang_rebase_i.png
這里按照提示,我們編輯rebase信息:

user_admin_ligang_rebase_edit.png
保存退出,由于上面我們告訴rebase我們要重新編輯提交信息(r,reword),這里會進入提交信息編輯界面,我們修改最終提交信息如下:

user_admin_ligang_rebase_reword.png
保存退出,清理過程結束,這里再次查看提交歷史:

user_admin_ligang_rebase_done.png
這里可以看到,tmp1和tmp2已經被清理掉了,最終的done2是一個全新的提交。
第二步:合并個人分支到遠程合作分支
請確保此時只有你一個人操作遠程合作分支
- 更新本地遠程合作分支到最新
ligang@vm-xubuntu ~/devspace/gitflow $ git checkout user_admin
Switched to branch 'user_admin'
ligang@vm-xubuntu ~/devspace/gitflow $ git pull origin user_admin
From /home/ligang/repository/gitflow
* branch user_admin -> FETCH_HEAD
Already up to date.
- 切到user_admin_ligang分支
ligang@vm-xubuntu ~/devspace/gitflow $ git checkout user_admin_ligang
Switched to branch 'user_admin_ligang'
- 衍合個人開發(fā)分支
衍合前

user_admin_before_rebase.png
衍合
ligang@vm-xubuntu ~/devspace/gitflow $ git rebase user_admin
First, rewinding head to replay your work on top of it...
Applying: done2
Using index info to reconstruct a base tree...
M show.txt
Falling back to patching base and 3-way merge...
Auto-merging show.txt
CONFLICT (content): Merge conflict in show.txt
error: Failed to merge in the changes.
Patch failed at 0001 done2
Use 'git am --show-current-patch' to see the failed patch
Resolve all conflicts manually, mark them as resolved with
"git add/rm <conflicted_files>", then run "git rebase --continue".
You can instead skip this commit: run "git rebase --skip".
To abort and get back to the state before "git rebase", run "git rebase --abort".
這里有可能需要解決沖突,再continue完成整個衍合過程。
衍合后

user_admin_after_rebase.png
- 合并入遠程合作分支
ligang@vm-xubuntu ~/devspace/gitflow $ git merge user_admin_ligang
Updating add0d89..9ed757b
Fast-forward
show.txt | 1 +
1 file changed, 1 insertion(+)
合并后的提交歷史

user_admin_merge.png
刪除個人開發(fā)分支
ligang@vm-xubuntu ~/devspace/gitflow $ git branch -d user_admin_ligang
Deleted branch user_admin_ligang (was 9ed757b).
ligang@vm-xubuntu ~/devspace/gitflow $ git push origin :user_admin_ligang
To /home/ligang/repository/gitflow.git
- [deleted] user_admin_ligang
合并到主干
操作前確認
進行這一步操作前,請確認已經滿足如下條件:
- 請確認待合并的遠程合作分支上的開發(fā)目標已全部完成。
- 請確認即將把代碼合并入主干進行發(fā)布上線。
如不能全部滿足上述所有條件,請不要進行此操作。
合并入主干
請確保此時只有你一個人操作遠程分支及主干
- 更新本地主干到最新
ligang@vm-xubuntu ~/devspace/gitflow $ git checkout master
Switched to branch 'master'
Your branch is up to date with 'origin/master'.
ligang@vm-xubuntu ~/devspace/gitflow $ git pull
Already up to date.
- 切到user_admin分支
ligang@vm-xubuntu ~/devspace/gitflow $ git checkout user_admin
Switched to branch 'user_admin'
- 衍合遠程合作分支
ligang@vm-xubuntu ~/devspace/gitflow $ git rebase master
Current branch user_admin is up to date.
這里的過程和遠程合作分支衍合時是一樣的,有可能需要解決沖突,再continue完成整個衍合過程。
- 合并入主干
ligang@vm-xubuntu ~/devspace/gitflow $ git checkout master
Switched to branch 'master'
Your branch is up to date with 'origin/master'.
ligang@vm-xubuntu ~/devspace/gitflow $ git merge user_admin
Updating 73180c1..9ed757b
Fast-forward
show.txt | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
- 刪除遠程合作分支
ligang@vm-xubuntu ~/devspace/gitflow $ git branch -d user_admin
Deleted branch user_admin (was 9ed757b).
ligang@vm-xubuntu ~/devspace/gitflow $ git push origin :user_admin
To /home/ligang/repository/gitflow.git
- [deleted] user_admin
最終的提交歷史

final.png