HTML代码格式化对Git提交差异对比的优化方式

HTML未格式化时git diff满屏红绿，因Git字节级比对将属性顺序、换行、空格等视为修改；prettier --parser html是最佳格式化方案，配合--print-width 120和--single-attribute-per-line false可保语义一致；git diff --color-words='[^[:space:]]+|<1*>'聚焦真实改动；diff2html结合unified diff生成结构化对比，但DOM层级变动需lxml解析DOM树比对。> ↩

为什么HTML不格式化就git diff会满屏红绿

因为git diff只做字节级比对，而原始HTML里属性顺序、换行位置、缩进空格、自闭合写法（<img src="a"> vs <img src="a"/>）全是有效字符。浏览器渲染时忽略它们，Git却全当“修改”标出来——结果就是改一个class，整行变红变绿，真正改动被淹没。

prettier --parser html 是最稳的格式化方案

别用html-beautify或在线工具凑合，它们常重排属性顺序、乱加空行、把<br>改成<br/>，反而引入新差异。用prettier能保语义一致：

• prettier --parser html --print-width 120 --single-attribute-per-line false a.html > a.formatted.html（--single-attribute-per-line false防过度拆行）
• 加--no-semi避免JS内联脚本被误加分号
• 统一用.prettierrc配置，团队每人执行结果一致，避免“你格式化完我再格式化”导致二次diff

git diff --color-words='[^[:space:]]+|<[^>]*>' 聚焦真实改动

格式化后仍可能有少量差异（比如手动改文本），这时别再看整行patch。用词级高亮跳过格式扰动：

• 正则[^[:space:]]+|<[^>]*>匹配“非空格字符串”或“完整标签”，让class="old"→class="new"只标红old和new
• PowerShell用户需转义：git diff --color-words=`"[^[:space:]]+|]*>"`，建议直接用Git Bash
• 该正则不处理引号内嵌空格（如title="a b"），但日常改class、id、文本足够准

diff2html + unified diff 才是可交付的对比结果

终端里再怎么调颜色，也看不出<div>是否被意外移到了<header>外。导出结构化视图才可靠：

立即学习“前端免费学习笔记（深入）”；

• 先生成标准unified diff：git diff -u old.html new.html > diff.patch
• 用diff2html加载：Diff2Html.html(diffText, { drawFileList: false, matching: 'lines' })（matching: 'lines'防属性值被合并误判）
• 注意：diff2html默认不转义HTML内容，若diff.patch含未过滤的<script>，必须先用encodeURIComponent()编码再传入

真正难的是DOM层级变动——比如<ul>里删了一个<li>，但格式化后所有<li>缩进一致，diff只显示“删一行”，看不出是否破坏了列表结构。这种得靠lxml解析后比DOM树，不是格式化能解决的。