赠言

请与周围保持一致。

如果你正在编辑代码,花几分钟时间看看上下文代码的格式,确定他们的编码风格。如果在上下文代码中,算术运算符前后有空格,或注释前后添加了“#”,你也应该这样做。

编写这个风格指导的目标是让人们可以专注于“我们在讨论什么”而不是“我们该怎么描述”。我们提供了一些通用的编码规范,大家就可以基于这些规范而继续,但特定情况下的规范也同样重要。如果你在一个文件中添加的代码看上去跟其他代码明显不同,你就把阅读此文件的人的节奏打乱了。避免这种情况出现。