章 7. Git大師技

到現在,你應該有能力查閲 git help 頁,並理解几乎所有東西。然而,查明解決特 定問題需要的確切命令可能是乏味的。或許我可以省你點功夫:以下是我過去曾經需要 的一些食譜。

源碼發佈

就我的項目而言,Git完全跟蹤了我想打包並發佈給用戶的檔案。創建一個源碼包,我運 行:

$ git archive --format=tar --prefix=proj-1.2.3/ HEAD

提交變更

對特定項目而言,告訴Git你增加,刪除和重命名了一些檔案很麻煩。而鍵入如下命令會容易的多:

$ git add .
$ git add -u

Git將查找當前目錄的檔案並自己算出具體的情況。除了用第二個add命令,如果你也打 算這時提交,可以運行`git commit -a`。關於如何指定應被忽略的檔案,參見 git help ignore

你也可以用一行命令完成以上任務:

$ git ls-files -d -m -o -z | xargs -0 git update-index --add --remove

這裡 -z-0 選項可以消除包含特殊字元的檔案名引起的不良副作用。注意這個 命令也添加應被忽略的檔案,這時你可能需要加上 -x-X 選項。

我的提交太大了!

是不是忽視提交太久了?痴迷地編碼,直到現在才想起有源碼控制工具這回事?提交一 系列不相關的變更,因為那是你的風格?

別擔心,運行:

$ git add -p

為你做的每次修改,Git將展示給你變動的代碼,並詢問該變動是否應是下一次提交的一 部分。回答“y”或者“n”。也有其他選項,比如延遲決定;鍵入“?”來學習更多。

一旦你滿意,鍵入

$ git commit

來精確地提交你所選擇的變更(階段變更)。確信你沒加上 -a 選項,否則Git將提交 所有修改。

如果你修改了許多地方的許多檔案怎麼辦?一個一個地查看變更令人沮喪,心態麻木。 這種情況下,使用 git add -i , 它的界面不是很直觀,但更靈活。敲幾個鍵,你可 以一次決定階段或非階段性提交幾個檔案,或查看並只選擇特定檔案的變更。作為另一 種選擇,你還可以運行 git commit --interactive ,這個命令會在你操作完後自動 進行提交。

索引:Git的中轉區域

當目前為止,我們已經忽略Git著名的'索引‘概念,但現在我們必須面對它,以解釋上 面發生的。索引是一個臨時中轉區。Git很少在你的項目和它的歷史之間直接倒騰數據。 通常,Git先寫數據到索引,然後拷貝索引中的數據到最終目的地。

例如, commit -a 實際上是一個兩步過程。第一步把每個追蹤檔案當前狀態的快照放 到索引中。第二步永久記錄索引中的快照。 沒有 -a 的提交只執行第二步,並且只在 運行不知何故改變索引的命令才有意義,比如 git add

通常我們可以忽略索引並假裝從歷史中直接讀並直接寫。在這個情況下,我們希望更好 地控制,因此我們操作索引。我們放我們變更的一些的快照到索引中,而不是所有的, 然後永久地記錄這個小心操縱的快照。

別丟了你的HEAD

HEAD好似一個游標,通常指向最新提交,隨最新提交向前移動。一些Git命令讓你來移動 它。 例如:

$ git reset HEAD~3

將立即向回移動HEAD三個提交。這樣所有Git命令都表現得好似你沒有做那最後三個提交, 然而你的檔案保持在現在的狀態。具體應用參見幫助頁。

但如何回到將來呢?過去的提交對將來一無所知。

如果你有原先Head的SHA1值,那麼:

$ git reset 1b6d

但假設你從來沒有記下呢?別擔心,像這些命令,Git保存原先的Head為一個叫 ORGI_HEAD的標記,你可以安全體面的返回:

$ git reset ORIG_HEAD

HEAD捕獵

或許ORG_HEAD不夠。或許你剛認識到你犯了個歷史性的錯誤,你需要回到一個早已忘記 分支上一個遠古的提交。

預設,Git保存一個提交至少兩星期,即使你命令Git摧毀該提交所在的分支。難點是找 到相應的哈希值。你可以查看在.git/objects裡所有的哈希值並嘗試找到你期望的。但 有一個更容易的辦法。

Git把算出的提交哈希值記錄在“.git/logs”。這個子目錄引用包括所有分支上所有活 動的歷史,同時檔案HEAD顯示它曾經有過的所有哈希值。後者可用來發現分支上一些不 小心丟掉提交的哈希值。

The reflog command provides a friendly interface to these log files. Try

命令reflog為訪問這些日誌檔案提供友好的介面,試試

$ git reflog

而不是從reflog拷貝粘貼哈希值,試一下:

