本文摘自【git-flight-rules】

Git飛行規(guī)則(Flight Rules)

??
English ? Espa?ol ? Русский ? 簡體中文? ??? ? Ti?ng Vi?t ? Fran?ais

前言

• 英文原版README
• 翻譯可能存在錯(cuò)誤或不標(biāo)準(zhǔn)的地方砖第，歡迎大家指正和修改淮韭，謝謝恋技！

什么是"飛行規(guī)則"?

一個(gè) 宇航員指南 (現(xiàn)在, 程序員們都在使用GIT) 是關(guān)于出現(xiàn)問題過后應(yīng)該怎么操作婆芦。

飛行規(guī)則(Flight Rules) 是記錄在手冊上的來之不易的一系列知識(shí)，記錄了某個(gè)事情發(fā)生的原因潜的，以及怎樣一步一步的進(jìn)行處理勃救。本質(zhì)上, 它們是特定場景的非常詳細(xì)的標(biāo)準(zhǔn)處理流程宏榕。 [...]

自20世紀(jì)60年代初以來，NASA一直在捕捉(capturing)我們的失誤碱鳞，災(zāi)難和解決方案, 當(dāng)時(shí)水星時(shí)代(Mercury-era)的地面小組首先開始將“經(jīng)驗(yàn)教訓(xùn)”收集到一個(gè)綱要(compendium)中桑李，該綱現(xiàn)在已經(jīng)有上千個(gè)問題情景，從發(fā)動(dòng)機(jī)故障到破損的艙口把手到計(jì)算機(jī)故障窿给，以及它們對應(yīng)的解決方案贵白。

— Chris Hadfield, 一個(gè)宇航員的生活指南(An Astronaut's Guide to Life)。

這篇文章的約定

為了清楚的表述崩泡，這篇文檔里的所有例子使用了自定義的bash 提示禁荒，以便指示當(dāng)前分支和是否有暫存的變化(changes)。分支名用小括號(hào)括起來角撞，分支名后面跟的*表示暫存的變化(changes)呛伴。

[圖片上傳失敗...(image-1d063e-1544768696434)]


Table of Contents generated with DocToc

編輯提交(editting commits)

<a name="diff-last"></a>

我剛才提交了什么?

如果你用 git commit -a 提交了一次變化(changes)，而你又不確定到底這次提交了哪些內(nèi)容谒所。 你就可以用下面的命令顯示當(dāng)前HEAD上的最近一次的提交(commit):

(master)git show

或者

git log -n1 -p

<a name="#i-wrote-the-wrong-thing-in-a-commit-message"></a>

我的提交信息(commit message)寫錯(cuò)了

如果你的提交信息(commit message)寫錯(cuò)了且這次提交(commit)還沒有推(push), 你可以通過下面的方法來修改提交信息(commit message):

git commit --amend --only

這會(huì)打開你的默認(rèn)編輯器, 在這里你可以編輯信息. 另一方面, 你也可以用一條命令一次完成:

git commit --amend --only -m 'xxxxxxx'

如果你已經(jīng)推(push)了這次提交(commit), 你可以修改這次提交(commit)然后強(qiáng)推(force push), 但是不推薦這么做热康。

<a name="commit-wrong-author"></a>

我提交(commit)里的用戶名和郵箱不對

如果這只是單個(gè)提交(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>

我想從一個(gè)提交(commit)里移除一個(gè)文件

通過下面的方法劣领，從一個(gè)提交(commit)里移除一個(gè)文件:

git checkout HEAD^ myfile
git add -A
git commit --amend

這將非常有用褐隆，當(dāng)你有一個(gè)開放的補(bǔ)丁(open patch)，你往上面提交了一個(gè)不必要的文件剖踊，你需要強(qiáng)推(force push)去更新這個(gè)遠(yuǎn)程補(bǔ)丁庶弃。

<a name="delete-pushed-commit"></a>

我想刪除我的的最后一次提交(commit)

如果你需要?jiǎng)h除推了的提交(pushed commits)衫贬，你可以使用下面的方法⌒ィ可是固惯，這會(huì)不可逆的改變你的歷史，也會(huì)搞亂那些已經(jīng)從該倉庫拉取(pulled)了的人的歷史缴守。簡而言之葬毫，如果你不是很確定，千萬不要這么做屡穗。

git reset HEAD^ --hard
git push -f [remote] [branch]

如果你還沒有推到遠(yuǎn)程, 把Git重置(reset)到你最后一次提交前的狀態(tài)就可以了(同時(shí)保存暫存的變化):

(my-branch*)git reset --soft HEAD@{1}

這只能在沒有推送之前有用. 如果你已經(jīng)推了, 唯一安全能做的是 git revert SHAofBadCommit贴捡， 那會(huì)創(chuàng)建一個(gè)新的提交(commit)用于撤消前一個(gè)提交的所有變化(changes)； 或者, 如果你推的這個(gè)分支是rebase-safe的 (例如： 其它開發(fā)者不會(huì)從這個(gè)分支拉), 只需要使用 git push -f村砂； 更多, 請參考 the above section烂斋。

<a name="delete-any-commit"></a>

刪除任意提交(commit)

同樣的警告：不到萬不得已的時(shí)候不要這么做.

git rebase --onto SHA1_OF_BAD_COMMIT^ SHA1_OF_BAD_COMMIT
git push -f [remote] [branch]

或者做一個(gè) 交互式rebase 刪除那些你想要?jiǎng)h除的提交(commit)里所對應(yīng)的行。

