新手文件

Git 教程：第 1 部分, 第 2 部分。

Git 使用者手冊。日常 Git 與 20 條命令左右。Git 工作流。

高階文件

Git Magic，有多種語言翻譯。

Pro Git。關於 Git 的書。在 Amazon 購買或下載 PDF、mobi 或 ePub 格式。它有許多不同語言的翻譯。從 GArik 下載俄語翻譯。

Git Wiki.

Git Buch（德語）。

離線文件

Git 內建幫助：執行 git help $TOPIC。例如，執行 git help git 或 git help help。

下載和安裝

Unix 使用者：使用您的包管理器下載並安裝。

Microsoft Windows：下載 git-for-windows。

MacOS X：使用 XCode 安裝的 Git，或從 MacPorts 或 git-osx-installer 下載，或使用 Homebrew 安裝 Git：brew install git。

git-cola（倉庫）是一個用 Python 編寫並採用 GPL 許可的 Git GUI。支援 Linux、Windows、MacOS X。

TortoiseGit 是一個基於 TortoiseSVN 的 Windows Shell Git 介面；開源。

初始配置

這段簡單的程式碼經常出現在文件中，但它很重要，所以在這裡重複一下。Git 在每次提交中儲存作者和提交者的姓名/電子郵件，因此請配置您的真實姓名和首選電子郵件

$ git config --global user.name "User Name"
$ git config --global user.email user.name@example.org

更新本地分支和遠端跟蹤分支

要在不更新本地分支的情況下更新遠端跟蹤分支，請執行 git remote update [$REMOTE...]。例如

$ git remote update
$ git remote update origin

$ git fetch $REMOTE $BRANCH

$ git fetch $REMOTE $BRANCH:$BRANCH

$ git pull $REMOTE $BRANCH

$ git fetch $REMOTE $BRANCH
$ git merge FETCH_HEAD

$ git fetch origin v1:v1  # Update v1
$ git pull --rebase origin master  # Update the current branch master
                                   # using rebase instead of merge
$ git merge v1

$ git checkout v1
$ git pull --rebase origin v1
$ git checkout master
$ git pull --rebase origin master
$ git merge v1

$ git pull origin

$ git pull

$ git push origin v1 master

$ git push origin v1:v1 master:master

$ git push origin

$ git push

$ git config push.default simple

$ git config push.default matching

$ git fetch origin tag $TAG1 tag $TAG2...

$ git fetch origin tag 1.4.2
$ git fetch origin v1:v1 tag 2.1.7

$ git push origin tag 1.4.2
$ git push origin v1 master tag 2.1.7

$ git push --tags origin

git checkout：恢復檔案內容

git checkout，例如，可以用來將檔案內容恢復到某個提交。像這樣

git checkout HEAD~ README

該命令將 README 檔案的內容恢復到當前分支倒數第二個提交。預設情況下，提交 ID 只是 HEAD；即 git checkout README 將 README 恢復到最新提交。

（不要使用 git checkout 來檢視提交中的檔案內容，請使用 git cat-file -p；例如 git cat-file -p HEAD~:path/to/README）。

git reset：移除（未推送的）提交

git reset 移動當前分支的頭部。頭部可以移動到指向任何提交，但它通常用於從分支頂部刪除一個或幾個提交（最好是未推送的），即向後移動分支以撤消幾個（未推送的）提交。

git reset 有三種操作模式——軟、硬和混合。預設是混合模式。ProGit 解釋了 它們之間的區別非常清楚。裸倉庫沒有索引或工作樹，因此在裸倉庫中只可能進行軟重置。

git reflog：引用日誌

使用 git reset 刪除提交或移動分支的頭部聽起來很危險，確實如此。但有一種方法可以撤銷：再次重置回原始提交。Git 不會立即刪除提交；未引用的提交（在 Git 術語中稱為“懸空提交”）會在資料庫中停留一段時間（預設為兩週），因此您可以重置回它或建立一個指向原始提交的新分支。

