reusability - 开发一次性代码的好策略？

Question

我经常编写一次性代码(在 research environment 中) - 例如探索科学属性或过程的算法或模型。许多这些“实验”是一次性的，但有时我发现我需要稍后使用。例如，我刚刚发现了我 7 年前编写的字符串匹配代码(由于其他优先事项而停止)，但现在对同事的项目很有值(value)。看过之后(我真的写了这么难懂的代码吗？)我意识到当我重新启动“项目”时，我可以做一些事情来帮助我(“实验”仍然是一个更好的词)。早期的实验“有效”，但我知道当时我没有时间重构，因为我的优先事项在别处。

在使这些工作能够被挖掘和重新使用方面，哪些方法具有成本效益？

编辑 :我已经回答了我自己的问题(如下)，因为存在超出实际来源本身的问题。

Answer 1

我不同意所有说“写评论”的答案。这是作为代码本身无法理解的包罗万象提供的。

给自己一份 Code Complete (史蒂夫·麦康奈尔，第 2 版)。如果你一开始就学会了编写可维护代码的技巧，它不会花费你更多的时间，而且你以后可以轻松地回到你的工作中去。

你更喜欢哪个:

带有注释的加密代码？

大部分OK代码没有？

我非常喜欢后者，因为在未注释神秘代码的情况下，OK 代码更容易理解，而注释是原始开发人员可能犯错误的另一个地方。代码可能有问题，但永远不会错。

一旦您对 Code Complete 感到满意，我建议您使用 The Pragmatic Programmer ，因为它提供了稍微高级的软件开发建议。