實用設定#

Git 的設定可以分成兩大類：config 設定和 attributes 設定。

  • config ：設定 Git 的行為與使用習慣，不針對特定檔案。

  • attributes ：設定 Git 在處理特定檔案或目錄時的行為，例如合併策略、匯出行為等。

Git config#

Git 有三個層級的設定檔，依照優先級由高至低排序如下：

  1. .git/config （專案層級）

  2. ~/.gitconfig（使用 –global 參數，使用者層級）

  3. /etc/gitconfig（使用 –system 參數，系統層級）

實用的設定項目#

  • core.editor ：設定 Git 預設的文字編輯器。

  • commit.template ：設定 commit message 的預設模板。

  • user.signingkey ：設定簽署用的 GPG 金鑰。

  • core.excludesfile ：設定全域的忽略檔案（類似 .gitignore，但適用所有專案）。

  • help.autocorrect ：自動修正輸錯的 Git 指令。

  • core.autocrlf ：處理跨平台換行（CRLF 和 LF）問題。

  • core.hooksPath ：指定 Git hooks 腳本的放置路徑。

Git Attributes#

Git Attributes 的設定檔有三個層級，依照優先級由高至低排序如下：

  1. /etc/gitattributes ：系統層級設定。

  2. .gitattributes ：版本控制的屬性設定，會隨專案一起被提交。

  3. .git/info/attributes ：專案層級設定，但不會被版本控制。

實用屬性設定#

  • export-ignore ：在使用 git archive 指令時，忽略特定檔案或目錄。

  • merge=ours： 指定特定檔案在合併衝突時，自動採用「本地版本」（ours）而忽略對方變更。

Warning

使用 merge=ours 前，需要先在 Git config 中定義 ours 合併驅動器，例如：

1git config merge.ours.driver true

Hook#

Hook 的功能是在重要事件發生時觸發自訂腳本。下面列出常用的 hook

Hook 名稱

執行時機

常見用途

pre-commit

git commit 前

格式化程式碼、Lint 檢查、單元測試、阻止錯誤提交

commit-msg

commit 訊息輸入後

驗證訊息格式（如 Conventional Commits）

pre-push

git push 前

確認測試通過、限制推送、檢查 branch 名稱等

post-checkout

切換分支後

自動切換 .env、設定環境、執行初始化腳本等