3、代码意图表达与有效沟通

代码意图表达与有效沟通

1. 代码意图清晰表达的重要性

在编程中，让代码清晰地表达意图至关重要。例如以下代码：

ingredient.adjust_propoprtion(Fraction(servings, recipe.servings))
return Recipe(servings, new_ingredients)

这段代码比之前有了很大改进，文档更完善，能清晰表达原始意图。从这段代码中，我们可以了解到以下几点：
- 使用了 Recipe 类，这有助于抽象某些操作。推测类内部有允许重复配料的不变量，这为函数行为提供了更明确的通用词汇。
- 份量现在是 Recipe 类的明确部分，而不是列表的第一个元素，避免了特殊处理，简化了调用代码，防止意外冲突。
- 很明显要清除旧食谱中的配料，不再有 .pop(0) 操作的模糊原因。
- 配料是一个单独的类，处理分数而非显式的浮点数，更清晰地表明在处理分数单位，并且可以轻松调用 limit_denominator() 等方法。

通过用类型替换变量，定义操作（如 clear_ingredients 、 adjust_proportion ），代码的行为对未来读者来说一目了然，实现了高效的异步通信。

2. 异步通信与同步通信

2.1 异步通信

异步通信意味