詳解Golang 推薦的命名規(guī)范
Golang 推薦的命名規(guī)范
很少見人總結(jié)一些命名規(guī)范，也可能是筆者孤陋寡聞， 作為一個兩年的golang 開發(fā)者， 我根據(jù)很多知名的項目，如 moby, kubernetess 等總結(jié)了一些常見的命名規(guī)范。 命名規(guī)范可以使得代碼更容易與閱讀， 更少的出現(xiàn)錯誤。
如有不同意見歡迎吐槽、討論。 項目地址
文件命名規(guī)范
由于文件跟包無任何關(guān)系， 而又避免windows大小寫的問題，所以推薦的明明規(guī)范如下： 文件名應(yīng)一律使用小寫， 不同單詞之間用下劃線分割, 命名應(yīng)盡可能地見名知意
常量命名規(guī)范
常量明明用 camelcase來命名示例如下
const todayNews = "Hello" // 如果超過了一個常量應(yīng)該用括號的方法來組織 const ( systemName = "What" sysVal = "dasdsada" )
變量命名規(guī)范
與常量命名方式一樣，變量也應(yīng)該使用駝峰的命名方式, 但注意盡量不與包名一致或者以包名開頭
var x string x := new(string)
函數(shù)命名規(guī)范
由于Golang的特殊性（用大小寫來控制函數(shù)的可見性），除特殊的性能測試與單元測試函數(shù)之外, 都應(yīng)該遵循如下原則
- 使用駝峰命名
- 如果包外不需要訪問請用小寫開頭的函數(shù)
- 如果需要暴露出去給包外訪問需要使用大寫開頭的函數(shù)名稱
一個典型的函數(shù)命名方法如下：
// 注釋一律使用雙斜線， 對象暴露的方法
func (*fileDao) AddFile(file *model.File) bool {
result := db.NewRecord(*file)
if result {
db.Create(file)
}
return result
}
// 不需要給包外訪問的函數(shù)如下
func removeCommaAndQuote(content string) string {
re, _ := regexp.Compile("[\\`\\,]+")
return strings.TrimSpace(re.ReplaceAllString(content, ""))
}
接口命名規(guī)范
接口命名也是要遵循駝峰方式命名， 可以用 type alias 來定義大寫開頭的type 給包外訪問
type helloWorld interface {
func Hello();
}
type SayHello helloWorld
Struct命名規(guī)范
與接口命名規(guī)范類似
receiver 命名規(guī)范
golang 中存在receiver 的概念 receiver 名稱應(yīng)該盡量保持一致， 避免this, super，等其他語言的一些語義關(guān)鍵字如下
type A struct{}
func (a *A) methodA() {
}
func (a *A) methodB() {
a.methodA()
}
注釋規(guī)范
注釋應(yīng)一律使用雙斜線
其他
格式化， 用tab不是空格， 可以與go fmt 兼容
以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
相關(guān)文章
Go語言中WaitGroup并發(fā)同步的實現(xiàn)
本文主要介紹了Go語言中WaitGroup并發(fā)同步的實現(xiàn),文中通過示例代碼介紹的非常詳細,對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2026-04-04
一文帶你了解Go語言標(biāo)準(zhǔn)庫math和rand的常用函數(shù)
這篇文章主要為大家詳細介紹了Go語言標(biāo)準(zhǔn)庫math和rand中的常用函數(shù)，文中的示例代碼講解詳細， 對我們學(xué)習(xí)Go語言有一定的幫助，感興趣的小伙伴可以了解一下2022-12-12
Go多線程中數(shù)據(jù)不一致問題的解決方案(sync鎖機制)
在Go語言的并發(fā)編程中,如何確保多個goroutine安全地訪問共享資源是一個關(guān)鍵問題,Go語言提供了sync包,其中包含了多種同步原語,用于解決并發(fā)編程中的同步問題,本文將詳細介紹sync包中的鎖機制,需要的朋友可以參考下2024-10-10
這篇文章主要介紹了線上golang grpc服務(wù)資源泄露問題排查,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-12-12
Golang Gorm實現(xiàn)自定義多態(tài)模型關(guān)聯(lián)查詢
GORM 是一個流行的開源 ORM (Object-Relational Mapping) 庫,專為 Go 語言設(shè)計,它簡化了與 SQL 數(shù)據(jù)庫的交互,GORM 封裝了數(shù)據(jù)庫操作,使得開發(fā)者能夠通過簡單的鏈?zhǔn)秸{(diào)用來執(zhí)行 CRUD,本文給大家介紹了Golang Gorm實現(xiàn)自定義多態(tài)模型關(guān)聯(lián)查詢,需要的朋友可以參考下2024-11-11
在Go實際開發(fā)中,并發(fā)安全是老生常談的事情,在并發(fā)下,goroutine之間的存在數(shù)據(jù)資源等方面的競爭,為了保證數(shù)據(jù)一致性、防止死鎖等問題的出現(xiàn),在并發(fā)中需要使用一些方式來實現(xiàn)并發(fā)控制,本文給大家總結(jié)了幾種實現(xiàn)方式,需要的朋友可以參考下2023-12-12
緩存在項目中使用應(yīng)該是非常頻繁的,提到緩存只要了解過?singleflight?,基本都會用于緩存實現(xiàn)的一部分吧,下面就跟隨小編一起來學(xué)習(xí)一下singleflight的使用吧2024-02-02
golang實現(xiàn)并發(fā)數(shù)控制的方法
下面小編就為大家分享一篇golang實現(xiàn)并發(fā)數(shù)控制的方法，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2017-12-12
簡潔的代碼對于創(chuàng)建可維護、可閱讀和高效的軟件至關(guān)重要,Go 是一種強調(diào)簡單和代碼整潔的語言,在本文中,我們將結(jié)合代碼示例,探討編寫簡潔 Go 代碼的最佳實踐,需要的朋友可以參考下2023-09-09
對于線上穩(wěn)定運行的服務(wù)來說,?可能會遇到?cpu、mem?利用率升高的問題，那我們就需要使用?pprof?工具來進行性能分析，所以本文就來和大家講講pprof的具體使用吧2023-05-05