一 格式化
使用gofmt程式對go原始碼進行格式化，以便統一編碼風格,可直接在GoLand進行配置[1]，Go原始碼格式使用tab作為縮進，且很少使用括號，
二 注釋
Go支持塊注釋/**/和行注釋//,行注釋更常用，塊注釋主要用于包注釋和大塊代碼禁用，godoc[2]支持從注釋中提取檔案,每個包和可匯出的名稱(大寫)都應該提供注釋，包注釋對包整體進行介紹，并提供相關的資訊，模版示例如圖2.1：
圖2.1 包注釋
檔案注釋應該是一個以宣告的名稱開始的完整的句子,如圖2.2：
圖2.2 檔案注釋
go支持變數成組宣告,對于一組相關的變數或常量,檔案注釋應該給出籠統的介紹,如圖2.3:
圖2.3 相關常量注釋
三 命名
3.1 包名
包應以單個小寫單詞命名,且不該使用下劃線和駝峰記法，
包名應是原始碼目錄的基本名稱,例如: 在 src/pkg/encoding/base64 中的包應作為 "encoding/base64" 匯入，其包名應為 base64
3.2 Getters
獲取器名字中無需加入Get,例如owner欄位的獲取方法為Owner(),設定器為SetOwner(),如圖3.1：
圖3.1 Getters
3.3 介面名
只包含一個方法的介面,介面名應為方法名加類似er后綴的名詞，比如Reader, Writer, Formatter, CloseNotifier，
Read、Write、Close、Flush、 String等具有典型簽名和意義的方法,除非明確方法名稱和這些典型的方法具有相同的簽名和含義，否則不要用這些名稱(具有相同簽名和意義時要用這些名稱)，
3.4 駝峰記法
Go約定命名使用駝峰記法MixedCaps 或 mixedCaps，
四 分號
Go詞法分析會在原始碼中插入分號,插入分號規則如下:
若在新行前的最后一個標記為識別符號（包括 int 和 float64 這類的單詞）、數值、字串常量或break continue fallthrough return ++ -- ) }等標記之一(如果新行前的標記為陳述句的末尾，則插入分號)，
控制結構左大括號不應放在下一行,會導致在大括號前面加分號，
圖4.1 控制結構錯誤示例
五 控制結構
Go與C控制結構不同之處:Go回圈只有for陳述句;if和switch可像for回圈接受可選的初始化陳述句;包含型別選擇和多路通信復用器結構:select;語法上,沒有圓括號，而其主體必須始終使用大括號括住，
5.1 重新宣告與再次賦值
經常發現變數err會多次:=宣告，其本質是再次賦值, 在滿足下列條件時，已被宣告的變數 v 可出現在:= 宣告中:
1. 本次宣告與已宣告的 v 處于同一作用域中(若 v 已在外層作用域中宣告過，則此次宣告會創建一個新的變數)，
2. 在初始化中與其型別相應的值才能賦予 v，且在此次宣告中至少另有一個變數是新宣告的，
5.2 switch
若switch后無運算式,它將自動匹配true執行,因此可以將if-else-if-else鏈寫成switch的方式,如圖5.1所示，
圖5.1 無運算式switch
case可通過逗號分隔列舉相同的處理條件，如圖5.2:
圖5.2 相同處理case
可使用break提前終止switch,當switch處在回圈中，可通過break加標簽的方式跳出外層回圈，
5.3 型別選擇
switch可用于判斷介面變數的動態型別,如圖5.3，
圖5.3 動態型別判斷
六 函式
6.1 可命名結果引數
Go回傳值可命名，函式呼叫時，自動初始化為零值,直接用return不帶變數，則結果形參的當前值會回傳，
6.2 defer
defer會推遲執行函式,到呼叫defer的函式回傳前立即執行,常用于資源釋放，被推遲函式的實參在呼叫時確定,而不是執行時,defer函式的執行遵循LIFO，
七 資料
7.1 new分配
new(T)分配置零記憶體空間，并回傳指標*T，
7.2 建構式和復合字面
new(T)創建的物件,欄位只有零值,沒有初始化,可以new(T)后,給T的欄位賦值,但更簡潔的方法是使用復合字面來簡化,例如:return &File{fd, name, nil, 0},復合字面的欄位必須按順序全部列出, 以欄位:值對的形式明確地標出元素，初始化欄位時就可以按任何順序出現，未給出的欄位值將賦予零值,例如:return &File{fd: fd, name: name}，
7.3 make分配
make只用于創建切片、map和通道,并回傳型別為 T（而非 *T）的一個已初始化 （而非置零）的值，這三種型別本質上是參考型別,使用之前必須初始化,例如: 切片是一個具有三項內容的描述符，包含一個指向（陣列內部）資料的指標、長度以及容量， 在這三項被初始化之前，該切片為 nil，因此創建slice的習慣用法為:v := make([]int, 100)
7.4 陣列
與C不同:
1. 陣列是值，將一個陣列賦予另一個陣列會復制其所有元素，若將某個陣列傳入某個函式，將接收到該陣列的一份副本而非指標，
2. 陣列的大小是其型別的一部分，型別 [10]int 和 [20]int 不同，
7.5 map
訪問map中不存在的key時,回傳value對應型別的零值,若要區分某項是零值還是真的不存在,可用seconds, ok = timeZone[tz]的形式，洗掉某項,可用delete(timeZone,tz),即使key不存在也不會報錯，
7.6 變長引數
內置函式append的簽名如下,因為不支持動態引數型別(范型),因此append函式需要編譯器支持，
func append(slice []T, 元素 ...T) []T
要將一個切片的元素添加到另一切片中,用法如7.1:
圖7.1 …用法
八 初始化
8.1 常量
列舉常量可用iota列舉器創建,如圖8.1:
圖8.1 iota列舉器
8.2 init函式
每個源檔案都可以定義無參和回傳值的init函式,用于設定初始化狀態，或進行一些檢查,init函式會被自動呼叫，初始化順序為匯入包初始化,本包變數初始化器初始化,呼叫init函式，
九 方法
9.1 指標和值
值方法可通過指標和值呼叫,而指標方法只能通過指標來呼叫；指標方法可以修改接收者，通過值呼叫它們會導致方法接收到該值的副本，任何修改都將被丟棄，
要修改接受者時用指標,如圖9.1:
圖9.1 指標方法
十 介面和其它型別
10.1 介面轉換和型別判斷
fmt.Printf型別選擇簡化版代碼如圖10.1:
圖10.1 型別選擇
單個型別判斷如圖10.2:
圖10.2 型別判斷
10.2 通用性(多型)
對于只實作了介面中的方法，無其它匯出方法的型別，可通過方法回傳介面實體，而無需關注實體的具體型別，類似面向物件中多型的思想，
十一 空白識別符號
11.1 未使用的匯入和變數
對于暫未使用的匯入和變數,可用空白標志符防止編譯報錯，如圖11.1:
圖11.1 防止編譯報錯
11.2 副作用匯入
例如需要匯入包執行init初始化函式,但并不使用包，
圖11.2 副作用匯入
十二 嵌入
go沒有子類的概念,但能通過內嵌的方式實作類似的功能(聚合轉發的方式)，介面內嵌如下圖12.1,ReadWriter介面會擁有Reader和Writer介面中的方法，
圖12.1 介面內嵌
結構體內嵌如圖12.2,Job會擁有Logger的所有方法，Job內實際上會擁有一個名稱為Logger的變數,Logger型別的方法都會轉發給Logger變數，
圖12.2 結構體內嵌
可以自己初始化Logger欄位,如圖12.3,同時可以直接Job.Logger訪問內嵌Logger欄位，
圖12.3 內嵌變數初始化
十三 錯誤
13.1 自定義錯誤型別
錯誤的介面內置型別為error,如圖13.1:
圖13.1 error介面
程式可以實作自己的錯誤型別,如圖13.2,錯誤字串應盡可能包含錯誤來源,比如包名前綴等，
圖13.2 自定義錯誤型別
13.2 panic&recover
當程式產生不可恢復錯誤時,可使用panic,產生運行時錯誤,從而使協程退出，panic會終止函式繼續運行,并回溯go協程堆疊,執行被defer的函式，
內建的 recover 函式可重新獲取Go協程的控制權限并使其恢復正常執行，如圖13.3:
圖13.3 recover處理
參考文獻
[1] 使用gofmt格式化代碼.
[2] Mac下安裝godoc.
[3] Effective Go.
[4] Effective Go翻譯版.
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/33516.html
標籤：Go