· 全部指南
代码审查的Diff最佳实践
在代码审查时，合理使用text-diff工具可以快速定位修改点。建议在Git等版本控制系统外单独对比关键文件，特别是当变更涉及多文件混合修改时。注意空白字符（空格/制表符）和换行符差异可能造成的视觉干扰，Towalles的工具会明确标注这类非语义差异。
处理大型文件时，优先对比函数/类级别的变更而非整个文件。对于200行以上的diff结果，建议分块审查。浏览器本地运行的diff工具能保护代码隐私，特别适合敏感项目的审查场景。
JSON与环境变量对比技巧
使用json-diff比较API响应或配置文件时，注意键的排序差异可能产生大量伪变更。Towalles的json-diff会自动规范化键顺序，并支持忽略空值/null的对比配置。对于.env文件，env-diff工具会智能处理注释和空行，只显示实际生效的配置差异。
处理多层级JSON时，展开至特定深度能提升可读性。建议先对比顶层结构，再逐层下钻。环境变量对比要特别注意大小写敏感问题，开发/生产环境的差异往往隐藏在这些细节中。
LLM Prompt迭代的版本控制
Prompt调优是个迭代过程，prompt-diff能可视化各版本间的细微改动。将Prompt拆分为系统指令、用户示例等模块分别对比更高效。注意标点符号和换行符的变化可能显著影响模型输出，这些在标准文本diff中容易被忽略。
建议为每个Prompt版本添加变更注释，类似代码提交信息。浏览器本地处理确保敏感Prompt不泄露，这对包含业务逻辑的Prompt尤为重要。可建立标准模板库，减少重复内容的diff噪音。
常见误报与处理策略
时间戳、哈希值等动态内容总会触发diff告警。使用正则表达式过滤这些噪声，或在对比前预处理文件。JSON对比时可配置忽略特定路径（如$.meta.timestamp），文本diff支持排除含特定关键词的行。
相似但不等同的修改（如10px→12px）需要特别注意。建议开启并排对比模式，高亮数值差异。Towalles的diff工具提供颜色深浅区分变更程度，重大修改会更加醒目。
人看 diff，机器跑测试
并排 diff 帮助审阅者看清意图；黄金文件测试抓住回归。对生成的 API 客户端或 lockfile，不要只靠肉眼——把比较自动化。
控制噪声
分享到工单前先规范化顺序、忽略易变时间戳并脱敏密钥。噪声 diff 会训练大家盲目点「通过」。
工作流
- 产出规范 JSON/文本。
- 与上一版 fixture diff。
- 在 PR 中解释有意改动的块。
语义 diff
对 JSON，在键序无关时比较解析后的结构；对散文，优先词级 diff。按产物类型选工具。
二进制文件
只显示「binary files differ」的工具需要配合检查（大小、哈希）。不要在未理解意图时橡皮图章式通过 lockfile 变更。
高效审阅 diff
动生产前先写操作程序：输入、期望输出、负责人与回滚。Towalles 上的工具便于本地检查样例，不能替代变更控制。
前置条件
- 有代表失败案例的脱敏 fixture。
- 清楚谁是真相来源（应用、网关、CMS 或网络设备）。
- 能在非生产环境或用合成数据复现问题。
步骤
- 用 fixture 复现，记录精确命令或 UI 路径。
- 按需用格式化、哈希或解析工具与已知正确样例对照。
- 做最小修复；同一变更里避免顺手重构。
- 补充回归测试或清单项，避免下一任 on-call 重复踩坑。
- 更新 runbook：症状 → 检查 → 修复。
善后
观察 24–72 小时错误率与支持工单。若做过一次性数据修复，安排后续防止复发。工单里保留截图与哈希，不要留真实密钥。
反模式
- 把生产密钥贴到公开页面「只是看一下」。
- 上线却不写回滚说明。
- 把本地绿色演示当成多区域生产的证明。