Git飛行規(guī)則(Flight Rules)
前言
- 英文原版README
- 翻譯可能存在錯誤或不標準的地方,歡迎大家指正和修改,謝謝!
什么是"飛行規(guī)則"?
一個 宇航員指南 (現(xiàn)在, 程序員們都在使用GIT) 是關于出現(xiàn)問題過后應該怎么操作。
飛行規(guī)則(Flight Rules) 是記錄在手冊上的來之不易的一系列知識五督,記錄了某個事情發(fā)生的原因,以及怎樣一步一步的進行處理瓶殃。本質上, 它們是特定場景的非常詳細的標準處理流程充包。 [...]
自20世紀60年代初以來,NASA一直在捕捉(capturing)我們的失誤,災難和解決方案, 當時水星時代(Mercury-era)的地面小組首先開始將“經(jīng)驗教訓”收集到一個綱要(compendium)中基矮,該綱現(xiàn)在已經(jīng)有上千個問題情景淆储,從發(fā)動機故障到破損的艙口把手到計算機故障,以及它們對應的解決方案家浇。
— Chris Hadfield, 一個宇航員的生活指南(An Astronaut's Guide to Life)本砰。
這篇文章的約定
為了清楚的表述,這篇文檔里的所有例子使用了自定義的bash 提示钢悲,以便指示當前分支和是否有暫存的變化(changes)点额。分支名用小括號括起來,分支名后面跟的*
表示暫存的變化(changes)莺琳。
[圖片上傳失敗...(image-4f1429-1512008581455)]
Table of Contents generated with DocToc
- 編輯提交(editting commits)
- 暫存(Staging)
- 未暫存(Unstaged)的內容
- 分支(Branches)
- Rebasing 和合并(Merging)
- 雜項(Miscellaneous Objects)
- 跟蹤文件(Tracking Files)
- 配置(Configuration)
- 我不知道我做錯了些什么
- 其它資源(Other Resources)
編輯提交(editting commits)
<a name="diff-last"></a>
我剛才提交了什么?
如果你用 git commit -a
提交了一次變化(changes)晒杈,而你又不確定到底這次提交了哪些面容嫂伞。 你就可以用下面的命令顯示當前HEAD
上的最近一次的提交(commit):
(master)$ git show
或者
$ git log -n1 -p
<a name="#i-wrote-the-wrong-thing-in-a-commit-message"></a>
我的提交信息(commit message)寫錯了
如果你的提交信息(commit message)寫錯了且這次提交(commit)還沒有推(push), 你可以通過下面的方法來修改提交信息(commit message):
$ git commit --amend
這會打開你的默認編輯器, 在這里你可以編輯信息. 另一方面, 你也可以用一條命令一次完成:
$ git commit --amend -m 'xxxxxxx'
如果你已經(jīng)推(push)了這次提交(commit), 你可以修改這次提交(commit)然后強推(force push), 但是不推薦這么做。
<a name="commit-wrong-author"></a>
我提交(commit)里的用戶名和郵箱不對
如果這只是單個提交(commit)拯钻,修改它:
$ git commit --amend --author "New Authorname <authoremail@mydomain.com>"
如果你需要修改所有歷史, 參考 'git filter-branch'的指南頁.
<a href="#i-want-to-remove-a-file-from-a-commit"></a>
我想從一個提交(commit)里移除一個文件
通過下面的方法帖努,從一個提交(commit)里移除一個文件:
$ git checkout HEAD^ myfile
$ git add -A
$ git commit --amend
這將非常有用,當你有一個開放的補丁(open patch)粪般,你往上面提交了一個不必要的文件拼余,你需要強推(force push)去更新這個遠程補丁。
<a name="delete-pushed-commit"></a>
我想刪除我的的最后一次提交(commit)
如果你需要刪除推了的提交(pushed commits)亩歹,你可以使用下面的方法匙监。可是小作,這會不可逆的改變你的歷史亭姥,也會搞亂那些已經(jīng)從該倉庫拉取(pulled)了的人的歷史。簡而言之顾稀,如果你不是很確定达罗,千萬不要這么做。
$ git reset HEAD^ --hard
$ git push -f [remote] [branch]
如果你還沒有推到遠程, 把Git重置(reset)到你最后一次提交前的狀態(tài)就可以了(同時保存暫存的變化):
(my-branch*)$ git reset --soft HEAD@{1}
這只能在沒有推送之前有用. 如果你已經(jīng)推了, 唯一安全能做的是 git revert SHAofBadCommit
静秆, 那會創(chuàng)建一個新的提交(commit)用于撤消前一個提交的所有變化(changes)粮揉; 或者, 如果你推的這個分支是rebase-safe的 (例如: 其它開發(fā)者不會從這個分支拉), 只需要使用 git push -f
巡李; 更多, 請參考 the above section。
<a name="delete-any-commit"></a>
刪除任意提交(commit)
同樣的警告:不到萬不得已的時候不要這么做.
$ git rebase --onto SHA1_OF_BAD_COMMIT^ SHA1_OF_BAD_COMMIT
$ git push -f [remote] [branch]
或者做一個 交互式rebase 刪除那些你想要刪除的提交(commit)里所對應的行滔蝉。
<a name="#force-push"></a>
我嘗試推一個修正后的提交(amended commit)到遠程击儡,但是報錯:
To https://github.com/yourusername/repo.git
! [rejected] mybranch -> mybranch (non-fast-forward)
error: failed to push some refs to 'https://github.com/tanay1337/webmaker.org.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
注意, rebasing(見下面)和修正(amending)會用一個新的提交(commit)代替舊的, 所以如果之前你已經(jīng)往遠程倉庫上推過一次修正前的提交(commit),那你現(xiàn)在就必須強推(force push) (-f
)蝠引。 注意 – 總是 確保你指明一個分支!
(my-branch)$ git push origin mybranch -f
一般來說, 要避免強推. 最好是創(chuàng)建和推(push)一個新的提交(commit)阳谍,而不是強推一個修正后的提交。后者會使那些與該分支或該分支的子分支工作的開發(fā)者螃概,在源歷史中產(chǎn)生沖突矫夯。
<a href="undo-git-reset-hard"></a>
我意外的做了一次硬重置(hard reset),我想找回我的內容
如果你意外的做了 git reset --hard
, 你通常能找回你的提交(commit), 因為Git對每件事都會有日志吊洼,且都會保存幾天训貌。
(master)$ git reflog
你將會看到一個你過去提交(commit)的列表, 和一個重置的提交。 選擇你想要回到的提交(commit)的SHA冒窍,再重置一次:
(master)$ git reset --hard SHA1234
這樣就完成了递沪。
暫存(Staging)
<a href="#i-need-to-add-staged-changes-to-the-previous-commit"></a>
我需要把暫存的內容添加到上一次的提交(commit)
(my-branch*)$ git commit --amend
<a name="commit-partial-new-file"></a>
我想要暫存一個新文件的一部分,而不是這個文件的全部
一般來說, 如果你想暫存一個文件的一部分, 你可這樣做:
$ git add --patch filename.x
-p
簡寫综液。這會打開交互模式款慨, 你將能夠用 s
選項來分隔提交(commit); 然而, 如果這個文件是新的, 會沒有這個選擇谬莹, 添加一個新文件時, 這樣做:
$ git add -N filename.x
然后, 你需要用 e
選項來手動選擇需要添加的行檩奠,執(zhí)行 git diff --cached
將會顯示哪些行暫存了哪些行只是保存在本地了。
<a href="stage-in-two-commits"></a>
我想把在一個文件里的變化(changes)加到兩個提交(commit)里
git add
會把整個文件加入到一個提交. git add -p
允許交互式的選擇你想要提交的部分.
<a href="unstaging-edits-and-staging-the-unstaged"></a>
我想把暫存的內容變成未暫存附帽,把未暫存的內容暫存起來
這個有點困難埠戳, 我能想到的最好的方法是先stash未暫存的內容, 然后重置(reset)蕉扮,再pop第一步stashed的內容, 最后再add它們整胃。
$ git stash -k
$ git reset --hard
$ git stash pop
$ git add -A
未暫存(Unstaged)的內容
<a href="move-unstaged-edits-to-new-branch"></a>
我想把未暫存的內容移動到一個新分支
$ git checkout -b my-branch
<a href="move-unstaged-edits-to-old-branch"></a>
我想把未暫存的內容移動到另一個已存在的分支
$ git stash
$ git checkout my-branch
$ git stash pop
<a href="i-want-to-discard-my-local-uncommitted-changes"></a>
我想丟棄本地未提交的變化(uncommitted changes)
如果你只是想重置源(origin)和你本地(local)之間的一些提交(commit),你可以:
# one commit
(my-branch)$ git reset --hard HEAD^
# two commits
(my-branch)$ git reset --hard HEAD^^
# four commits
(my-branch)$ git reset --hard HEAD~4
# or
(master)$ git checkout -f
重置某個特殊的文件, 你可以用文件名做為參數(shù):
$ git reset filename
<a href="i-want-to-discard-specific-unstaged-changes"></a>
我想丟棄某些未暫存的內容
如果你想丟棄工作拷貝中的一部分內容慢显,而不是全部爪模。
簽出(checkout)不需要的內容,保留需要的荚藻。
$ git checkout -p
# Answer y to all of the snippets you want to drop
另外一個方法是使用 stash
屋灌, Stash所有要保留下的內容, 重置工作拷貝, 重新應用保留的部分。
$ git stash -p
# Select all of the snippets you want to save
$ git reset --hard
$ git stash pop
或者, stash 你不需要的部分, 然后stash drop应狱。
$ git stash -p
# Select all of the snippets you don't want to save
$ git stash drop
分支(Branches)
<a name="pull-wrong-branch"></a>
我從錯誤的分支拉取了內容共郭,或把內容拉取到了錯誤的分支
這是另外一種使用 git reflog
情況,找到在這次錯誤拉(pull) 之前HEAD的指向。
(master)$ git reflog
ab7555f HEAD@{0}: pull origin wrong-branch: Fast-forward
c5bc55a HEAD@{1}: checkout: checkout message goes here
重置分支到你所需的提交(desired commit):
$ git reset --hard c5bc55a
完成除嘹。
<a href="discard-local-commits"></a>
我想扔掉本地的提交(commit)写半,以便我的分支與遠程的保持一致
先確認你沒有推(push)你的內容到遠程。
git status
會顯示你領先(ahead)源(origin)多少個提交:
(my-branch)$ git status
# On branch my-branch
# Your branch is ahead of 'origin/my-branch' by 2 commits.
# (use "git push" to publish your local commits)
#
一種方法是:
(master)$ git reset --hard origin/my-branch
<a name="commit-wrong-branch"></a>
我需要提交到一個新分支尉咕,但錯誤的提交到了master
在master下創(chuàng)建一個新分支叠蝇,不切換到新分支,仍在master下:
(master)$ git branch my-branch
把master分支重置到前一個提交:
(master)$ git reset --hard HEAD^
HEAD^
是 HEAD^1
的簡寫,你可以通過指定要設置的HEAD
來進一步重置年缎。
或者, 如果你不想使用 HEAD^
, 找到你想重置到的提交(commit)的hash(git log
能夠完成)悔捶, 然后重置到這個hash。 使用git push
同步內容到遠程单芜。
例如, master分支想重置到的提交的hash為a13b85e
:
(master)$ git reset --hard a13b85e
HEAD is now at a13b85e
簽出(checkout)剛才新建的分支繼續(xù)工作:
(master)$ git checkout my-branch
<a name="keep-whole-file"></a>
我想保留來自另外一個ref-ish的整個文件
假設你正在做一個原型方案(原文為working spike (see note)), 有成百的內容蜕该,每個都工作得很好。現(xiàn)在, 你提交到了一個分支洲鸠,保存工作內容:
(solution)$ git add -A && git commit -m "Adding all changes from this spike into one big commit."
當你想要把它放到一個分支里 (可能是feature
, 或者 develop
), 你關心是保持整個文件的完整堂淡,你想要一個大的提交分隔成比較小。
假設你有:
- 分支
solution
, 擁有原型方案扒腕, 領先develop
分支绢淀。 - 分支
develop
, 在這里你應用原型方案的一些內容。
我去可以通過把內容拿到你的分支里瘾腰,來解決這個問題:
(develop)$ git checkout solution -- file1.txt
這會把這個文件內容從分支 solution
拿到分支 develop
里來:
# On branch develop
# Your branch is up-to-date with 'origin/develop'.
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: file1.txt
然后, 正常提交更啄。
Note: Spike solutions are made to analyze or solve the problem. These solutions are used for estimation and discarded once everyone gets clear visualization of the problem. ~ Wikipedia.
<a name="cherry-pick"></a>
我把幾個提交(commit)提交到了同一個分支,而這些提交應該分布在不同的分支里
假設你有一個master
分支居灯, 執(zhí)行git log
, 你看到你做過兩次提交:
(master)$ git log
commit e3851e817c451cc36f2e6f3049db528415e3c114
Author: Alex Lee <alexlee@example.com>
Date: Tue Jul 22 15:39:27 2014 -0400
Bug #21 - Added CSRF protection
commit 5ea51731d150f7ddc4a365437931cd8be3bf3131
Author: Alex Lee <alexlee@example.com>
Date: Tue Jul 22 15:39:12 2014 -0400
Bug #14 - Fixed spacing on title
commit a13b85e984171c6e2a1729bb061994525f626d14
Author: Aki Rose <akirose@example.com>
Date: Tue Jul 21 01:12:48 2014 -0400
First commit
讓我們用提交hash(commit hash)標記bug (e3851e8
for #21, 5ea5173
for #14).
首先, 我們把master
分支重置到正確的提交(a13b85e
):
(master)$ git reset --hard a13b85e
HEAD is now at a13b85e
現(xiàn)在, 我們對 bug #21 創(chuàng)建一個新的分支:
(master)$ git checkout -b 21
(21)$
接著, 我們用 cherry-pick 把對bug #21的提交放入當前分支。 這意味著我們將應用(apply)這個提交(commit)内狗,僅僅這一個提交(commit)怪嫌,直接在HEAD上面。
(21)$ git cherry-pick e3851e8
這時候, 這里可能會產(chǎn)生沖突柳沙, 參見交互式 rebasing 章 沖突節(jié) 解決沖突.
再者岩灭, 我們?yōu)閎ug #14 創(chuàng)建一個新的分支, 也基于master
分支
(21)$ git checkout master
(master)$ git checkout -b 14
(14)$
最后, 為 bug #14 執(zhí)行 cherry-pick
:
(14)$ git cherry-pick 5ea5173
<a name="delete-stale-local-branches"></a>
我想刪除上游(upstream)分支被刪除了的本地分支
一旦你在github 上面合并(merge)了一個pull request, 你就可以刪除你fork里被合并的分支。 如果你不準備繼續(xù)在這個分支里工作, 刪除這個分支的本地拷貝會更干凈赂鲤,使你不會陷入工作分支和一堆陳舊分支的混亂之中噪径。
$ git fetch -p
<a name='restore-a-deleted-branch'></a>
我不小心刪除了我的分支
如果你定期推送到遠程, 多數(shù)情況下應該是安全的,但有些時候還是可能刪除了還沒有推到遠程的分支数初。 讓我們先創(chuàng)建一個分支和一個新的文件:
(master)$ git checkout -b my-branch
(my-branch)$ git branch
(my-branch)$ touch foo.txt
(my-branch)$ ls
README.md foo.txt
添加文件并做一次提交
(my-branch)$ git add .
(my-branch)$ git commit -m 'foo.txt added'
(my-branch)$ foo.txt added
1 files changed, 1 insertions(+)
create mode 100644 foo.txt
(my-branch)$ git log
commit 4e3cd85a670ced7cc17a2b5d8d3d809ac88d5012
Author: siemiatj <siemiatj@example.com>
Date: Wed Jul 30 00:34:10 2014 +0200
foo.txt added
commit 69204cdf0acbab201619d95ad8295928e7f411d5
Author: Kate Hudson <katehudson@example.com>
Date: Tue Jul 29 13:14:46 2014 -0400
Fixes #6: Force pushing after amending commits
現(xiàn)在我們切回到主(master)分支找爱,‘不小心的’刪除my-branch
分支
(my-branch)$ git checkout master
Switched to branch 'master'
Your branch is up-to-date with 'origin/master'.
(master)$ git branch -D my-branch
Deleted branch my-branch (was 4e3cd85).
(master)$ echo oh noes, deleted my branch!
oh noes, deleted my branch!
在這時候你應該想起了reflog
, 一個升級版的日志,它存儲了倉庫(repo)里面所有動作的歷史泡孩。
(master)$ git reflog
69204cd HEAD@{0}: checkout: moving from my-branch to master
4e3cd85 HEAD@{1}: commit: foo.txt added
69204cd HEAD@{2}: checkout: moving from master to my-branch
正如你所見车摄,我們有一個來自刪除分支的提交hash(commit hash),接下來看看是否能恢復刪除了的分支。
(master)$ git checkout -b my-branch-help
Switched to a new branch 'my-branch-help'
(my-branch-help)$ git reset --hard 4e3cd85
HEAD is now at 4e3cd85 foo.txt added
(my-branch-help)$ ls
README.md foo.txt
看! 我們把刪除的文件找回來了吮播。 Git的 reflog
在rebasing出錯的時候也是同樣有用的变屁。
<a name="i-want-to-delete-a-branch"></a>
我想刪除一個分支
刪除一個遠程分支:
(master)$ git push origin --delete my-branch
你也可以:
(master)$ git push origin :my-branch
刪除一個本地分支:
(master)$ git branch -D my-branch
<a name="i-want-to-checkout-to-a-remote-branch-that-someone-else-is-working-on"></a>
我想從別人正在工作的遠程分支簽出(checkout)一個分支
首先, 從遠程拉取(fetch) 所有分支:
(master)$ git fetch --all
假設你想要從遠程的daves
分支簽出到本地的daves
(master)$ git checkout --track origin/daves
Branch daves set up to track remote branch daves from origin.
Switched to a new branch 'daves'
(--track
是 git checkout -b [branch] [remotename]/[branch]
的簡寫)
這樣就得到了一個daves
分支的本地拷貝, 任何推過(pushed)的更新,遠程都能看到.
Rebasing 和合并(Merging)
<a name="undo-rebase"></a>
我想撤銷rebase/merge
你可以合并(merge)或rebase了一個錯誤的分支, 或者完成不了一個進行中的rebase/merge意狠。 Git 在進行危險操作的時候會把原始的HEAD保存在一個叫ORIG_HEAD的變量里, 所以要把分支恢復到rebase/merge前的狀態(tài)是很容易的粟关。
(my-branch)$ git reset --hard ORIG_HEAD
<a name="force-push-rebase"></a>
我已經(jīng)rebase過, 但是我不想強推(force push)
不幸的是,如果你想把這些變化(changes)反應到遠程分支上环戈,你就必須得強推(force push)闷板。 是因你快進(Fast forward)了提交,改變了Git歷史, 遠程分支不會接受變化(changes)谷市,除非強推(force push)蛔垢。這就是許多人使用 merge 工作流, 而不是 rebasing 工作流的主要原因之一, 開發(fā)者的強推(force push)會使大的團隊陷入麻煩迫悠。使用時需要注意鹏漆,一種安全使用 rebase 的方法是,不要把你的變化(changes)反映到遠程分支上, 而是按下面的做:
(master)$ git checkout my-branch
(my-branch)$ git rebase -i master
(my-branch)$ git checkout master
(master)$ git merge --ff-only my-branch
更多, 參見 this SO thread.
<a name="interactive-rebase"></a>
我需要組合(combine)幾個提交(commit)
假設你的工作分支將會做對于 master
的pull-request创泄。 一般情況下你不關心提交(commit)的時間戳艺玲,只想組合 所有 提交(commit) 到一個單獨的里面, 然后重置(reset)重提交(recommit)。 確保主(master)分支是最新的和你的變化都已經(jīng)提交了, 然后:
(my-branch)$ git reset --soft master
(my-branch)$ git commit -am "New awesome feature"
如果你想要更多的控制, 想要保留時間戳, 你需要做交互式rebase (interactive rebase):
(my-branch)$ git rebase -i master
如果沒有相對的其它分支鞠抑, 你將不得不相對自己的HEAD
進行 rebase饭聚。 例如:你想組合最近的兩次提交(commit), 你將相對于HEAD~2
進行rebase, 組合最近3次提交(commit), 相對于HEAD~3
, 等等搁拙。
(master)$ git rebase -i HEAD~2
在你執(zhí)行了交互式 rebase的命令(interactive rebase command)后, 你將在你的編輯器里看到類似下面的內容:
pick a9c8a1d Some refactoring
pick 01b2fd8 New awesome feature
pick b729ad5 fixup
pick e3851e8 another fix
# Rebase 8074d12..b729ad5 onto 8074d12
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out
所有以 #
開頭的行都是注釋, 不會影響 rebase.
然后秒梳,你可以用任何上面命令列表的命令替換 pick
, 你也可以通過刪除對應的行來刪除一個提交(commit)。
例如, 如果你想 單獨保留最舊(first)的提交(commit),組合所有剩下的到第二個里面, 你就應該編輯第二個提交(commit)后面的每個提交(commit) 前的單詞為 f
:
pick a9c8a1d Some refactoring
pick 01b2fd8 New awesome feature
f b729ad5 fixup
f e3851e8 another fix
如果你想組合這些提交(commit) 并重命名這個提交(commit), 你應該在第二個提交(commit)旁邊添加一個r
箕速,或者更簡單的用s
替代 f
:
pick a9c8a1d Some refactoring
pick 01b2fd8 New awesome feature
s b729ad5 fixup
s e3851e8 another fix
你可以在接下來彈出的文本提示框里重命名提交(commit)酪碘。
Newer, awesomer features
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# rebase in progress; onto 8074d12
# You are currently editing a commit while rebasing branch 'master' on '8074d12'.
#
# Changes to be committed:
# modified: README.md
#
如果成功了, 你應該看到類似下面的內容:
(master)$ Successfully rebased and updated refs/heads/master.
安全合并(merging)策略
--no-commit
執(zhí)行合并(merge)但不自動提交, 給用戶在做提交前檢查和修改的機會。 no-ff
會為特性分支(feature branch)的存在過留下證據(jù), 保持項目歷史一致盐茎。
(master)$ git merge --no-ff --no-commit my-branch
我需要將一個分支合并成一個提交(commit)
(master)$ git merge --squash my-branch
<a name="rebase-unpushed-commits"></a>
我只想組合(combine)未推的提交(unpushed commit)
有時候兴垦,在將數(shù)據(jù)推向上游之前,你有幾個正在進行的工作提交(commit)字柠。這時候不希望把已經(jīng)推(push)過的組合進來探越,因為其他人可能已經(jīng)有提交(commit)引用它們了。
(master)$ git rebase -i @{u}
這會產(chǎn)生一次交互式的rebase(interactive rebase), 只會列出沒有推(push)的提交(commit)窑业, 在這個列表時進行reorder/fix/squash 都是安全的钦幔。
<a name="check-if-all-commits-on-a-branch-are-merged"></a>
檢查是否分支上的所有提交(commit)都合并(merge)過了
檢查一個分支上的所有提交(commit)是否都已經(jīng)合并(merge)到了其它分支, 你應該在這些分支的head(或任何 commits)之間做一次diff:
(master)$ git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll
這會告訴你在一個分支里有而另一個分支沒有的所有提交(commit), 和分支之間不共享的提交(commit)的列表。 另一個做法可以是:
(master)$ git log master ^feature/120-on-scroll --no-merges
交互式rebase(interactive rebase)可能出現(xiàn)的問題
<a name="noop"></a>
這個rebase 編輯屏幕出現(xiàn)'noop'
如果你看到的是這樣:
noop
這意味著你rebase的分支和當前分支在同一個提交(commit)上, 或者 領先(ahead) 當前分支常柄。 你可以嘗試:
- 檢查確保主(master)分支沒有問題
- rebase
HEAD~2
或者更早
<a name="merge-conflict"></a>
有沖突的情況
如果你不能成功的完成rebase, 你可能必須要解決沖突节槐。
首先執(zhí)行 git status
找出哪些文件有沖突:
(my-branch)$ git status
On branch my-branch
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: README.md
在這個例子里面, README.md
有沖突搀庶。 打開這個文件找到類似下面的內容:
<<<<<<< HEAD
some code
=========
some code
>>>>>>> new-commit
你需要解決新提交的代碼(示例里, 從中間==
線到new-commit
的地方)與HEAD
之間不一樣的地方.
有時候這些合并非常復雜,你應該使用可視化的差異編輯器(visual diff editor):
(master*)$ git mergetool -t opendiff
在你解決完所有沖突和測試過后, git add
變化了的(changed)文件, 然后用git rebase --continue
繼續(xù)rebase铜异。
(my-branch)$ git add README.md
(my-branch)$ git rebase --continue
如果在解決完所有的沖突過后哥倔,得到了與提交前一樣的結果, 可以執(zhí)行git rebase --skip
。
任何時候你想結束整個rebase 過程揍庄,回來rebase前的分支狀態(tài), 你可以做:
(my-branch)$ git rebase --abort
<a name="miscellaneous-objects"></a>
雜項(Miscellaneous Objects)
<a name="clone-submodules"></a>
克隆所有子模塊
$ git clone --recursive git://github.com/foo/bar.git
如果已經(jīng)克隆了:
$ git submodule update --init --recursive
<a name="delete-tag"></a>
刪除標簽(tag)
$ git tag -d <tag_name>
$ git push <remote> :refs/tags/<tag_name>
<a name="recover-tag"></a>
恢復已刪除標簽(tag)
如果你想恢復一個已刪除標簽(tag), 可以按照下面的步驟: 首先, 需要找到無法訪問的標簽(unreachable tag):
$ git fsck --unreachable | grep tag
記下這個標簽(tag)的hash咆蒿,然后用Git的 update-ref:
$ git update-ref refs/tags/<tag_name> <hash>
這時你的標簽(tag)應該已經(jīng)恢復了。
<a name="deleted-patch"></a>
已刪除補丁(patch)
如果某人在 GitHub 上給你發(fā)了一個pull request, 但是然后他刪除了他自己的原始 fork, 你將沒法克隆他們的提交(commit)或使用 git am
蚂子。在這種情況下, 最好手動的查看他們的提交(commit)沃测,并把它們拷貝到一個本地新分支,然后做提交食茎。
做完提交后, 再修改作者蒂破,參見變更作者。 然后, 應用變化, 再發(fā)起一個新的pull request别渔。
跟蹤文件(Tracking Files)
<a href="i-want-to-change-a-file-names-capitalization-without-changing-the-contents-of-the-file"></a>
我只想改變一個文件名字的大小寫附迷,而不修改內容
(master)$ git mv --force myfile MyFile
<a href="remove-from-git"></a>
我想從Git刪除一個文件,但保留該文件
(master)$ git rm --cached log.txt
配置(Configuration)
<a name="adding-command-aliases"></a>
我想給一些Git命令添加別名(alias)
在 OS X 和 Linux 下, 你的 Git的配置文件儲存在 ~/.gitconfig
哎媚。我在[alias]
部分添加了一些快捷別名(和一些我容易拼寫錯誤的)喇伯,如下:
[alias]
a = add
amend = commit --amend
c = commit
ca = commit --amend
ci = commit -a
co = checkout
d = diff
dc = diff --changed
ds = diff --staged
f = fetch
loll = log --graph --decorate --pretty=oneline --abbrev-commit
m = merge
one = log --pretty=oneline
outstanding = rebase -i @{u}
s = status
unpushed = log @{u}
wc = whatchanged
wip = rebase -i @{u}
zap = fetch -p
<a name="credential-helper"></a>
我想緩存一個倉庫(repository)的用戶名和密碼
你可能有一個倉庫需要授權,這時你可以緩存用戶名和密碼拨与,而不用每次推/拉(push/pull)的時候都輸入稻据,Credential helper能幫你。
$ git config --global credential.helper cache
# Set git to use the credential memory cache
$ git config --global credential.helper 'cache --timeout=3600'
# Set the cache to timeout after 1 hour (setting is in seconds)
<a href="#ive-no-idea-what-i-did-wrong"></a>
我不知道我做錯了些什么
你把事情搞砸了:你 重置(reset)
了一些東西, 或者你合并了錯誤的分支, 亦或你強推了后找不到你自己的提交(commit)了买喧。有些時候, 你一直都做得很好, 但你想回到以前的某個狀態(tài)捻悯。
這就是 git reflog
的目的, reflog
記錄對分支頂端(the tip of a branch)的任何改變, 即使那個頂端沒有被任何分支或標簽引用淤毛∏锒龋基本上, 每次HEAD的改變, 一條新的記錄就會增加到reflog
。遺憾的是钱床,這只對本地分支起作用,且它只跟蹤動作 (例如埠居,不會跟蹤一個沒有被記錄的文件的任何改變)查牌。
(master)$ git reflog
0a2e358 HEAD@{0}: reset: moving to HEAD~2
0254ea7 HEAD@{1}: checkout: moving from 2.2 to master
c10f740 HEAD@{2}: checkout: moving from master to 2.2
上面的reflog展示了從master分支簽出(checkout)到2.2 分支,然后再簽回滥壕。 那里纸颜,還有一個硬重置(hard reset)到一個較舊的提交。最新的動作出現(xiàn)在最上面以 HEAD@{0}
標識.
如果事實證明你不小心回移(move back)了提交(commit), reflog 會包含你不小心回移前master上指向的提交(0254ea7)绎橘。
$ git reset --hard 0254ea7
然后使用git reset就可以把master改回到之前的commit胁孙,這提供了一個在歷史被意外更改情況下的安全網(wǎng)唠倦。
(摘自).
其它資源(Other Resources)
書(Books)
- Pro Git - Scott Chacon's excellent git book
- Git Internals - Scott Chacon's other excellent git book
教程(Tutorials)
- Learn Git branching 一個基于網(wǎng)頁的交互式 branching/merging/rebasing 教程
- Getting solid at Git rebase vs. merge
- git-workflow - Aaron Meurer的怎么使用Git為開源倉庫貢獻
- GitHub as a workflow - 使用GitHub做為工作流的趣事, 尤其是空PRs
腳本和工具(Scripts and Tools)
- firstaidgit.io 一個可搜索的最常被問到的Git的問題
- git-extra-commands - 一堆有用的額外的Git腳本
- git-extras - GIT 工具集 -- repo summary, repl, changelog population, author commit percentages and more
- git-fire - git-fire 是一個 Git 插件,用于幫助在緊急情況下添加所有當前文件, 做提交(committing), 和推(push)到一個新分支(阻止合并沖突)涮较。
- git-tips - Git小提示
- git-town - 通用稠鼻,高級Git工作流支持! http://www.git-town.com