.gitattributes 是 Git 版本控制系統中的一個配置文件，用于定義特定文件或路徑的屬性，從而控制 Git 如何處理這些文件。它類似于 .gitignore，但功能更廣泛，可以精細化管理文件在版本控制中的行為。
主要用途
以下是 .gitattributes 的常見使用場景：
-
統一換行符（Line Endings）
不同操作系統使用不同的換行符（如 Windows 用CRLF，Linux/macOS 用LF）。通過.gitattributes可以強制統一換行符，避免跨平臺協作時的混亂。
例如：# 對所有文本文件，檢出時轉換為 CRLF，提交時轉換為 LF * text=auto -
標記二進制文件
告訴 Git 某些文件是二進制（如圖片、壓縮包），避免 Git 誤將其視為文本文件進行差異比較（diff）或合并（merge）。
例如：*.png binary *.pdf binary -
自定義差異比較（Diff）和合并（Merge）策略
指定特定文件使用自定義工具進行差異比較或合并。例如，對 Markdown 文件忽略空格變化：*.md diff=markdown并在 Git 配置中定義對應的差異驅動：
git config diff.markdown.textconv "markdown-filter" -
合并沖突處理策略
定義某些文件在合并沖突時的默認行為。例如，鎖文件（如package-lock.json）始終接受當前分支的版本：package-lock.json merge=ours -
導出過濾（Export Control）
在生成代碼歸檔（如git archive）時排除某些文件。例如忽略測試文件：/tests/ export-ignore -
語言編碼處理
指定文件編碼，確保 Git 正確處理字符集。例如強制 UTF-8：*.txt charset=utf-8
文件語法
- 每行格式：
<pattern> <attribute1> <attribute2> ... - 支持通配符（如
*.md），目錄路徑（如/docs/）。 - 常用屬性：
text：控制換行符轉換（text=auto讓 Git 自動判斷）。binary：標記為二進制文件。merge：定義合并策略（如merge=ours）。diff：指定差異比較工具。-text：禁用換行符轉換。
示例文件
# 強制所有文本文件使用 LF 換行符，提交時自動轉換
* text=auto eol=lf# 標記二進制文件
*.jpg binary
*.zip binary# 合并時優先使用當前分支的 yarn.lock
yarn.lock merge=ours# 導出時忽略測試文件和配置文件
/test/ export-ignore
/config.yml export-ignore# 使用自定義差異工具處理 CSV 文件
*.csv diff=csv
與 .gitignore 的區別
.gitignore：忽略文件，禁止 Git 跟蹤它們。.gitattributes：管理已跟蹤文件的屬性，控制 Git 如何處理這些文件。
最佳實踐
- 將
.gitattributes提交到倉庫，確保團隊行為一致。 - 在跨平臺協作項目中，優先使用
text=auto避免換行符問題。 - 對二進制文件明確標記
binary，防止 Git 進行無效的文本操作。
通過合理配置 .gitattributes，可以顯著減少因文件格式、合并沖突等引起的協作問題。
.gitattributes 和 .gitconfig 都是 Git 的配置文件，但用途、作用范圍和存儲位置完全不同。以下是它們的核心區別：
1. 用途
| 文件 | 作用 |
|---|---|
.gitattributes | 定義倉庫中特定文件/路徑的屬性，控制 Git 如何處理這些文件（如換行符、合并策略、二進制文件標記等）。 |
.gitconfig | 配置用戶全局或本地的 Git 行為（如用戶名、郵箱、別名、默認編輯器、HTTP 代理等）。 |
2. 作用范圍
| 文件 | 作用范圍 |
|---|---|
.gitattributes | 倉庫級別：僅對當前倉庫生效，且會提交到版本庫中，影響所有協作者。 |
.gitconfig | 用戶級別：分為全局（~/.gitconfig）和倉庫本地（.git/config），僅影響當前用戶的 Git 環境。 |
3. 配置內容
.gitattributes 示例
# 換行符統一為 LF
* text=auto eol=lf# 標記二進制文件
*.png binary# 合并時使用當前分支的鎖文件
package-lock.json merge=ours
.gitconfig 示例
# 全局用戶名和郵箱
[user]name = John Doeemail = john@example.com# 自定義別名
[alias]st = statusco = checkout# 設置默認編輯器為 VS Code
[core]editor = code --wait
4. 存儲位置
| 文件 | 存儲位置 |
|---|---|
.gitattributes | 倉庫根目錄，提交到版本控制中（.gitattributes 文件）。 |
.gitconfig | - 全局配置：用戶主目錄（如 ~/.gitconfig）- 本地配置：倉庫的 .git/config 文件。 |
5. 是否共享
| 文件 | 是否共享 |
|---|---|
.gitattributes | 是：隨倉庫提交，所有協作者生效。 |
.gitconfig | 否：僅影響當前用戶的 Git 環境，不共享。 |
關鍵區別總結
| 特性 | .gitattributes | .gitconfig |
|---|---|---|
| 目標對象 | 倉庫中的文件/路徑 | 用戶的 Git 環境（全局或本地） |
| 共享性 | 提交到倉庫，影響所有人 | 僅本地或當前用戶生效 |
| 典型配置項 | 換行符、二進制標記、合并策略、差異工具 | 用戶名、郵箱、別名、編輯器、代理、憑證 |
| 修改命令 | 直接編輯文件 | git config --global 或 git config --local |
使用場景舉例
-
.gitattributes的場景- 團隊協作時統一換行符（避免 Windows 和 Unix 換行符沖突）。
- 確保二進制文件（如圖片、PDF）不被 Git 誤識別為文本。
- 定義特定文件（如
package-lock.json）的合并策略。
-
.gitconfig的場景- 設置個人用戶名和郵箱（提交代碼時顯示作者信息）。
- 創建快捷命令別名（如
git st代替git status）。 - 配置 HTTP 代理或 Git 憑證存儲方式（如緩存密碼）。
總結
- 如果你想讓所有協作者遵守某些文件處理規則 → 用
.gitattributes。 - 如果你想自定義個人 Git 環境（如別名、編輯器） → 用
.gitconfig。
兩者分工明確，共同保障 Git 的高效協作和個性化體驗。
