【问题标题】:What Delphi coding standards document(s) do you follow? [closed]您遵循哪些 Delphi 编码标准文档? [关闭]
【发布时间】:2008-11-04 18:44:56
【问题描述】:

您遵循哪些 Delphi 编码标准文档?

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

NB:我确实想发起一场风格大战。我只是想知道你遵循什么标准,以及为什么。

谢谢。


更新:好吧,“JCL Delphi 语言风格指南”似乎是明显的赢家!谢谢!

【问题讨论】:

  • 所有这些格式化“标准”都是毫无意义的。尚未进行任何研究来证明一个比另一个更好......哦......你在哪里?

标签: delphi naming-conventions coding-style


【解决方案1】:

项目 JEDI Delphi 语言样式指南与 JCL 添加

(CodeGear 的“Object Pascal Style Guide”的扩展)

https://wiki.delphi-jedi.org/wiki/Project_JEDI_Delphi_Language_Style_Guide

(感谢 Jeroen Pluimers 和 AmigoJack 报告旧链接已失效。 如果这个最新的链接也失效了,here's its Internet Archive link,很好的衡量标准。)

【讨论】:

【解决方案2】:

CodeGear 的“Object Pascal 风格指南”

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

【讨论】:

    【解决方案3】:

    Econos – 编码标准文档

    (副标题为“Delphi 4 开发人员指南编码标准文档”。)

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

    【讨论】:

    【解决方案4】:

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

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

    【讨论】:

    • 链接断开。找不到原版。
    • 谢谢,@Peter Rader。链接更改为使用 Wayback Machine。
    【解决方案5】:

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

    也就是说,为什么不选择与您的运行时库 (VCL) 和文档使用相同的标准呢?然后你们都会说同一种方言,阅读运行时库代码会更容易。并且有大量的代码示例来说明编码约定。

    【讨论】:

    • 这是一个很好的观点,我很感激你的所作所为。谢谢!也就是说,我们希望选择一个倾向于“完整”方面的标准,因此 VCL 文档可能不是最好的。
    • 我个人的看法是少即是多,归根结底,您可以在标准文档中捕获的规则对于可维护性而言远不如程序员的态度和经验重要。
    【解决方案6】:

    可能存在过度设计编码标准的趋势,以至于它们妨碍了编写代码。

    我同意 Jozz 的评论。您可以查看所有推荐的标准,选择一个并将其强加给您的编码人员,或者您可以让您的团队参与该过程。

    根据我的经验,让团队参与的最佳方式是让团队提出想法和采用的好处。你现有的才能是你最好的资源。同样,如果你强迫他们走上他们不接受的道路,他们可能会成为你的终极敌人。

    因此,请查看您现有的编码变体,并让团队一起就以下方面进行一些充满活力的讨论:

    • 采用编码标准的原因。
    • 标准化的基本考虑。
    • 解决团队中围绕此问题的任何不安全感。
    • 找到一个一致点。什么重要,什么不重要。
    • 制定一些公司目标,让每个人都觉得他们正在朝着一个共同的目标努力。
    • 让团队向自己推销标准化的好处。

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

    【讨论】:

      【解决方案7】:

      由于某些荒谬的历史原因,我工作的编码标准是在 delphi 和 sql 中将所有关键字都设为大写。感谢上帝的大写锁定。

      【讨论】:

        【解决方案8】:

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

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

        【讨论】:

          猜你喜欢
          • 2010-10-06
          • 2010-09-21
          • 2011-08-04
          • 1970-01-01
          • 1970-01-01
          • 1970-01-01
          • 2011-06-02
          • 2013-01-04
          • 2011-05-01
          相关资源
          最近更新 更多