尝试新工具时,最容易留下的是截图和一句“效果不错”。等到想再次复现,却可能已经忘了当时的输入和设置。实验笔记不必很长,但需要保留足够的上下文。
一份轻量的记录模板
问题:这次想验证什么?
假设:预期会发生什么,为什么?
条件:日期、工具版本、参数和输入样本。
步骤:按顺序写下关键操作。
观察:实际发生了什么?保留原始输出。
局限:样本、环境或判断方式有哪些限制?
下一步:还需要修改或验证什么?把观察和解释分开
“三次运行中有一次超时”是观察;“可能是网络波动”是解释。先把事实写清楚,再补上自己的判断,之后排查问题时才不会被早期猜测带偏。
没有达到预期,也值得记录
如果实验失败,记录失败时的条件和报错。如果暂时没有答案,就写下仍然不确定的部分。笔记的作用不是证明每次尝试都成功,而是减少下一次从头摸索的成本。
这里的模板适用于个人学习和小规模工具试验,不代表一套完整的科学研究方法。
记录是探索的一部分。只要能帮助未来的自己理解当时发生了什么,这份笔记就有意义。