Skip to Content
Python4 结语

4 结语

保持一致

如果你正在编辑代码,花几分钟看看周围的代码并确定其风格。如果他们在索引变量名中使用 _idx 后缀,你也应该这样做。如果他们的注释周围有小方框的井号标记,你的注释也应该有小方框的井号标记。

拥有风格指南的目的是有一个共同的编码词汇表,这样人们可以专注于你说什么,而不是你怎么说。我们在这里提出全局风格规则,以便人们知道这个词汇表,但局部风格也很重要。如果你添加到文件中的代码看起来与周围的现有代码截然不同,当读者去阅读时会打断他们的节奏。

然而,一致性也有其限制。它更多地适用于局部以及全局风格未指定的选择。不应以一致性为借口继续使用旧风格,而忽视新风格的优势,也不应忽略代码库随时间逐步向更新风格收敛的趋势。

Last updated on