结构差异导出需确保可追溯性：用--label标注文件路径与版本，LC_ALL=C避免locale异常，JSON/YAML等须先标准化格式（如jq -S或yq -P）再diff，输出文件名含哈希前缀，并确认未被.gitignore忽略。
导出结构差异分析结果为纯文本时，diff 命令默认输出不够稳定
直接用 diff -u a.json b.json 看差异没问题，但导出作备份或比对用时，行首的 +/- 和空格缩进容易被编辑器误处理，且不带文件路径和时间戳，后续回溯困难。
实操建议：
- 加
--label显式声明输入源：diff -u --label "before:config-v1.json" --label "after:config-v2.json" a.json b.json > diff.txt - 用
LC_ALL=C避免 locale 导致的排序/换行异常：LC_ALL=C diff -u ... - 若对比的是嵌套结构（如 JSON/YAML），先用
jq -S .或yq eval '... | sort_keys' -标准化格式再 diff，否则字段顺序不同也会触发大量假差异
Python 脚本导出结构差异时，json.dumps 的 sort_keys 和 indent 必须一致
用 Python 读取两个 JSON 文件再用 json.dumps 输出差异，看似灵活，但若两边 indent=2 而一边没设 sort_keys=True，字段顺序不同会导致整块内容被标为“变更”，实际结构没变。
常见错误现象：两个完全相同的 JSON 对象，因 key 顺序不同，json.dumps 输出后逐行 diff 显示几十行变动。
实操建议：
- 统一加载后用
json.loads(..., object_hook=OrderedDict)不够可靠，直接用json.dumps(data, sort_keys=True, indent=2)生成中间文本再比对 - 避免在 dumps 中混用
separators（如(',', ':')），它会压缩空格，与带缩进的版本无法对齐 - 导出文件名建议含哈希前缀：
f"diff_{hashlib.md5(open('a.json').read().encode()).hexdigest()[:6]}_to_{...}.txt"，方便快速识别原始快照
对比 YAML/INI/TOML 等非 JSON 结构时，diff 直接跑会漏掉语义等价但语法不同的写法
比如 YAML 中 enabled: true 和 enabled: True 是等价的，但原始文本 diff 会标为变更；TOML 里 [section] 和 [[array]] 的嵌套层级也容易因换行位置不同被放大差异。
使用场景：配置灰度发布前后对比、CI 流水线中校验模板渲染结果。
实操建议：
- YAML 用
yq e -P（-P即--prettyPrint）先转成标准格式再 diff：yq e -P a.yaml | diff -u - - INI 用
python3 -m configparser加载后转 dict 再序列化为统一格式（注意：原生 configparser 不保留注释，仅用于结构校验） - 不要依赖文件扩展名判断格式——
config.yaml文件里可能混了 JSON 片段，先用file config.yaml或head -n1 config.yaml确认真实类型
备份纯文本差异文件时，git add 前要检查是否含敏感路径或临时值
导出的 diff.txt 若包含绝对路径（如 /home/alice/project/conf/db.json）或调试时填的临时 token，直接提交到仓库就泄露了。
性能影响：大结构体（如 10MB+ 的 Kubernetes 清单）生成的 diff 文本可达数 MB，git add 本身不慢，但后续 git status 会变卡，尤其在 Windows 上。
实操建议：
- 导出前用
sed或perl -pe替换敏感路径：sed 's|/home/[^/]*/|/home/USER/|g' diff.txt > diff_clean.txt - 用
git check-ignore确保目标文件不在.gitignore里——有时误配导致 diff 文件根本没被跟踪，以为存了其实丢了 - 如果只是临时比对，别建新文件，用
diff ... | tee /tmp/latest-diff.txt，配合ls -lt /tmp/latest-*.txt手动清理更可控
事情说清了就结束。结构差异导出最麻烦的不是怎么生成，而是怎么让下一次回看时能立刻确认：这是哪两个东西比的、谁是基准、有没有被人工改过。路径、时间、格式标准化，这三个点漏一个，半年后你自己都得重跑一遍。
