如何配置Git：git diff显示Vault加密文件明文，git add --patch按二进制处理

可以实现这个需求，核心是让Git针对不同操作对Vault加密文件采用差异化处理逻辑——git diff调用解密工具展示明文差异，git add --patch则将文件视为二进制不拆分片段。具体配置如下：

1. 调整.gitattributes文件 #

在仓库根目录的.gitattributes中添加/修改如下配置：

**/vault.yml diff=ansible-vault merge=binary binary

• diff=ansible-vault：指定git diff使用自定义的文本转换器处理该文件
• merge=binary：避免合并时尝试解析加密内容，防止冲突混乱
• binary：强制Git在暂存操作（包括add --patch）中把文件当作二进制处理，跳过差异拆分

2. 配置Git文本转换器 #

在仓库级或全局Git配置中设置解密工具：

# 仓库级配置（仅当前仓库生效）
git config --local diff.ansible-vault.textconv "ansible-vault view"

# 全局配置（所有仓库生效）
git config --global diff.ansible-vault.textconv "ansible-vault view"

这个配置会让git diff自动调用ansible-vault view解密文件，展示明文差异。

3. 验证效果 #

• 执行git diff：会输出加密文件的明文差异内容
• 执行git add --patch：Git会提示该文件是二进制文件，仅提供"暂存整个文件"或"跳过"的选项，不会尝试拆分差异片段

原理说明 #

Git的binary属性会优先影响暂存相关操作的文件类型判断，而diff=xxx属性仅针对差异展示生效，两者可以共存。这样既满足了add --patch不拆分加密文件的需求，又保留了git diff查看明文差异的便利性。

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