coding-style - 一个好的程序员的代码是什么样的？

Question

就目前情况而言，这个问题不太适合我们的问答形式。我们希望答案得到事实、引用资料或专业知识的支持，但这个问题可能会引发辩论、争论、民意调查或扩展讨论。如果您觉得这个问题可以改进并可能重新开放， visit the help center以获得指导。

已关闭 10 年前。

已锁定。这个问题及其答案是 locked因为这个问题是题外话，但却具有历史意义。目前不接受新的答案或互动。

我是一名业余程序员(从 VBA 开始是为了让 Excel 更快)，一直在使用 VB.NET/C#.NET，并正在尝试学习 ADO.NET。

编程中一直让我感到沮丧的一个方面是“好”是什么样的？我不是专业人士，所以没有什么可以比较的。是什么造就了更好的程序员？是吗:

• 他们更了解所有对象/类/方法用给定的语言？
• 他们的程序效率更高？
• 他们的程序设计很多就更好而言更好文档，良好的名称选择用于函数等？

换句话说，如果我查看专业程序员的代码，相对于我的代码，我首先注意到的是什么？例如，我阅读了 Wrox 出版社的《Professional ASP.NET》等书籍。那本书中的代码示例是“世界级的”吗？这就是巅峰吗？任何顶级程序员都会看到该代码并认为它​​是好代码吗？

Answer 1

下面的列表并不全面，但这些是我在考虑您的问题时想到的事情。

• 好的代码是组织良好的。类中的数据和操作结合在一起。类之间不存在无关的依赖关系。它看起来不像“意大利面条”。

• 好的代码注释解释了为什么要做事情而不是做了什么。代码本身解释了所做的事情。对评论的需求应该是最少的。

• 好的代码对除了最短暂的对象之外的所有对象都使用有意义的命名约定。某物的名称可以提供有关何时以及如何使用该对象的信息。

• 好的代码是经过充分测试的。测试充当代码的可执行规范及其使用示例。

• 好的代码并不“聪明”。它以简单、明显的方式做事。

• 好的代码是用小的、易于阅读的计算单元开发的。这些单元在整个代码中重复使用。

我还没读过，但我打算读的关于这个主题的书是Clean Code作者:罗伯特·C·马丁。