<a name="#force-push"></a>

我嘗試推一個(gè)修正后的提交(amended commit)到遠(yuǎn)程础废，但是報(bào)錯(cuò)：

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)會(huì)用一個(gè)新的提交(commit)代替舊的, 所以如果之前你已經(jīng)往遠(yuǎn)程倉庫上推過一次修正前的提交(commit)汛骂，那你現(xiàn)在就必須強(qiáng)推(force push) (-f)。 注意 – 總是 確保你指明一個(gè)分支!

(my-branch)git push origin mybranch -f

一般來說, 要避免強(qiáng)推. 最好是創(chuàng)建和推(push)一個(gè)新的提交(commit)评腺，而不是強(qiáng)推一個(gè)修正后的提交帘瞭。后者會(huì)使那些與該分支或該分支的子分支工作的開發(fā)者，在源歷史中產(chǎn)生沖突蒿讥。

<a href="undo-git-reset-hard"></a>

我意外的做了一次硬重置(hard reset)蝶念，我想找回我的內(nèi)容

如果你意外的做了 git reset --hard, 你通常能找回你的提交(commit), 因?yàn)镚it對每件事都會(huì)有日志，且都會(huì)保存幾天芋绸。

(master)git reflog

你將會(huì)看到一個(gè)你過去提交(commit)的列表, 和一個(gè)重置的提交祸轮。 選擇你想要回到的提交(commit)的SHA，再重置一次:

(master)git reset --hard SHA1234

這樣就完成了侥钳。

暫存(Staging)

<a href="#i-need-to-add-staged-changes-to-the-previous-commit"></a>

我需要把暫存的內(nèi)容添加到上一次的提交(commit)

(my-branch*)git commit --amend

<a name="commit-partial-new-file"></a>

我想要暫存一個(gè)新文件的一部分适袜，而不是這個(gè)文件的全部

一般來說, 如果你想暫存一個(gè)文件的一部分, 你可這樣做:

git add --patch filename.x

-p 簡寫。這會(huì)打開交互模式舷夺， 你將能夠用 s 選項(xiàng)來分隔提交(commit)苦酱； 然而, 如果這個(gè)文件是新的, 會(huì)沒有這個(gè)選擇， 添加一個(gè)新文件時(shí), 這樣做:

git add -N filename.x

然后, 你需要用 e 選項(xiàng)來手動(dòng)選擇需要添加的行给猾，執(zhí)行 git diff --cached 將會(huì)顯示哪些行暫存了哪些行只是保存在本地了疫萤。

<a href="stage-in-two-commits"></a>

我想把在一個(gè)文件里的變化(changes)加到兩個(gè)提交(commit)里

git add 會(huì)把整個(gè)文件加入到一個(gè)提交. git add -p 允許交互式的選擇你想要提交的部分.

<a href="unstaging-edits-and-staging-the-unstaged"></a>

我想把暫存的內(nèi)容變成未暫存，把未暫存的內(nèi)容暫存起來

這個(gè)有點(diǎn)困難敢伸， 我能想到的最好的方法是先stash未暫存的內(nèi)容扯饶， 然后重置(reset)，再pop第一步stashed的內(nèi)容, 最后再add它們。

git stash -k
git reset --hard
git stash pop
git add -A

未暫存(Unstaged)的內(nèi)容

<a href="move-unstaged-edits-to-new-branch"></a>

我想把未暫存的內(nèi)容移動(dòng)到一個(gè)新分支

git checkout -b my-branch

