章節 ▾ 第二版

10.8 Git 內部原理 - 環境變數

環境變數

Git 始終在 bash shell 中執行，並使用許多 shell 環境變數來決定其行為方式。偶爾，瞭解這些變數是什麼以及如何使用它們來使 Git 按照您希望的方式執行會很有用。這並不是 Git 注意的所有環境變數的詳盡列表，但我們將涵蓋最常用的一些。

全域性行為

Git 作為計算機程式的一些通用行為取決於環境變數。

GIT_EXEC_PATH 決定了 Git 在何處查詢其子程式（例如 git-commit、git-diff 等）。您可以透過執行 git --exec-path 來檢查當前設定。

HOME 通常不被認為是可定製的（太多其他東西依賴於它），但它是 Git 查詢全域性配置檔案的地方。如果您想要一個真正便攜的 Git 安裝，幷包含全域性配置，您可以在行動式 Git 的 shell 配置檔案中覆蓋 HOME。

PREFIX 類似，但用於系統範圍的配置。Git 在 $PREFIX/etc/gitconfig 查詢此檔案。

GIT_CONFIG_NOSYSTEM，如果設定，將停用系統範圍配置檔案的使用。如果您的系統配置干擾了您的命令，但您無權更改或刪除它，這會很有用。

GIT_PAGER 控制用於在命令列上顯示多頁輸出的程式。如果未設定此變數，則 PAGER 將用作備用。

GIT_EDITOR 是當用戶需要編輯某些文字（例如提交訊息）時 Git 將啟動的編輯器。如果未設定，將使用 EDITOR。

倉庫位置

Git 使用多個環境變數來決定它如何與當前倉庫互動。

GIT_DIR 是 .git 資料夾的位置。如果未指定此變數，Git 將向上遍歷目錄樹，直到到達 ~ 或 /，每一步都查詢 .git 目錄。

GIT_CEILING_DIRECTORIES 控制搜尋 .git 目錄的行為。如果您訪問載入緩慢的目錄（例如磁帶驅動器上或透過慢速網路連線的目錄），您可能希望 Git 比平時更早停止嘗試，特別是當在構建 shell 提示符時呼叫 Git 時。

GIT_WORK_TREE 是非裸倉庫工作目錄的根目錄位置。如果指定了 --git-dir 或 GIT_DIR，但未指定 --work-tree、GIT_WORK_TREE 或 core.worktree 中的任何一個，則當前工作目錄被視為工作樹的頂層。

GIT_INDEX_FILE 是索引檔案（僅限非裸倉庫）的路徑。

GIT_OBJECT_DIRECTORY 可用於指定通常位於 .git/objects 的目錄位置。

GIT_ALTERNATE_OBJECT_DIRECTORIES 是一個冒號分隔的列表（格式如 /dir/one:/dir/two:…），它告訴 Git 如果物件不在 GIT_OBJECT_DIRECTORY 中，應該在哪裡檢查。如果您碰巧有許多包含內容完全相同的大型檔案的專案，這可以用於避免儲存過多的副本。

路徑規範 (Pathspecs)

“路徑規範 (pathspec)” 指的是您在 Git 中指定路徑的方式，包括使用萬用字元。它們用於 .gitignore 檔案，也用於命令列（git add *.c）。

GIT_GLOB_PATHSPECS 和 GIT_NOGLOB_PATHSPECS 控制路徑規範中萬用字元的預設行為。如果 GIT_GLOB_PATHSPECS 設定為 1，萬用字元字元將作為萬用字元起作用（這是預設行為）；如果 GIT_NOGLOB_PATHSPECS 設定為 1，萬用字元字元只匹配它們自身，這意味著像 *.c 這樣的模式將只匹配一個名為 “\*.c” 的檔案，而不是任何以 .c 結尾的檔案。您可以透過在路徑規範前加上 :(glob) 或 :(literal) 來在單獨的情況下覆蓋此行為，例如 :(glob)\*.c。

GIT_LITERAL_PATHSPECS 停用上述兩種行為；萬用字元字元將不起作用，並且覆蓋字首也會被停用。

GIT_ICASE_PATHSPECS 將所有路徑規範設定為以不區分大小寫的方式工作。

提交 (Committing)

Git 提交物件的最終建立通常由 git-commit-tree 完成，它使用這些環境變數作為其主要資訊源，僅當這些變數不存在時才回退到配置值。

GIT_AUTHOR_NAME 是“author”欄位中的人類可讀名稱。

GIT_AUTHOR_EMAIL 是“author”欄位的電子郵件地址。

GIT_AUTHOR_DATE 是“author”欄位使用的時間戳。

GIT_COMMITTER_NAME 設定“committer”欄位的人類名稱。

GIT_COMMITTER_EMAIL 是“committer”欄位的電子郵件地址。

GIT_COMMITTER_DATE 用於“committer”欄位的時間戳。

