naming-conventions - 什么是可读代码？命名变量时应遵循哪些最佳实践？

Question

你认为 x、y、z 是好的变量名吗？您将如何解释新程序员编写可读代码？

Answer 1

可读代码意味着注释、变量和函数命名的某种组合，使我能够阅读一次代码并理解它。如果我不得不多次阅读它，或者花时间研究复杂的循环或函数，那么它还有改进的余地。

文件和类顶部的良好摘要描述有助于为读者提供上下文和背景信息。

清晰的名称很重要。冗长的名称可以更轻松地编写具有更少注释的可读代码。

编写可读代码是一项需要花时间学习的技能。我个人喜欢过于冗长的名称，因为它们会创建自文档化代码。