改配置之前，先读一遍差异

先确定修改的边界

一份配置可能同时服务几个入口。动手之前，先看它由哪个进程加载，是否被其他文件引用，哪些参数影响当前要处理的问题。看懂一段文字，与确认它就是正在生效的配置，是两件需要分别完成的事。

把本次需要改变的字段写成一张小清单。它可以帮助自己检查范围，也让后来复核的人知道：哪些变化是有意为之，哪些变化需要重新解释。

让差异保持容易阅读

保留原有缩进和周围结构，只修改本次需要的内容，会让差异更容易看清。格式整理、变量改名和行为修改混在一起，往往会遮住真正值得审查的地方。

diff -u settings.before.yml settings.after.yml

• 修改是否只落在预定字段。
• 删除的值是否确实不再需要。
• 依赖这个配置的入口是否一并核对。
• 恢复原值时是否还有其他前提。

给恢复留下可执行的步骤

回退说明至少要交代备份在哪里、恢复哪些内容，以及恢复后如何验证。后来又发生过变化的文件，不宜直接用很早的一整份备份覆盖，应该先检查当前差异。

完成修改后，保存实际生效结果和验证记录。说明里既要有“改成了什么”，也要有“怎样知道它已经生效”，这样这次修改才不会只停留在一个成功退出的命令上。