本教程操作環(huán)境：windows7系統(tǒng)、GO 1.18版本、Dell G3電腦。

特殊在于，Go 有些特性是其他語言有，他沒有的。最經(jīng)典的就是 N 位 Java 同學(xué)尋找 Go 語言的注解在哪里，總要解釋。

(資料圖)

為此，今天煎魚就帶大家了解一下 Go 語言的注解的使用和情況。

什么是注解

了解歷史

注解（Annotation）最早出現(xiàn)自何處，翻了一圈并沒有找到。但可以明確，在注解的使用中，Java 注解最為經(jīng)典，為了便于理解，因此我們基于 Java 做初步的注解理解。

在 2002 年，JSR-175 提出了 《A Metadata Facility for the Java Programming Language》，也就是為 Java 編程語言提供元數(shù)據(jù)工具。

這就是現(xiàn)在使用最廣泛地注解（Annotation）的來源。示例如下：

// @annotation1// @annotation2func Hello() string {        return ""}

在格式上均以 “@” 作為注解標(biāo)識來使用。

注解例子

摘抄自 @wikipedia 的一個注解例子：

//等同于 @Edible(value = true)  @Edible(true)  Item item = new Carrot();  public @interface Edible {    boolean value() default false;  }  @Author(first = "Oompah", last = "Loompah")  Book book = new Book();  public @interface Author {    String first();    String last();  }    // 該標(biāo)注可以在運行時通過反射訪問。  @Retention(RetentionPolicy.RUNTIME)   // 該標(biāo)注只用于類內(nèi)方法。  @Target({ElementType.METHOD})  public @interface Tweezable {  }

在上述例子中，通過注解去做了一系列的定義、聲明、賦值等。若是對語言既有注解不熟，或是做的比較復(fù)雜的注解，就會有一定的理解成本。

在業(yè)內(nèi)也常常會說，注解就是 “在源碼上進行編碼”，注解的存在，有著明確的優(yōu)缺點。你覺得呢？

注解的作用

在注解的的作用上，分為如下幾點：

為編譯器提供信息：注釋可以被編譯器用來檢測錯誤或支持警告。

編譯時和部署時處理：軟件工具可以處理注釋信息以生成代碼、XML文件等。

運行時處理：有些注解可以在運行時檢查，并用于其他用途。

Go 注解在哪里

現(xiàn)狀

Go 語言本身并沒有原生支持強大的注解，僅限于以下兩種：

但這先按不足以作為一個函數(shù)注解來使用，也無法形成像 Python 那樣的裝飾器行為。

為什么不支持

Go issues 上有人提過類似的提案，

Go Contributor @ianlancetaylor 給出了明確的答復(fù)，Go 在設(shè)計上更傾向于明確的、顯式的編程風(fēng)格。

思考的優(yōu)缺點如下：

因如下原因，沒有接受注解：

可能有小伙伴會說了，有注解做裝飾器了，代碼會簡潔不少。

對此 Go 團隊的態(tài)度很明確

Go 認為可讀性更重要，如果只是額外多寫一點代碼，在權(quán)衡后，還是可以接受的。

用 Go 實現(xiàn)注解

雖然 Go 語言官方?jīng)]有原生的完整支持，但開源社區(qū)中也有小伙伴已經(jīng)放出了大招，借助各項周邊工具和庫來實現(xiàn)特定的函數(shù)注解功能。

GitHub 項目分別如下：

使用示例如下：

package tourdefrance//go:generate golangAnnotations -input-dir .// @RestService( path = "/api/tour" )type TourService struct{}type EtappeResult struct{ ... }// @RestOperation( method = "PUT", path = "/{year}/etappe/{etappeUid}" )func (ts *TourService) addEtappeResults(c context.Context, year int, etappeUid string, results EtappeResult) error { return nil}

對 Go 注解的使用感興趣的小伙伴可以自行查閱使用手冊。

我們更多的關(guān)心，Go 原生都沒支持，那么開源庫都是如何實現(xiàn)的呢？在此我們借助 MarcGrol/golangAnnotations 項目所提供的思路來講解。

分為三個步驟：

解析代碼。

模板處理。

生成代碼。

解析 AST

首先，我們需要用用 go/ast 標(biāo)準(zhǔn)庫獲取代碼所生成的 AST Tree 中需要的內(nèi)容和結(jié)構(gòu)。

示例代碼如下：

parsedSources := ParsedSources{    PackageName: "tourdefrance",    Structs:     []model.Struct{        {            DocLines:   []string{"http:// @RestService( path = "/api/tour" )"},            Name:       "TourService",            Operations: []model.Operation{                {                   DocLines:   []string{"http:// @RestOperation( method = "PUT", path = "/{year}/etappe/{etappeUid}"},                   ...                },            },        },    },}

我們可以看到，在 AST Tree 中能夠獲取到在示例代碼中所定義的注解內(nèi)容，我們就可以依據(jù)此去做很多奇奇怪怪的事情了。

模板生成

緊接著，在知道了注解的輸入是什么后，我們只需要根據(jù)實際情況，編寫對應(yīng)的模板生成器 code-generator 就可以了。

我們會基于 text/template 標(biāo)準(zhǔn)庫來實現(xiàn)，比較經(jīng)典的像是 kubernetes/code-generator 是一個可以參考的實現(xiàn)。

代碼實現(xiàn)完畢后，將其編譯成 go plugin，便于我們在下一步調(diào)用就可以了。

代碼生成

最后，萬事俱備只欠東風(fēng)。差的就是告訴工具，哪些 Go 文件中包含注解，需要我們?nèi)ド傻摹?/p>

這時候我們可以使用 //go:generate在 Go 文件聲明。就像前面的項目中所說的：

//go:generate golangAnnotations -input-dir .

聲明該 Go 文件需要生成，并調(diào)用前面編寫好的 golangAnnotations 二進制文件，就可以實現(xiàn)基本的 Go 注解生成了。

總結(jié)

今天在這篇文章中，我們介紹了注解（Annotation）的歷史背景。同時我們針對 Go 語言目前原生的注解支持情況進行了說明。

也面向為什么 Go 沒有像 Java 那樣支持強大的注解進行了基于 Go 官方團隊的原因解釋。如果希望在 Go 實現(xiàn)注解的，也提供了相應(yīng)的開源技術(shù)方案。

以上就是go語言有沒有注解的詳細內(nèi)容，更多請關(guān)注php中文網(wǎng)其它相關(guān)文章！

關(guān)鍵詞： go語言 Golang