Delphi编码规范

6

我正在编写我们公司 Delphi 编程的编码标准,想请问大家有什么建议可以作为基础,有什么推荐使用或不使用的东西?

3个回答

19

我已经查看了这两个文档,它们的格式都很糟糕,并且与 Delphi 2009 不兼容。我不想强制执行“样式”,只是要在一组规则内操作。 - mmmm

18

不要过于强制标准化。你可能会想要收集一些最有经验的程序员的样例,让他们达成一致,并将其作为所有人的模板。

Jeff Atwood 最近在博客中谈到了关于标准的一个方面:"消灭空格异教徒!" 他在其中说:

"选择哪种编码风格实际上并不重要。重要的是你和团队中的每个人都坚持这些约定,并始终如一地使用它们。"


1
嗯,我同意,但我不认为这回答了问题。 - Erick Sasse
3
我非常讨厌“惯例战争”,即代码库的一半使用一种惯例,而另一半则使用完全相反的惯例,特别是当这其中的一半与VCL源代码相矛盾时,因为现在所有Delphi源代码的惯用法都是从VCL源代码中演变出来的。请注意,我已经尽力使翻译保持原意,并更易懂,但不影响原意。 - Warren P
选择哪种编码风格并不重要,重要的是你和团队中的每个人都要坚持这些约定,并始终如一地使用它们。我不同意这一点 - 除非该风格与VCL和第三方组件源代码非常相似。更改类字段的“F”前缀是愚蠢的 - 它是无处不在的。 "I"和本地循环迭代器也是如此 - 这在大多数语言中都可以看到。在我看来,更改这些是疯狂的。 - Michael Vincent

1

编码规范是一个经典的自行车棚话题。人们争论和争吵这些东西,因为它比良好的设计小得多,最终也不那么重要。清晰易读的代码值得拥有,而清晰易读但设计不良的代码与难以阅读的设计不良的代码几乎没有什么区别。也许最易读的糟糕代码使得更容易发现需要丢弃的问题。

鼓励团队成员贡献清晰易读的代码的努力可以包括推广样式指南。对于使用错误样式的人反复抨击的样式指南审查是适得其反的。如果有人在使用可接受的样式方面遇到困难,请向他们介绍使用一些工具的乐趣。不要让高素质的程序员在非常微小的问题上承受过多的批评压力。


网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接