如何丢弃Git中自动生成GUID导致的无意义代码变更

日常用代码生成工具产出带动态GUID的代码时，每次运行生成的GUID值都会变化，会被Git误识别为代码变更。手动处理大文件（比如4万行、数千处变更）效率极低，之前尝试自定义word-diff规则匹配GUID生成diff但无法正常反向应用补丁，可以通过以下几种方案解决：

之前word-diff方案无法生效的核心原因很简单：--word-diff模式输出的不是标准patch格式，缺少行级上下文锚点和行号标识，patch工具无法识别匹配位置，自然没法反向应用还原，不要用这个模式的输出做补丁操作。

方案1：配置自定义diff驱动（长期生效，最推荐） #

这个方案从diff计算层面直接忽略纯GUID变更，不会影响其他正常代码改动的识别，一次配置长期生效：

• 第一步：在项目根目录的.gitattributes文件中添加规则，指定对应类型文件使用自定义diff驱动，以Delphi的.pas文件为例：

*.pas diff=guidignore

• 第二步：执行Git配置命令，给自定义驱动设置文本转换规则，加--global参数是全局所有仓库生效，去掉则仅对当前仓库生效：

git config --global diff.guidignore.textconv "sed -E 's/\{[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12}\}/\{FIXED_GUID_PLACEHOLDER\}/g'"

配置完成后，Git计算diff时会自动把所有匹配格式的GUID替换成固定占位符，仅修改GUID的行不会被判定为变更，正常代码修改完全不受影响。

方案2：批量还原当前工作区的纯GUID变更 #

如果已经生成了大量GUID变更，需要快速丢弃这类无效改动、保留其他有效代码变更，可以用Git内置的diff正则匹配能力批量处理：

# 先把所有非GUID的有效变更暂存，避免误改
git add -G '[^{}A-F0-9-]{36}' .
# 把剩下的纯GUID变更全部还原为仓库版本
git restore .
# 恢复暂存的有效变更
git restore --staged .

注意：执行前建议备份一次工作区文件，避免特殊格式的有效代码被误还原。

方案3：提交环节自动过滤GUID变更 #

如果需要从提交层面彻底避免动态生成的GUID被误提交，可以搭配Git的clean/smudge过滤器，在文件提交到暂存区时自动对齐仓库内已有的GUID值：

• 在.git/config中添加过滤器配置：

[filter "keeprepo-guid"]
    clean = "grep -oE '\\{[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12}\\}' %f | head -n1 | xargs -I {} sed -E 's/\\{[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12}\\}/{}/g'
    smudge = cat

• 在.gitattributes中给对应文件绑定过滤器：

*.pas filter=keeprepo-guid

配置后本地生成的动态GUID不会被提交到仓库，只会保留仓库中已存的GUID值，从根源避免这类无效变更产生。

内容的提问来源于stack exchange，提问作者Deeem2031