<a href="move-unstaged-edits-to-old-branch"></a>

我想把未暫存的內(nèi)容移動(dòng)到另一個(gè)已存在的分支

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

重置某個(gè)特殊的文件, 你可以用文件名做為參數(shù):

git reset filename

<a href="i-want-to-discard-specific-unstaged-changes"></a>

我想丟棄某些未暫存的內(nèi)容

如果你想丟棄工作拷貝中的一部分內(nèi)容钓丰，而不是全部。

簽出(checkout)不需要的內(nèi)容每币，保留需要的携丁。

git checkout -p
# Answer y to all of the snippets you want to drop

另外一個(gè)方法是使用 stash， Stash所有要保留下的內(nèi)容, 重置工作拷貝, 重新應(yīng)用保留的部分兰怠。

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>

我從錯(cuò)誤的分支拉取了內(nèi)容，或把內(nèi)容拉取到了錯(cuò)誤的分支

這是另外一種使用 git reflog 情況揭保，找到在這次錯(cuò)誤拉(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)秸侣，以便我的分支與遠(yuǎn)程的保持一致

先確認(rèn)你沒有推(push)你的內(nèi)容到遠(yuǎn)程存筏。

git status 會(huì)顯示你領(lǐng)先(ahead)源(origin)多少個(gè)提交:

(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>

我需要提交到一個(gè)新分支，但錯(cuò)誤的提交到了master

在master下創(chuàng)建一個(gè)新分支塔次，不切換到新分支,仍在master下:

(master)git branch my-branch

把master分支重置到前一個(gè)提交:

(master)git reset --hard HEAD^

HEAD^ 是 HEAD^1 的簡寫，你可以通過指定要設(shè)置的HEAD來進(jìn)一步重置名秀。

或者, 如果你不想使用 HEAD^, 找到你想重置到的提交(commit)的hash(git log 能夠完成)励负， 然后重置到這個(gè)hash。 使用git push 同步內(nèi)容到遠(yuǎn)程匕得。

例如, 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>

我想保留來自另外一個(gè)ref-ish的整個(gè)文件

假設(shè)你正在做一個(gè)原型方案(原文為working spike (see note)), 有成百的內(nèi)容继榆，每個(gè)都工作得很好。現(xiàn)在, 你提交到了一個(gè)分支汁掠，保存工作內(nèi)容:

(solution)git add -A && git commit -m "Adding all changes from this spike into one big commit."

當(dāng)你想要把它放到一個(gè)分支里 (可能是feature, 或者 develop), 你關(guān)心是保持整個(gè)文件的完整略吨，你想要一個(gè)大的提交分隔成比較小。

假設(shè)你有:

• 分支 solution, 擁有原型方案考阱， 領(lǐng)先 develop 分支翠忠。
• 分支 develop, 在這里你應(yīng)用原型方案的一些內(nèi)容。

我去可以通過把內(nèi)容拿到你的分支里乞榨，來解決這個(gè)問題:

(develop)git checkout solution -- file1.txt

這會(huì)把這個(gè)文件內(nèi)容從分支 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>

我把幾個(gè)提交(commit)提交到了同一個(gè)分支，而這些提交應(yīng)該分布在不同的分支里

假設(shè)你有一個(gè)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)標(biāo)記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)建一個(gè)新的分支:

(master)git checkout -b 21
(21)$

接著, 我們用 cherry-pick 把對bug #21的提交放入當(dāng)前分支考榨。 這意味著我們將應(yīng)用(apply)這個(gè)提交(commit)，僅僅這一個(gè)提交(commit)鹦倚，直接在HEAD上面河质。

(21)git cherry-pick e3851e8

這時(shí)候, 這里可能會(huì)產(chǎn)生沖突， 參見交互式 rebasing 章 沖突節(jié) 解決沖突.

再者， 我們?yōu)閎ug #14 創(chuàng)建一個(gè)新的分支, 也基于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)了一個(gè)pull request, 你就可以刪除你fork里被合并的分支掀鹅。 如果你不準(zhǔn)備繼續(xù)在這個(gè)分支里工作, 刪除這個(gè)分支的本地拷貝會(huì)更干凈散休，使你不會(huì)陷入工作分支和一堆陳舊分支的混亂之中。

git fetch -p

<a name='restore-a-deleted-branch'></a>

我不小心刪除了我的分支

如果你定期推送到遠(yuǎn)程, 多數(shù)情況下應(yīng)該是安全的淫半，但有些時(shí)候還是可能刪除了還沒有推到遠(yuǎn)程的分支溃槐。 讓我們先創(chuàng)建一個(gè)分支和一個(gè)新的文件:

(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!

在這時(shí)候你應(yīng)該想起了reflog, 一個(gè)升級版的日志科吭，它存儲(chǔ)了倉庫(repo)里面所有動(dòng)作的歷史昏滴。

(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

正如你所見，我們有一個(gè)來自刪除分支的提交hash(commit hash)对人，接下來看看是否能恢復(fù)刪除了的分支谣殊。

(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出錯(cuò)的時(shí)候也是同樣有用的牺弄。

<a name="i-want-to-delete-a-branch"></a>

我想刪除一個(gè)分支

刪除一個(gè)遠(yuǎn)程分支:

(master)git push origin --delete my-branch

你也可以:

(master)git push origin :my-branch

刪除一個(gè)本地分支:

(master)git branch -D my-branch

<a name="i-want-to-checkout-to-a-remote-branch-that-someone-else-is-working-on"></a>

我想從別人正在工作的遠(yuǎn)程分支簽出(checkout)一個(gè)分支

首先, 從遠(yuǎn)程拉取(fetch) 所有分支:

(master)git fetch --all

假設(shè)你想要從遠(yuǎn)程的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] 的簡寫)

這樣就得到了一個(gè)daves分支的本地拷貝, 任何推過(pushed)的更新姻几，遠(yuǎn)程都能看到.

Rebasing 和合并(Merging)

<a name="undo-rebase"></a>

我想撤銷rebase/merge

你可以合并(merge)或rebase了一個(gè)錯(cuò)誤的分支, 或者完成不了一個(gè)進(jìn)行中的rebase/merge。 Git 在進(jìn)行危險(xiǎn)操作的時(shí)候會(huì)把原始的HEAD保存在一個(gè)叫ORIG_HEAD的變量里, 所以要把分支恢復(fù)到rebase/merge前的狀態(tài)是很容易的势告。

(my-branch)git reset --hard ORIG_HEAD

<a name="force-push-rebase"></a>

我已經(jīng)rebase過, 但是我不想強(qiáng)推(force push)

不幸的是蛇捌，如果你想把這些變化(changes)反應(yīng)到遠(yuǎn)程分支上，你就必須得強(qiáng)推(force push)咱台。 是因你快進(jìn)(Fast forward)了提交络拌，改變了Git歷史, 遠(yuǎn)程分支不會(huì)接受變化(changes)，除非強(qiáng)推(force push)回溺。這就是許多人使用 merge 工作流, 而不是 rebasing 工作流的主要原因之一春贸， 開發(fā)者的強(qiáng)推(force push)會(huì)使大的團(tuán)隊(duì)陷入麻煩。使用時(shí)需要注意遗遵，一種安全使用 rebase 的方法是萍恕，不要把你的變化(changes)反映到遠(yuǎn)程分支上, 而是按下面的做:

(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)幾個(gè)提交(commit)

假設(shè)你的工作分支將會(huì)做對于 master 的pull-request。 一般情況下你不關(guān)心提交(commit)的時(shí)間戳车要，只想組合 所有 提交(commit) 到一個(gè)單獨(dú)的里面, 然后重置(reset)重提交(recommit)允粤。 確保主(master)分支是最新的和你的變化都已經(jīng)提交了, 然后:

(my-branch)git reset --soft master
(my-branch)git commit -am "New awesome feature"

如果你想要更多的控制, 想要保留時(shí)間戳, 你需要做交互式rebase (interactive rebase):

(my-branch)git rebase -i master

如果沒有相對的其它分支， 你將不得不相對自己的HEAD 進(jìn)行 rebase翼岁。 例如：你想組合最近的兩次提交(commit), 你將相對于HEAD~2 進(jìn)行rebase维哈， 組合最近3次提交(commit), 相對于HEAD~3, 等等。

(master)git rebase -i HEAD~2

在你執(zhí)行了交互式 rebase的命令(interactive rebase command)后, 你將在你的編輯器里看到類似下面的內(nèi)容:

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

所有以 # 開頭的行都是注釋, 不會(huì)影響 rebase.

然后登澜，你可以用任何上面命令列表的命令替換 pick, 你也可以通過刪除對應(yīng)的行來刪除一個(gè)提交(commit)阔挠。

例如, 如果你想 單獨(dú)保留最舊(first)的提交(commit),組合所有剩下的到第二個(gè)里面, 你就應(yīng)該編輯第二個(gè)提交(commit)后面的每個(gè)提交(commit) 前的單詞為 f:

pick a9c8a1d Some refactoring
pick 01b2fd8 New awesome feature
f b729ad5 fixup
f e3851e8 another fix

如果你想組合這些提交(commit) 并重命名這個(gè)提交(commit), 你應(yīng)該在第二個(gè)提交(commit)旁邊添加一個(gè)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
#

如果成功了, 你應(yīng)該看到類似下面的內(nèi)容:

(master)Successfully rebased and updated refs/heads/master.

安全合并(merging)策略

--no-commit 執(zhí)行合并(merge)但不自動(dòng)提交, 給用戶在做提交前檢查和修改的機(jī)會(huì)购撼。 no-ff 會(huì)為特性分支(feature branch)的存在過留下證據(jù), 保持項(xiàng)目歷史一致跪削。

(master)git merge --no-ff --no-commit my-branch

我需要將一個(gè)分支合并成一個(gè)提交(commit)

(master)git merge --squash my-branch

<a name="rebase-unpushed-commits"></a>

我只想組合(combine)未推的提交(unpushed commit)

有時(shí)候，在將數(shù)據(jù)推向上游之前迂求，你有幾個(gè)正在進(jìn)行的工作提交(commit)碾盐。這時(shí)候不希望把已經(jīng)推(push)過的組合進(jìn)來，因?yàn)槠渌丝赡芤呀?jīng)有提交(commit)引用它們了揩局。

