在 Go 語言中，通常會使用 godoc 工具來從注釋中生成 API 文檔。godoc 是 Go 官方提供的文檔生成工具，它可以解析 Go 源代碼中的注釋，并生成在線的、可交互的文檔。

為了使用 godoc 生成 API 文檔，你需要遵循一些特定的注釋格式。這些注釋應該位于包聲明、類型、變量、函數和方法之前，并且使用特定的注釋塊（即文檔注釋）。文檔注釋以 // 開頭，緊接著是一個換行符，然后是注釋內容。

下面是一個示例，展示了如何為 Go 代碼中的函數和方法編寫文檔注釋，以便 godoc 可以生成 API 文檔：

// Package mypackage provides some useful functionality.
package mypackage// MyStruct represents a structure with some fields.
type MyStruct struct {Field1 stringField2 int
}// MyFunction does something useful with a MyStruct.
//
// Parameters:
//     s: an instance of MyStruct to operate on
// Returns:
//     an error, if any
func MyFunction(s MyStruct) error {// ... 實現細節 ...return nil
}// (MyStruct) MyMethod modifies the receiver and returns a value.
//
// This method modifies the receiver's Field1 and returns Field2.
func (m *MyStruct) MyMethod() int {m.Field1 = "modified"return m.Field2
}

請注意以下幾點：

• 包注釋應該緊跟在 package 聲明之前。
• 類型、函數和方法的注釋應該緊跟在它們之前，并且用空行與注釋內容分隔。
• 注釋的第一行通常是一個簡短的摘要，描述類型、函數或方法的作用。
• 后續的注釋行提供了更多詳細信息，如參數、返回值等。
• 如果注釋內容較長，可以使用多個行來組織信息。

為了生成 API 文檔，你可以按照以下步驟操作：

1. 確保你的 Go 代碼已經按照上述格式添加了文檔注釋。
2. 在命令行中運行 godoc -http=:6060（端口號可以根據需要更改）。這將啟動一個 HTTP 服務器，在指定的端口上提供文檔服務。
3. 打開瀏覽器并訪問 http://localhost:6060/pkg/（或你指定的其他地址和端口），你將看到 Go 標準庫以及你當前工作目錄下的所有包的文檔列表。
4. 點擊你的包名，你將看到該包的詳細文檔，包括你編寫的所有類型、函數和方法的文檔。

另外，你也可以使用像 swagger 這樣的工具來生成更豐富的 API 文檔，但這通常需要額外的配置和注解。對于簡單的 API 文檔需求，godoc 通常已經足夠。