Git word-diff:看清單行 HTML 裡的文案修改

放大鏡與珊瑚紅、青綠文字片段,示意 Git 行內差異比較

商品介紹的 HTML 全擠在同一行,只改一小段按鈕文案,一般 git diff 卻標示整行刪除再新增。用 --word-diff 可以在行內標出改動,較容易看清這次換了哪幾個字詞。

先限定要看的檔案

在 Git 工作目錄中執行下面的命令,將 templates/product.html 換成自己的檔案。它比較工作目錄與暫存區之間的修改。

git diff --word-diff=plain -- templates/product.html

刪除內容會放進 [- -],新增內容會放進 {+ +}。例如把英文按鈕的 Buy now 改成 View plans,原始檔案是下面這一行。

<a class="buy">Buy now</a>

修改後的行內差異如下。預設以空白切分單字,標籤可能與旁邊的文字一起進入標記;這不表示整個標籤都被改掉。

<a [-class="buy">Buy now</a>-]{+class="buy">View plans</a>+}

中文沒有空白時,先看清分詞限制

中文 HTML 常沒有空白,整段標籤與文案可能被當成同一塊,因此行內標記未必能縮小到某一個中文字。這時並排查看修改前後的原文,或用編輯器的差異檢視確認細節;不用為了讓差異好看而在網頁文案加空格。

官方也提供 --word-diff-regex 自訂分詞,但正規表示式以外的內容會被忽略,不能把標記看成完整修改清單。不同平台的字元處理也可能不同,中文出現亂碼時應回到原文核對。

已暫存的修改,加上 –cached

若已經做過 git add,一般 git diff 可能沒有輸出。這時改看暫存區與目前提交的差異。

git diff --cached --word-diff=plain -- templates/product.html

要比較兩個已提交版本,也可以在檔名分隔符 -- 前指定兩個提交。以下將示例標籤換成實際存在的版本。

git diff --word-diff=plain v1.0.0 v1.1.0 -- templates/product.html

行內標記適合人工閱讀。原始文字如果本身就含 [- 或 {+,標記可能混在一起。需要產生補丁時,另外使用一般差異輸出;--word-diff=plain 的畫面不要直接拿來套補丁。看完文案差異,也打開頁面確認按鈕、連結和版面,Git 顯示的文字差異不會替你執行 HTML。

封面為 AI 生成的文字比較概念插畫。

參考資料

原文鏈接:https://wntheme.com/git-word-diff-html-copy/,轉載請註明出處。
0
顯示驗證碼
沒有帳號?註冊  忘記密碼?