您关注的德尔福编码标准文件是什么？

Question

您遵循什么德尔福编码标准文件？

我们公司正在考虑制定更好的编码标准，以提高代码的可读性，可审查性和可维护性。我们遇到过CodeGear的“Object Pascal样式指南”，但它在很长一段时间内都没有被触及，我想很多人都做了一些本地的改进或补充。我在下面列出了一些已发布的变体和其他文档。

注意：我不想要开始一场风格大战。我只想知道你遵循的标准，以及原因。

感谢。

<小时/> 更新：好吧，“JCL德尔福语言风格指南”似乎是明显的赢家！谢谢！

Answer 1

JCL Delphi语言风格指南

（CodeGear的“Object Pascal样式指南”的扩展）

http://jcl.delphi-jedi.org/documents/styleguide.html

（谢谢，Jeroen Pluimers，注意到原来的borland.com链接已经死亡并且提供了新的链接。）

Answer 2

CodeGear的“对象Pascal风格指南”

http://edn.embarcadero.com/article/10280

Answer 3

CodeGear的“Object Pascal样式指南”的JVCL扩展版

（对我来说，这看起来就像JCL版本。）

http://jvcl.delphi-jedi.org/StyleGuide.htm

（感谢Jeroen Pluimers，提供新链接。）

Answer 4

经济 - 编码标准文件

（字幕“Delphi 4开发人员指南编码标准文件”。）

http://www.econos.de/delphi/cs.html

Answer 5

About.com的“Delphi标识符命名约定”

http://delphi.about.com/od/standards/l/bldnc.htm (via Wayback Machine)

Answer 6

只要你选一个并坚持下去就没关系。编码标准就像一种方言，只要团队中的每个人都说同一种方言，你就可以了。

那说，为什么不选择与运行时库（VCL）和文档使用相同的标准？然后你们都会说同一个方言，你将更容易阅读运行时库代码。并且有大量代码示例来说明编码约定。

Answer 7

可能存在将编码标准过度设计到妨碍编写代码的程度的倾向。

我同意Jozz的评论。您可以查看所有建议的标准，选择一个并强制给您的编码人员，或者让您的团队参与该过程。

根据我的经验，让团队参与的最佳方式是让团队提出想法和采用的好处。您现有的人才是您最好的资源。同样地，如果你强迫他们沿着他们不买的路走下去，他们可能是你的最终敌人。

因此，请查看您现有的编码变体，并让团队一起进行一些充满活力的讨论：

• 采用编码标准的原因。
• 标准化中的基本考虑因素。
• 解决围绕此问题的团队中的任何不安全感。
• 找到一致意见。什么是重要的，什么不是。
• 建立一些企业目标，让每个人都感觉他们正朝着共同的目标努力。
• 让团队向自己出售标准化的好处。

最重要的目标必须是建立一个最适合您的团队和公司的“标准”。

Answer 8

对于一些无聊的历史原因，我工作的编码标准是将所有关键字都用大写，包括delphi和sql。感谢上帝的大写锁定。

Answer 9

CodeGear的“匈牙利花生酱”，用于命名标识符

http://dn.codegear.com/article/27983