我正在编写我们公司 Delphi 编程的编码标准,想请问大家有什么建议可以作为基础,有什么推荐使用或不使用的东西?
我以Delphi语言编码规范文档为内部文档的基础。
Object Pascal风格指南可能可以被称为“官方”指南,我认为 - 就这样而言。
不要过于强制标准化。你可能会想要收集一些最有经验的程序员的样例,让他们达成一致,并将其作为所有人的模板。
Jeff Atwood 最近在博客中谈到了关于标准的一个方面:"消灭空格异教徒!" 他在其中说:
"选择哪种编码风格实际上并不重要。重要的是你和团队中的每个人都坚持这些约定,并始终如一地使用它们。"
编码规范是一个经典的自行车棚话题。人们争论和争吵这些东西,因为它比良好的设计小得多,最终也不那么重要。清晰易读的代码值得拥有,而清晰易读但设计不良的代码与难以阅读的设计不良的代码几乎没有什么区别。也许最易读的糟糕代码使得更容易发现需要丢弃的问题。
鼓励团队成员贡献清晰易读的代码的努力可以包括推广样式指南。对于使用错误样式的人反复抨击的样式指南审查是适得其反的。如果有人在使用可接受的样式方面遇到困难,请向他们介绍使用一些工具的乐趣。不要让高素质的程序员在非常微小的问题上承受过多的批评压力。