(master)git rebase -i @{u}

這會(huì)產(chǎn)生一次交互式的rebase(interactive rebase), 只會(huì)列出沒有推(push)的提交(commit)毫玖， 在這個(gè)列表時(shí)進(jìn)行reorder/fix/squash 都是安全的。

<a name="check-if-all-commits-on-a-branch-are-merged"></a>

檢查是否分支上的所有提交(commit)都合并(merge)過了

檢查一個(gè)分支上的所有提交(commit)是否都已經(jīng)合并(merge)到了其它分支, 你應(yīng)該在這些分支的head(或任何 commits)之間做一次diff:

(master)git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll

這會(huì)告訴你在一個(gè)分支里有而另一個(gè)分支沒有的所有提交(commit), 和分支之間不共享的提交(commit)的列表凌盯。 另一個(gè)做法可以是:

(master)git log master ^feature/120-on-scroll --no-merges

交互式rebase(interactive rebase)可能出現(xiàn)的問題

<a name="noop"></a>

這個(gè)rebase 編輯屏幕出現(xiàn)'noop'

如果你看到的是這樣:

noop

這意味著你rebase的分支和當(dāng)前分支在同一個(gè)提交(commit)上, 或者 領(lǐng)先(ahead) 當(dāng)前分支付枫。 你可以嘗試:

• 檢查確保主(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

在這個(gè)例子里面, README.md 有沖突驰怎。 打開這個(gè)文件找到類似下面的內(nèi)容:

   <<<<<<< HEAD
   some code
   =========
   some code
   >>>>>>> new-commit

你需要解決新提交的代碼(示例里, 從中間==線到new-commit的地方)與HEAD 之間不一樣的地方.

有時(shí)候這些合并非常復(fù)雜阐滩，你應(yīng)該使用可視化的差異編輯器(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

如果在解決完所有的沖突過后县忌，得到了與提交前一樣的結(jié)果, 可以執(zhí)行git rebase --skip掂榔。

任何時(shí)候你想結(jié)束整個(gè)rebase 過程，回來rebase前的分支狀態(tài), 你可以做:

(my-branch)git rebase --abort

<a name="miscellaneous-objects"></a>

雜項(xiàng)(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>

刪除標(biāo)簽(tag)

git tag -d <tag_name>
git push <remote> :refs/tags/<tag_name>

<a name="recover-tag"></a>

恢復(fù)已刪除標(biāo)簽(tag)

如果你想恢復(fù)一個(gè)已刪除標(biāo)簽(tag), 可以按照下面的步驟: 首先, 需要找到無法訪問的標(biāo)簽(unreachable tag):

git fsck --unreachable | grep tag

記下這個(gè)標(biāo)簽(tag)的hash症杏，然后用Git的 update-ref:

git update-ref refs/tags/<tag_name> <hash>

這時(shí)你的標(biāo)簽(tag)應(yīng)該已經(jīng)恢復(fù)了装获。

<a name="deleted-patch"></a>

已刪除補(bǔ)丁(patch)

如果某人在 GitHub 上給你發(fā)了一個(gè)pull request, 但是然后他刪除了他自己的原始 fork, 你將沒法克隆他們的提交(commit)或使用 git am。在這種情況下, 最好手動(dòng)的查看他們的提交(commit)厉颤，并把它們拷貝到一個(gè)本地新分支穴豫，然后做提交。

做完提交后, 再修改作者走芋，參見變更作者绩郎。 然后, 應(yīng)用變化, 再發(fā)起一個(gè)新的pull request潘鲫。

跟蹤文件(Tracking Files)

<a href="i-want-to-change-a-file-names-capitalization-without-changing-the-contents-of-the-file"></a>

我只想改變一個(gè)文件名字的大小寫翁逞，而不修改內(nèi)容

(master)git mv --force myfile MyFile

<a href="remove-from-git"></a>

我想從Git刪除一個(gè)文件，但保留該文件

(master)git rm --cached log.txt

配置(Configuration)

<a name="adding-command-aliases"></a>

我想給一些Git命令添加別名(alias)

在 OS X 和 Linux 下, 你的 Git的配置文件儲(chǔ)存在 ~/.gitconfig溉仑。我在[alias]部分添加了一些快捷別名(和一些我容易拼寫錯(cuò)誤的)挖函，如下:

[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>

我想緩存一個(gè)倉庫(repository)的用戶名和密碼

你可能有一個(gè)倉庫需要授權(quán)，這時(shí)你可以緩存用戶名和密碼浊竟，而不用每次推/拉(push/pull)的時(shí)候都輸入怨喘，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>

我不知道我做錯(cuò)了些什么

你把事情搞砸了：你 重置(reset) 了一些東西, 或者你合并了錯(cuò)誤的分支, 亦或你強(qiáng)推了后找不到你自己的提交(commit)了振定。有些時(shí)候, 你一直都做得很好, 但你想回到以前的某個(gè)狀態(tài)必怜。

這就是 git reflog 的目的， reflog 記錄對分支頂端(the tip of a branch)的任何改變, 即使那個(gè)頂端沒有被任何分支或標(biāo)簽引用后频∈崆欤基本上, 每次HEAD的改變, 一條新的記錄就會(huì)增加到reflog暖途。遺憾的是，這只對本地分支起作用膏执，且它只跟蹤動(dòng)作 (例如驻售，不會(huì)跟蹤一個(gè)沒有被記錄的文件的任何改變)。

(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 分支更米，然后再簽回欺栗。 那里，還有一個(gè)硬重置(hard reset)到一個(gè)較舊的提交征峦。最新的動(dòng)作出現(xiàn)在最上面以 HEAD@{0}標(biāo)識(shí).

如果事實(shí)證明你不小心回移(move back)了提交(commit), reflog 會(huì)包含你不小心回移前master上指向的提交(0254ea7)迟几。

git reset --hard 0254ea7

然后使用git reset就可以把master改回到之前的commit，這提供了一個(gè)在歷史被意外更改情況下的安全網(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 一個(gè)基于網(wǎng)頁的交互式 branching/merging/rebasing 教程
• Getting solid at Git rebase vs. merge
• git-workflow - Aaron Meurer的怎么使用Git為開源倉庫貢獻(xiàn)
• GitHub as a workflow - 使用GitHub做為工作流的趣事, 尤其是空PRs

腳本和工具(Scripts and Tools)

• firstaidgit.io 一個(gè)可搜索的最常被問到的Git的問題
• git-extra-commands - 一堆有用的額外的Git腳本
• git-extras - GIT 工具集 -- repo summary, repl, changelog population, author commit percentages and more
• git-fire - git-fire 是一個(gè) Git 插件瘤旨，用于幫助在緊急情況下添加所有當(dāng)前文件, 做提交(committing), 和推(push)到一個(gè)新分支(阻止合并沖突)。
• git-tips - Git小提示
• git-town - 通用竖伯，高級Git工作流支持存哲！ http://www.git-town.com

GUI客戶端(GUI Clients)

• GitKraken - 豪華的Git客戶端 Windows, Mac & Linux
• git-cola - 另外一個(gè)Git客戶端 Windows & OS X
• GitUp - 一個(gè)新的Git客戶端，在處理Git的復(fù)雜性上有自己的特點(diǎn)
• gitx-dev - 圖形化的Git客戶端 OS X
• Source Tree - 免費(fèi)的圖形化Git客戶端 Windows & OS X
• Tower - 圖形化Git客戶端 OS X(付費(fèi))