EMAIL 是在未設定 user.email 配置值時的備用電子郵件地址。如果此變數未設定，Git 將回退到系統使用者和主機名。

網路

Git 使用 curl 庫透過 HTTP 執行網路操作，因此 GIT_CURL_VERBOSE 告訴 Git 輸出該庫生成的所有訊息。這類似於在命令列上執行 curl -v。

GIT_SSL_NO_VERIFY 告訴 Git 不驗證 SSL 證書。如果您使用自簽名證書透過 HTTPS 提供 Git 倉庫，或者您正在設定 Git 伺服器但尚未安裝完整證書，有時這可能是必要的。

如果 HTTP 操作的資料速率低於 **GIT_HTTP_LOW_SPEED_LIMIT** 位元組/秒，並且持續時間超過 **GIT_HTTP_LOW_SPEED_TIME** 秒，Git 將中止該操作。這些值會覆蓋 http.lowSpeedLimit 和 http.lowSpeedTime 配置值。

GIT_HTTP_USER_AGENT 設定 Git 在透過 HTTP 通訊時使用的使用者代理字串。預設值類似於 git#2.0.0。

差異比較與合併

GIT_DIFF_OPTS 有點用詞不當。唯一有效的值是 -u<n> 或 --unified=<n>，它們控制 git diff 命令中顯示的上下文行數。

GIT_EXTERNAL_DIFF 用作 diff.external 配置值的覆蓋。如果設定，當呼叫 git diff 時，Git 將呼叫此程式。

GIT_DIFF_PATH_COUNTER 和 GIT_DIFF_PATH_TOTAL 在由 GIT_EXTERNAL_DIFF 或 diff.external 指定的程式內部非常有用。前者表示系列中正在進行差異比較的檔案（從 1 開始），後者是批處理中的檔案總數。

GIT_MERGE_VERBOSITY 控制遞迴合併策略的輸出。允許的值如下：

  • 0：不輸出任何內容，可能除了一個錯誤訊息。

  • 1：只顯示衝突。

  • 2：也顯示檔案更改。

  • 3：顯示檔案因未更改而被跳過的情況。

  • 4：顯示處理過的所有路徑。

  • 5 及以上：顯示詳細的除錯資訊。

預設值為 2。

除錯

想真正瞭解 Git 在做什麼？Git 內建了一套相當完整的跟蹤功能，您所需要做的就是開啟它們。這些變數的可能值如下：

  • “true”、“1”或“2”——跟蹤類別寫入到標準錯誤 (stderr)。

  • 以 / 開頭的絕對路徑——跟蹤輸出將寫入該檔案。

GIT_TRACE 控制通用跟蹤，這些跟蹤不屬於任何特定類別。這包括別名的展開以及對其他子程式的委派。

$ GIT_TRACE=true git lga
20:12:49.877982 git.c:554               trace: exec: 'git-lga'
20:12:49.878369 run-command.c:341       trace: run_command: 'git-lga'
20:12:49.879529 git.c:282               trace: alias expansion: lga => 'log' '--graph' '--pretty=oneline' '--abbrev-commit' '--decorate' '--all'
20:12:49.879885 git.c:349               trace: built-in: git 'log' '--graph' '--pretty=oneline' '--abbrev-commit' '--decorate' '--all'
20:12:49.899217 run-command.c:341       trace: run_command: 'less'
20:12:49.899675 run-command.c:192       trace: exec: 'less'

GIT_TRACE_PACK_ACCESS 控制 packfile 訪問的跟蹤。第一個欄位是被訪問的 packfile，第二個欄位是該檔案內的偏移量。

$ GIT_TRACE_PACK_ACCESS=true git status
20:10:12.081397 sha1_file.c:2088        .git/objects/pack/pack-c3fa...291e.pack 12
20:10:12.081886 sha1_file.c:2088        .git/objects/pack/pack-c3fa...291e.pack 34662
20:10:12.082115 sha1_file.c:2088        .git/objects/pack/pack-c3fa...291e.pack 35175
# […]
20:10:12.087398 sha1_file.c:2088        .git/objects/pack/pack-e80e...e3d2.pack 56914983
20:10:12.087419 sha1_file.c:2088        .git/objects/pack/pack-e80e...e3d2.pack 14303666
On branch master
Your branch is up-to-date with 'origin/master'.
nothing to commit, working directory clean

GIT_TRACE_PACKET 啟用網路操作的包級別跟蹤。