對於每次分支頭部的移動——無論是透過 git commit、git checkout、git fetch、git pull、git rebase、git reset 等等——Git 都會儲存一個引用日誌（簡稱 reflog）。對於每次移動，Git 都會儲存頭部所在的位置。git reflog 命令可用於檢視（和操作）日誌。

除了每個分支頭部的移動之外，git 還儲存 HEAD 的移動——這是一個符號引用，（通常）它表示當前分支。HEAD 透過 git checkout $BRANCH 進行更改。

預設情況下，git reflog 顯示 HEAD 的移動，即該命令等效於 git reflog HEAD。要顯示分支頭部的移動，請使用命令 git reflog $BRANCH。

因此，要撤消 git reset，請在 git reflog 中查詢原始提交，使用 git show 或 git log 進行驗證，然後執行 git reset $COMMIT_ID。Git 將分支頭部的移動儲存在 reflog 中，因此您以後可以再次撤消該撤消。

在更復雜的情況下，您可能希望在重置分支頭部的同時移動一些提交。將它們櫻桃挑選到新分支。例如，如果您想將 master 分支重置回原始提交，但保留當前分支中建立的兩個提交，請執行類似操作

$ git branch save-master  # create a new branch saving master
$ git reflog  # find the original place of master
$ git reset $COMMIT_ID
$ git cherry-pick save-master~ save-master
$ git branch -D save-master  # remove temporary branch

git revert：回滾提交

git revert 會回滾一個或多個提交，也就是說，它會建立一個或多個新的提交來回滾給定提交的效果。這是撤消已釋出提交的唯一方法（git commit --amend、git rebase 和 git reset 以非快進的方式更改分支，因此它們只應用於未推送的提交。）

回滾合併提交存在問題。git revert 可以撤消合併提交建立的程式碼，但它無法撤消合併的事實。請參閱討論 如何回滾錯誤的合併。

無法撤消的事情

無論您撤銷什麼，有一件事是無法撤銷的——被覆蓋的未提交更改。未提交的更改不屬於 Git，因此 Git 無法幫助保留它們。

大多數情況下，當您要執行覆蓋未提交更改的命令時，Git 會警告您。Git 不允許您使用 git checkout 切換分支。當您在工作區不乾淨的情況下要進行變基時，它會阻止您。它拒絕在未提交的檔案上拉取新提交。

但是有些命令確實會這樣做——覆蓋工作樹中的檔案。像 git checkout $PATHs 或 git reset --hard 這樣的命令會默默地覆蓋檔案，包括您的未提交更改。

考慮到這一點，您就可以理解“儘早提交，經常提交”的立場了。儘可能經常提交。在編輯器或 IDE 中每次儲存時都提交。您可以在推送之前編輯您的提交——編輯提交訊息，更改提交，重新排序，組合，拆分，刪除。但請將您的更改儲存在 Git 資料庫中，要麼提交更改，要麼至少使用 git stash 將它們暫存起來。

行尾符

Git 內建機制可處理不同行尾樣式平臺之間的行尾問題。要讓 Git 進行 CRLF 轉換，請使用 .gitattributes 為檔案分配 text 屬性。對於必須具有特定行尾的檔案，請分配 eol 屬性。對於二進位制檔案，屬性自然是 binary。

例如

$ cat .gitattributes
*.py text
*.txt text
*.png binary
/readme.txt eol=CRLF

要檢查 Git 為檔案使用的屬性，請使用 git check-attr 命令。例如

$ git check-attr -a -- \*.py

有用的資源

GitAlias（倉庫）是大量的別名集合。仔細選擇常用命令的別名可以節省您大量的擊鍵！

GitIgnore 和 https://github.com/github/gitignore 是適用於各種 IDE 和程式語言的 .gitignore 檔案集合。包括 Python！

pre-commit（倉庫）是一個用於管理和維護多語言 pre-commit 鉤子的框架。該框架用 Python 編寫，擁有許多用於多種程式語言的外掛。

暫存區

暫存區，又稱索引或快取，是 Git 的一個顯著特性。暫存區是 Git 在提交補丁之前收集補丁的地方。收集補丁和提交階段的分離提供了 Git 一個非常有用的功能：您可以在提交之前檢視收集到的補丁，甚至可以編輯它們——刪除一些程式碼塊，新增新的程式碼塊，然後再次檢視。

