2008-11-04 58 views
17

你遵循什麼Delphi編碼標準文件?你遵循哪些Delphi編碼標準文件?

我們公司正在考慮採取一些更好的編碼標準,以提高我們的代碼的可讀性,可審閱性和可維護性。我們遇到了CodeGear的「Object Pascal風格指南」,但它在很長一段時間裏還沒有被觸及,我想很多人已經做了一些本地的改進或補充。我遇到了一些發佈的變體和其他文檔,我將在下面列出。

注:我做不是想開始一場風格戰。我只想知道你遵循的是什麼標準,以及爲什麼。

謝謝。


更新:那麼,「JCL德爾福語言風格指南」似乎是明確的贏家!謝謝!

回答

17

JCL德爾福語言風格指南

http://jcl.delphi-jedi.org/documents/styleguide.html(CodeGear的「Object Pascal的風格指南」的擴展)

(感謝,吉榮Pluimers,用於察覺,原來borland.com鏈接已經死亡,用於提供新的鏈接。)

CodeGear的的
+0

大多數情況下,我遵循這個標準。我的例外是,當放下編輯組件時,我通常以ed爲前綴(不管它是編輯,備忘錄還是組合框)。對於我用btn加前綴的按鈕。 – skamradt 2008-11-04 20:34:52

+2

答案中的鏈接不再工作,但我認爲這是你的意思是:http://jcl.delphi-jedi.org/documents/styleguide.html,與此作爲一個很好的額外資源http:///jvcl.delphi-jedi.org/StyleGuide.htm – 2010-01-12 09:16:20

2

ECONOS - (副標題爲「德爾福4開發者指南編碼標準文件」)編碼標準文檔

​​

+0

啊,好老主人澤維爾帕切科,史蒂夫特謝拉和斯特凡霍夫邁斯特!我跟蹤了前兩個,但不知道斯特凡發生了什麼事。 – 2010-01-15 15:49:42

0

這其實並不重要,只要你選擇一個,並堅持下去。編碼標準就像一種方言,只要團隊中的每個人都說同一種方言,你就很好。

這就是說,爲什麼不選擇與運行時庫(VCL)和文檔使用相同的標準?那麼你將全部使用相同的方言,並且讀取運行時庫代碼將會更容易。有很多代碼示例來說明編碼約定。

0

可能存在一種傾向,即將編碼標準過度工程化,直到他們掌握編寫代碼的方式。

我同意Jozz的評論。您可以查看所有建議的標準,挑選一個標準並強制您的編碼人員參加,也可以讓您的團隊參與流程。

根據我的經驗,讓團隊參與的最佳方式是讓團隊想出採納的想法和好處。你現有的人才是你最好的資源。同樣,如果你強迫他們走上一條他們沒有買入的道路,他們可能會成爲你的最終敵人。

所以,看看你現有的編碼變異體和一起得到球隊的一些充滿活力的討論:

  • 的原因,採用編碼標準。
  • 標準化的基本考慮因素。
  • 解決圍繞此問題的團隊中的任何不安全感。
  • 尋找協議的要點。什麼是重要的,什麼不重要。
  • 建立一些企業目標,讓每個人都感覺他們正在朝着共同目標努力。
  • 讓團隊向自己出售標準化的好處。

最重要的目標必須是建立一個「標準」最適合您的團隊和你的公司。

0

對於一些愚蠢的歷史原因,我工作的編碼標準是在delphi和sql中都使用大寫的所有關鍵字。感謝上帝鎖定大寫字母。