记录编程、配置管理与文档工具中的实用方法。用小例子说明思路，也留下适用条件和容易踩到的坑。
把计算逻辑与文件、设备操作分开
当读取文件、计算结果与写入输出挤在一个函数里，排查问题就会变难。把计算过程先拆出来，往往能让程序更容易理解和测试。
随机种子与可复现的运行记录
固定随机种子是复现随机过程的起点。算法、调用顺序、输入和软件环境同样会影响结果，值得一起记录。
文件保存中的临时文件、校验与安全提交
文件存在，不代表写入已经完成。把输出分成临时写入、内容校验和正式提交，可以让失败更容易识别和恢复。
用 Markdown 与模板分离内容和排版
当文档需要反复修改或输出多种格式时，把正文结构与视觉样式分开，可以减少重复排版，也更方便检查修改。
用 YAML 管理程序参数
配置文件能把经常变化的参数集中起来。真正让它可靠的，是清楚的字段含义、启动时校验，以及对最终生效配置的记录。
用最小示例定位程序问题
面对一个复杂程序的报错，先保留能够触发问题的最少输入和步骤。一个可以重复运行的小例子，往往比大量猜测更有帮助。