1. 程式人生 > >智慧合約最佳實踐 之 Solidity 編碼規範

智慧合約最佳實踐 之 Solidity 編碼規範

匯新雲】為大家定期更新文章,【匯新雲】IT人的產業鏈平臺

每一門語言都有其相應的編碼規範, Solidity 也一樣, 下面官方推薦的規範及我的總結,供大家參考,希望可以幫助大家寫出更好規範的智慧合約。

命名規範

避免使用

小寫的l,大寫的I,大寫的O 應該避免在命名中單獨出現,因為很容易產生混淆。

合約、庫、事件、列舉及結構體命名

合約、庫、事件及結構體命名應該使用單詞首字母大寫的方式,這個方式也稱為:帕斯卡命名法或大駝峰式命名法,比如:SimpleToken, SmartBank, CertificateHashRepository,Player。

函式、引數、變數及修飾器

函式、引數、變數及修飾器應該使用首單詞小寫後面單詞大寫的方式,這個方式也稱為:(小)駝峰式命名法,是一種混合大小寫的方式,如:

函式名應該如:getBalance,transfer,verifyOwner,addMember。

引數和變數應該如:initialSupply,senderAddress,account,isPreSale。

修飾器應該如:onlyAfter,onlyOwner。

程式碼格式相關

縮排

使用空格(spaces)而不是Tab, 縮排應該是4個空格

空行

合約之間應該有空行,例如:


而不是使用:


。函式之間應該有空行,例如:


沒有實現的話,空行可以省去,如:


而不是:


左括號應該跟定義在一行

定義包括合約定義、函式定義、庫定義、結構體定義等等,例如推薦使用:


而不是:


左括號應該跟條件控制在一行

在使用if, else, while, for 時,推薦的寫法是:


而不是:


如果控制語句內只有一行,括號可省略,如:


但像下面一個語句有多方就不能省略,如:


表示式內的空格

。一個單行的表達裡,在小括號、中括號、大括號裡應該避免不必要的空格,例如推薦使用:


而不是:


有一種例外是,結尾的括號跟在結束的分號後面, 應該加一個空格,如下面的方式也是推薦的:


分號;前不應該有空格,例如推薦使用:


而不是:


不要為對齊新增不必要的空格,例如推薦使用:


而不是:


。回退函式不應該有空格,例如推薦使用:


控制每一行長度

每行不應該太長,最好在79(或99)個字元以內,函式的引數應該是單獨的行,且只有一個縮排,例如推薦的方式是:


而不是:


對應的賦值語句應該是這樣寫:


而不是:


事件定義也應該遵循同樣的原則,例如應該使用:


而不是:


檔案編碼格式

推薦使用utf-8 及 ASCII 編碼

引入檔案應該在最上方

建議使用:


而不是:


函式編寫規範

函式的順序

在編寫函式的時候,應該讓大家容易找到建構函式,回退函式,官方推薦的的函式順序是:

建構函式

回退函式 (如果有)

外部函式(external)

公有函式(public)

內部函式(internal)

私有函式(private)

同一類函式時,constant函式放在後面, 例如推薦方式為:


而不是下面的函式順序:


明確函式的可見性

所有的函式(包括建構函式)應該在定義的時候明確函式的可見性,例如應該使用:


而不是


可見性應該在修飾符前面

函式的可見性應該寫在自定義的函式修飾符前面,例如:


而不是


區分函式和事件

為了防止函式和事件(Event)產生混淆,宣告一個事件使用大寫並加入字首(可使用LOG)。對於函式, 始終以小寫字母開頭,建構函式除外。


常量

常量應該使用全大寫及下劃線分割大詞的方式,如:MAX_BLOCKS,TOKEN_NAME, CONTRACT_VERSION。

參考文獻

學好區塊鏈,擁抱新未來:

區塊鏈產品經理(點選入駐),和圈內人士混個臉熟