$ git checkout "@{10 minutes ago}"

或者撿出後五次訪問過的提交,通過:

$ git checkout "@{5}"

更多內容參見 git help rev-parse 的‘`Specifying Revisions’'部分。

你或許期望去為已刪除的提交設置一個更長的保存周期。例如:

$ git config gc.pruneexpire "30 days"

意思是一個被刪除的提交會在刪除30天後,且運行 git gc 以後,被永久丟棄。

你或許還想關掉 git gc 的自動運行:

$ git config gc.auto 0

在這種情況下提交將只在你手工運行 git gc 的情況下才永久刪除。

基于Git構建

依照真正的UNIX風格設計,Git允許其易於用作其他程序的底層組件,比如圖形界面, Web界面,可選擇的命令行界面,補丁管理工具,導入和轉換工具等等。實際上,一些 Git命令它們自己就是站在巨人肩膀上的腳本。通過一點修補,你可以定製Git適應你的 偏好。

一個簡單的技巧是,用Git內建alias命令來縮短你最常使用命令:

$ git config --global alias.co checkout
$ git config --global --get-regexp alias  # 顯示當前別名
alias.co checkout
$ git co foo                              # 和“git checkout foo”一樣

另一個技巧,在提示符或窗口標題上打印當前分支。調用:

$ git symbolic-ref HEAD

顯示當前分支名。在實際應用中,你可能最想去掉“refs/heads/”並忽略錯誤:

$ git symbolic-ref HEAD 2> /dev/null | cut -b 12-

子目錄 contrib 是一個基于Git工具的寶庫。它們中的一些時時會被提升為官方命令。 在Debian和Ubuntu,這個目錄位於 /usr/share/doc/git-core/contrib

一個受歡迎的居民是 workdir/git-new-workdir 。通過聰明的符號連結,這個腳本創 建一個新的工作目錄,其歷史與原來的倉庫共享:

$ git-new-workdir an/existing/repo new/directory

這個新的目錄和其中的檔案可被視為一個克隆,除了既然歷史是共享的,兩者的樹自動 保持同步。不必合併,推入或拉出。

大膽的特技

這些天,Git使得用戶意外摧毀數據變得更困難。但如若你知道你在做什麼,你可以突破 為通用命令所設的防衛保障。

*Checkout*:未提交的變更會導致撿出失敗。銷毀你的變更,並無論如何都checkout一 個指定的提交,使用強制標記:

$ git checkout -f HEAD^

另外,如果你為撿出指定特別路徑,那就沒有安全檢查了。提供的路徑將被不加提示地 覆蓋。如你使用這種方式的檢出,要小心。

Reset: 如有未提交變更重置也會失敗。強制其通過,運行:

$ git reset --hard 1b6d

Branch: 引起變更丟失的分支刪除會失敗。強制刪除,鍵入:

$ git branch -D dead_branch  # instead of -d

類似,通過移動試圖覆蓋分支,如果隨之而來有數據丟失,也會失敗。強制移動分支,鍵入:

$ git branch -M source target  # 而不是 -m

不像checkout和重置,這兩個命令延遲數據銷毀。這個變更仍然存儲在.git的子目錄裡, 並且可以通過恢復.git/logs裡的相應哈希值獲取(參見上面 上面“HEAD獵捕”)。默 認情況下,這些數據會保存至少兩星期。

Clean: 一些Git命令拒絶執行,因為它們擔心會重裝未納入管理的檔案。如果你確信 所有未納入管理的檔案都是消耗,那就無情地刪除它們,使用:

$ git clean -f -d

下次,那個討厭的命令就會工作!

阻止壞提交

愚蠢的錯誤污染我的倉庫。最可怕的是由於忘記 git add 而引起的檔案丟失。較小 的罪過是行末追加空格並引起合併衝突:儘管危害少,我希望浙西永遠不要出現在公開 記錄裡。

不過我購買了傻瓜保險,通過使用一個_鈎子_來提醒我這些問題:

$ cd .git/hooks
$ cp pre-commit.sample pre-commit  # 對舊版本Git,先運行chmod +x

現在Git放棄提交,如果檢測到無用的空格或未解決的合併衝突。

對本文檔,我最終添加以下到 pre-commit 鈎子的前面,來防止缺魂兒的事:

if git ls-files -o | grep '\.txt$'; then
  echo FAIL! Untracked .txt files.
  exit 1
fi

幾個git操作支持鈎子;參見 git help hooks 。我們早先激活了作為例子的 post-update 鈎子,當討論基于HTTP的Git的時候。無論head何時移動,這個鈎子都會 運行。例子腳本post-update更新Git在基于Git並不知曉的傳輸協議,諸如HTTP,通訊時 所需的檔案。