go語言注釋

go語言注釋例項**教程 - go支援c語言風格的/* */塊注釋，也支援c＋＋風格的//行注釋。當然，行注釋更通用，塊注釋主要用於針對包的詳細說明或者遮蔽大塊的**。

每個包都應有乙個包註解，即 package 前的塊註解。對多個檔案的包，包註解只需出現在乙個檔案中，隨便哪個。包註解應該介紹此包，並作為乙個整體提供此包的對應資訊。它首先出現在 godoc 頁面，來安排好後續的詳細文件。

包如果簡單，注釋可以簡短。

註解不需多餘排版如星星橫幅等。生成的結果呈現時可能不是等寬字型，所以不要靠空格對齊， godoc，類似 gofmt 照管這些。最後，註解是不加解釋的文字，html和其他例如 _this_ 會原樣照搬，所以應避免使用。

在包裡，緊跟頂層宣告前的註解作為此宣告的文註解，程式中每個匯出（大寫）的名字都應該有文註解。

文註解最好是完整的句子。首句應該以宣告的名字開始的一句話的總結。

go 的宣告句法允許編組。單一的文註解可以引出一組相聯的常量或變數。因為整組宣告一起展現，註解可以很粗略：

對於私有名稱，編組也可以指出它們之間的聯絡，例如一系列的變數由乙個互斥保護。

var (
countlock   sync.mutex
inputcount  uint32
outputcount uint32
errorcount  uint32