$ GIT_TRACE_PACKET=true git ls-remote origin
20:15:14.867043 pkt-line.c:46           packet:          git< # service=git-upload-pack
20:15:14.867071 pkt-line.c:46           packet:          git< 0000
20:15:14.867079 pkt-line.c:46           packet:          git< 97b8860c071898d9e162678ea1035a8ced2f8b1f HEAD\0multi_ack thin-pack side-band side-band-64k ofs-delta shallow no-progress include-tag multi_ack_detailed no-done symref=HEAD:refs/heads/master agent=git#2.0.4
20:15:14.867088 pkt-line.c:46           packet:          git< 0f20ae29889d61f2e93ae00fd34f1cdb53285702 refs/heads/ab/add-interactive-show-diff-func-name
20:15:14.867094 pkt-line.c:46           packet:          git< 36dc827bc9d17f80ed4f326de21247a5d1341fbc refs/heads/ah/doc-gitk-config
# […]

GIT_TRACE_PERFORMANCE 控制性能資料的日誌記錄。輸出顯示每次特定的 git 呼叫需要多長時間。

$ GIT_TRACE_PERFORMANCE=true git gc
20:18:19.499676 trace.c:414             performance: 0.374835000 s: git command: 'git' 'pack-refs' '--all' '--prune'
20:18:19.845585 trace.c:414             performance: 0.343020000 s: git command: 'git' 'reflog' 'expire' '--all'
Counting objects: 170994, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (43413/43413), done.
Writing objects: 100% (170994/170994), done.
Total 170994 (delta 126176), reused 170524 (delta 125706)
20:18:23.567927 trace.c:414             performance: 3.715349000 s: git command: 'git' 'pack-objects' '--keep-true-parents' '--honor-pack-keep' '--non-empty' '--all' '--reflog' '--unpack-unreachable=2.weeks.ago' '--local' '--delta-base-offset' '.git/objects/pack/.tmp-49190-pack'
20:18:23.584728 trace.c:414             performance: 0.000910000 s: git command: 'git' 'prune-packed'
20:18:23.605218 trace.c:414             performance: 0.017972000 s: git command: 'git' 'update-server-info'
20:18:23.606342 trace.c:414             performance: 3.756312000 s: git command: 'git' 'repack' '-d' '-l' '-A' '--unpack-unreachable=2.weeks.ago'
Checking connectivity: 170994, done.
20:18:25.225424 trace.c:414             performance: 1.616423000 s: git command: 'git' 'prune' '--expire' '2.weeks.ago'
20:18:25.232403 trace.c:414             performance: 0.001051000 s: git command: 'git' 'rerere' 'gc'
20:18:25.233159 trace.c:414             performance: 6.112217000 s: git command: 'git' 'gc'

GIT_TRACE_SETUP 顯示 Git 正在發現的關於它正在互動的倉庫和環境的資訊。

$ GIT_TRACE_SETUP=true git status
20:19:47.086765 trace.c:315             setup: git_dir: .git
20:19:47.087184 trace.c:316             setup: worktree: /Users/ben/src/git
20:19:47.087191 trace.c:317             setup: cwd: /Users/ben/src/git
20:19:47.087194 trace.c:318             setup: prefix: (null)
On branch master
Your branch is up-to-date with 'origin/master'.
nothing to commit, working directory clean

雜項

GIT_SSH，如果指定，是一個程式，當 Git 嘗試連線到 SSH 主機時，它會代替 ssh 被呼叫。它的呼叫方式類似於 $GIT_SSH [username@]host [-p <port>] <command>。請注意，這不是自定義 ssh 呼叫方式的最簡單方法；它不支援額外的命令列引數。要支援額外的命令列引數，您可以使用 GIT_SSH_COMMAND，編寫一個包裝指令碼並將其指向 GIT_SSH，或使用 ~/.ssh/config 檔案。

GIT_SSH_COMMAND 設定 Git 嘗試連線到 SSH 主機時使用的 SSH 命令。該命令由 shell 解釋，並且可以與 ssh 一起使用額外的命令列引數，例如 GIT_SSH_COMMAND="ssh -i ~/.ssh/my_key" git clone git@example.com:my/repo。

GIT_ASKPASS 是 core.askpass 配置值的覆蓋。這是當 Git 需要向用戶請求憑據時呼叫的程式，它可以期望一個文字提示作為命令列引數，並且應該在 stdout 上返回答案（有關此子系統的更多資訊，請參閱憑據儲存）。

GIT_NAMESPACE 控制對名稱空間引用的訪問，等同於 --namespace 標誌。這主要在伺服器端有用，您可能希望將單個倉庫的多個分支儲存在一個倉庫中，只保持引用分開。

GIT_FLUSH 可用於強制 Git 在向 stdout 增量寫入時使用非緩衝 I/O。值為 1 會使 Git 更頻繁地重新整理，值為 0 會使所有輸出都被緩衝。預設值（如果未設定此變數）是根據活動和輸出模式選擇適當的緩衝方案。

GIT_REFLOG_ACTION 允許您指定寫入 reflog 的描述性文字。示例如下：

$ GIT_REFLOG_ACTION="my action" git commit --allow-empty -m 'My message'
[master 9e3d55a] My message
$ git reflog -1
9e3d55a HEAD@{0}: my action: My message
scroll-to-top