要將檔案新增到索引，請使用 git add。在提交之前收集補丁意味著您需要對每次更改都這樣做，而不僅僅是新增新的（未跟蹤的）檔案。為了簡化提交，如果您只想在不審查的情況下提交所有內容，請執行 git commit --all（或簡寫 -a）——該命令會將每個更改的已跟蹤檔案新增到索引，然後提交。要提交一個或多個檔案，而不考慮索引中收集的補丁，請執行 git commit [--only|-o] -- $FILE...。

要將補丁塊新增到索引，請使用 git add --patch（或簡寫 -p）。要從索引中刪除已收集的檔案，請使用 git reset HEAD -- $FILE...。要新增/檢查/刪除已收集的補丁塊，請使用 git add --interactive（-i）。

要檢視索引和上次提交之間的差異（即收集到的補丁），請使用 git diff --cached。要檢視工作樹和索引之間的差異（即未收集的補丁），請只使用 git diff。要檢視工作樹和上次提交之間的差異（即收集和未收集的補丁），請執行 git diff HEAD。

參見 Git Wiki 中的 WhatIsTheIndex 和 IndexCommandQuickref。

根目錄

Git 在執行任何命令之前會切換到根目錄（專案頂層目錄，其中包含 .git 子目錄）。但 Git 會記住切換前所在的當前目錄。有些程式會考慮當前目錄。例如，git status 顯示相對於當前目錄的更改和未知檔案的路徑；git grep 在當前目錄下方搜尋；git apply 只應用補丁中影響當前目錄下方檔案的 hunk。

但大多數命令都是從根目錄執行並忽略當前目錄的。例如，假設您有兩個工作樹，一個用於 v1 分支，另一個用於 master。如果您想在第二個工作樹內的子目錄中合併 v1，您必須像在頂層目錄中一樣編寫命令。例如，假設有兩個工作樹，project-v1 和 project，例如

$ cd project/subdirectory
$ git fetch ../project-v1 v1:v1
$ git merge v1

請注意，在 git fetch ../project-v1 v1:v1 中，路徑是 ../project-v1，而不是 ../../project-v1，儘管我們是從子目錄而不是根目錄執行命令。

ReReRe

Rerere 是一種幫助解決重複合併衝突的機制。重複合併衝突最常見的來源是將主題分支合併到主線中然後刪除合併提交；這通常用於測試主題分支並訓練 rerere；刪除合併提交是為了擁有乾淨的線性歷史，並以僅一個最終合併提交結束主題分支。

Rerere 的工作原理是記住成功提交前後樹的狀態。這樣，如果衝突出現在相同的檔案中，rerere 就可以自動解決它們。

Rerere 可以使用 git rerere 命令手動使用，但最常自動使用。在工作樹中啟用 rerere，使用以下命令

$ git config rerere.enabled true
$ git config rerere.autoupdate true

您不需要全域性開啟 rerere——您不需要在裸倉庫或單分支倉庫中使用 rerere；您只需要在經常執行合併和解決合併衝突的倉庫中使用 rerere。

請參閱《Pro Git》中的 Rerere。

資料庫維護

Git 物件資料庫和 .git 下的其他檔案/目錄需要定期維護和清理。例如，提交編輯會留下未引用的物件（在 Git 術語中稱為懸空物件），這些物件應該被修剪以避免在資料庫中堆積垃圾。命令 git gc 用於維護。Git 自動將 git gc --auto 作為某些命令的一部分執行，以進行快速維護。建議使用者不時執行 git gc --aggressive；git help gc 建議每隔幾百個變更集執行一次；對於更密集的專案，應該像每週一次，對於不那麼活躍的專案則不那麼頻繁（每兩週或每月一次）。

git gc --aggressive 不僅刪除懸空物件，它還將物件資料庫重新打包成索引和更最佳化的包；它還會打包符號引用（分支和標籤）。另一種方法是執行 git repack。

