go語(yǔ)言注釋的方法：1、通過(guò)將“//”符號(hào)放在單行g(shù)o語(yǔ)句前面來(lái)實(shí)現(xiàn)單行注釋；2、通過(guò)“/*…*/”符號(hào)包圍需要注釋掉的go代碼段來(lái)實(shí)現(xiàn)多行注釋。

本文環(huán)境：Windows7系統(tǒng)、Go1.11.2版，本文適用于所有品牌的電腦。

推薦：《go語(yǔ)言教程》

注釋在程序中的作用是對(duì)程序進(jìn)行注解和說(shuō)明，便于對(duì)源碼的閱讀。編譯系統(tǒng)在對(duì)源代碼進(jìn)行編譯時(shí)會(huì)自動(dòng)忽略注釋的部分，因此注釋對(duì)于程序的功能實(shí)現(xiàn)不起任何作用。在源碼中適當(dāng)?shù)靥砑幼⑨?，能夠提高源碼的可讀性。

Go語(yǔ)言的注釋主要分成兩類，分別是單行注釋和多行注釋。

單行注釋簡(jiǎn)稱行注釋，是最常見(jiàn)的注釋形式，可以在任何地方使用以//開(kāi)頭的單行注釋；

多行注釋簡(jiǎn)稱塊注釋，以/*開(kāi)頭，并以*/結(jié)尾，且不可以嵌套使用，多行注釋一般用于包的文檔描述或注釋成塊的代碼片段。

單行注釋的格式如下所示

//單行注釋

多行注釋的格式如下所示

/* 第一行注釋 第二行注釋 ... */

每一個(gè)包都應(yīng)該有相關(guān)注釋，在使用 package 語(yǔ)句聲明包名之前添加相應(yīng)的注釋，用來(lái)對(duì)包的功能及作用進(jìn)行簡(jiǎn)要說(shuō)明。

同時(shí)，在 package 語(yǔ)句之前的注釋內(nèi)容將被默認(rèn)認(rèn)為是這個(gè)包的文檔說(shuō)明。一個(gè)包可以分散在多個(gè)文件中，但是只需要對(duì)其中一個(gè)進(jìn)行注釋說(shuō)明即可。

在多段注釋之間可以使用空行分隔加以區(qū)分，如下所示：

// Package superman implements methods for saving the world. // // Experience has shown that a small number of procedures can prove // helpful when attempting to save the world. package superman

對(duì)于代碼中的變量、常量、函數(shù)等對(duì)象最好也都加上對(duì)應(yīng)的注釋，這樣有利于后期對(duì)代碼進(jìn)行維護(hù)，例如下面代碼中對(duì) enterOrbit 函數(shù)的注釋：

// enterOrbit causes Superman to fly into low Earth orbit, a position // that presents several possibilities for planet salvation. func enterOrbit() error {    ... }

當(dāng)開(kāi)發(fā)人員需要了解包的一些情況時(shí)，可以使用 godoc 來(lái)顯示包的文檔說(shuō)明