让三个月后的自己能跑通今天的分析

3 分钟
让三个月后的自己能跑通今天的分析

配图:self-drawn illustration

投稿返修要求补一张图,我打开三个月前的分析目录,陷入了沉默:final_v2_REAL.ipynbfinal_v2_REAL_use_this.ipynb、一个叫 tmp 的文件夹里有四百个文件。图最后是补出来了,但多花的时间足够重写两遍。

从此我接受了:可复现的第一受益人是三个月后的自己。几个低成本的习惯,不值得写论文,但值得写下来。

数据只读,输出另走

原始数据目录设成只读,分析结果永远写进单独的 output/ 目录,按日期分层。这条铁律保证任何时刻都可以把整个分析删掉重跑,结果对得上才叫复现。

脚本能一键跑通

把「从原始数据到最终图」的整条链压进一条命令。跑不通的中间步骤要么修好,要么删掉——不再有「这个文件要先手动跑一下」的暗门。暗门只会在最赶时间的时候塌。

环境记一笔

不需要多讲究,一个导出的环境清单放在项目根目录,几秒钟的事。三个月后换机器或者库升级把接口改了,这几秒钟就是救命钱。

随手记决策

最重要的是最便宜的一条:分析过程中做的每个决定——为什么丢弃这个样本、阈值为什么定在这里——随手一行,记进项目里的一个纯文本。代码记录「做了什么」,这个文件记录「为什么」。

返修时最怕的不是重跑代码,是想不起来「当初为什么这么定」。决策有据可查,才能理直气壮地回复审稿人。

小结

这些都是笨办法,没有一步涉及什么高深工具。但组合起来有个奇妙的效果:三个月后的邮件到来时,从恐惧变成例行公事。

Suggest an edit

最后更新:30 Aug 2026