Linus Torvalds 有一則著名的 訊息，關於 git gc --aggressive 的“愚蠢”。現在這條訊息可以安全地忽略了。它已經過時了，從那時起 git gc --aggressive 已經變得好很多了。

對於那些仍然喜歡 git repack 而不是 git gc --aggressive 的人，推薦的引數是 git repack -a -d -f --depth=20 --window=250。有關這些引數影響的解釋，請參閱 這個詳細實驗。

不時執行 git fsck [--strict] 來驗證資料庫的完整性。git fsck 可能會生成一個懸空物件列表；這不是錯誤，只是提醒您進行定期維護。

命令列選項和引數

git help cli 建議不要組合短選項/標誌。大多數情況下組合是有效的：git commit -av 完美執行，但有時不起作用。例如，git log -p -5 不能組合成 git log -p5。

有些選項帶有引數，有些甚至有預設引數。在這種情況下，此類選項的引數必須以粘連方式拼寫：-Oarg，切勿 -O arg，因為對於具有預設引數的選項，後者表示“使用選項 -O 的預設值並將 arg 進一步傳遞給選項解析器”。例如，git grep 有一個選項 -O，它將找到的檔名列表傳遞給一個程式；-O 的預設程式是分頁器（通常是 less），但您可以使用您的編輯器

$ git grep -Ovim  # but not -O vim

順便說一句，如果 Git 被指示使用 less 作為分頁器（即，如果 Git 中根本沒有配置分頁器，它預設使用 less，或者如果它從 GIT_PAGER 或 PAGER 環境變數中獲取 less，或者如果它配置了 git config [--global] core.pager less，或者 less 在命令 git grep -Oless 中使用），git grep 會將 +/$pattern 選項傳遞給 less，這非常方便。不幸的是，如果分頁器不是精確的 less，即使是帶有引數的 less（例如 git config [--global] core.pager less -FRSXgimq），git grep 也不會傳遞模式；幸運的是，git grep -Oless 總是傳遞模式。

bash/zsh 補全

即使對於那些樂於使用命令列的人來說，手動鍵入 git rebase --interactive --preserve-merges HEAD~5 也有點困難，而這就是 shell 補全大有幫助的地方。Bash/zsh 帶有可程式設計補全功能，通常會自動安裝和啟用，所以如果你安裝了 bash/zsh 和 git，很可能你已經完成了——只需在命令列中使用它即可。

如果您沒有安裝必要的元件，請安裝並啟用 bash_completion 包。如果您想將 Git 補全升級到最新版本，請從 git contrib 下載必要的檔案。

Git-for-windows 附帶 git-bash，其中已安裝並啟用了 bash 補全。

bash/zsh 提示符

對於命令列愛好者來說，shell 提示符可以攜帶大量有用的資訊。要將 Git 資訊包含在提示符中，請使用 git-prompt.sh。請閱讀檔案中的詳細說明。

在網上搜索“git prompt”以查詢其他提示符變體。

SSH 連線共享

SSH 連線共享是 OpenSSH 以及 PuTTY 等衍生產品的一項功能。SSH 連線共享是一種透過建立一個連線並將其重用於連線到同一伺服器的所有後續客戶端來減少 ssh 客戶端啟動時間的方法。SSH 連線共享可用於加速大量短 ssh 會話，例如 scp、sftp、rsync，當然還有透過 ssh 的 Git。如果您經常從/向可透過 ssh 訪問的遠端倉庫 fetch/pull/push，建議使用 ssh 連線共享。

要開啟 SSH 連線共享，請在您的 ~/.ssh/config 中新增類似以下內容

Host *
ControlMaster auto
ControlPath ~/.ssh/mux-%r@%h:%p
ControlPersist 600

請參閱 OpenSSH wikibook 和 搜尋 瞭解更多資訊。

SSH 連線共享可以在 GitHub、GitLab 和 SourceForge 倉庫上使用，但請注意 BitBucket 不允許這樣做，並在短時間不活動後強制關閉主連線，因此您會看到來自 ssh 的類似錯誤：“與 bitbucket.org 的連線被遠端主機關閉。”