Git 實戰技巧 - 使用 git diff 比對 UTF-16/BIG5 文字檔

同事遇到的茶包。

git diff 時某文字檔被當成二進位檔案無法顯示差異，後來發現是 Unicode 編碼(UTF-16 LE with BOM/UCS-2 LE with BOM)造成，用以下範例重現：

type a.txt 可檢視文字內容，但 git diff 比對時卻出現 "Binary a/a.txt and b/a.txt differ"，未顯示修改前後差異。

爬文得知，git diff 自動偵測檔案為文字檔時會進行文字比對，但限定 UTF-8 編碼。這時要使用階技巧，在 .git/config (Repository 個別設定) 或 %userprofile%/.gitconfig (全域設定) 宣告額外 diff 轉換邏輯，例如：新增一組名為 utf16 的 diff 轉換設定，呼叫 iconv 將 utf-16 轉成 utf-8：

除了直接修改 config 或 .gitconfig，透過指令 git config diff.utf16.textconv "iconv -f utf-16 -t utf-8" 也能新增 diff 轉換。

接著，我們要用 .gitattributes 指定 git diff 那些檔案時套用編碼轉換。指定對象可以是特定路徑的檔案、特定副檔名類型、特定目錄下的檔案等，用法跟 .gitignore 一樣，套用對象後方則加上 diff=utf16，代表比對這類檔案前先進行 utf16 轉換。

a.txt diff=utf16
*.reg diff=utf16
**/somefolder diff=utf8

實測修改 .git/config 跟 .gitattributes 後，git diff 便能正確比對 UTF-16 編碼文字檔了。

舉一反三，之前遇到 BIG5 中文字變角括號的問題，應該也能用同樣技巧解決。

設定 git config diff.big5.textconv "iconv -f big5 -t utf-8"，.gitattributes 加上 b.txt diff=big5，薑! 薑! 薑! 薑~~~

Tips of how to use iconv conversion to make git diff compare UTF-16 or BIG5 encoding text files.