智慧合約最佳實踐 之 Solidity 編碼規範
每一門語言都有其相應的編碼規範, 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。
參考文獻
學好區塊鏈,擁抱新未來:
區塊鏈產品經理(點選入駐),和圈內人士混個臉熟。