Go 模式
可量化評估: 當前前沿 和 小型 Claude 模型已經能在不借助此技能的情況下,單次正確寫出常見的並發機制(工作者池、管線階段、通道關閉)——一項對照研究發現正確性提升空間為零,兩組均通過 184/184 個測試(該儲存庫的
evals/RESULTS.md第 2 節)。請在需要設計選擇時——介面、依賴接線、錯誤塑形、套件佈局——作為檢核查核清單,或驅動較弱模型時使用此技能;而非因為當前模型會導致死鎖。
範圍:Go 檔案、go.mod 與 go.sum。
來源:衍生自 Everything Claude Code (MIT,(c) 2026 Affaan Mustafa)。
此技能提供全面的 Go 模式,將常見設計原理延伸為 Go 特定的慣用寫法。
函數選項模式
使用函數選項模式以實現靈活的建構子配置:
type Option func(*Server)
func WithPort(port int) Option {
return func(s *Server) { s.port = port }
}
func NewServer(opts ...Option) *Server {
s := &Server{port: 8080}
for _, opt := range opts {
opt(s)
}
return s
}
優點:
- 向後相容的 API 演化
- 可選參數附帶預設值
- 自我說明的配置
小型介面
在使用介面的地方定義介面,而非在實作介面的地方。
原則: 接受介面,回傳結構體
// 良好:小巧、聚焦的介面,在使用點定義
type UserStore interface {
GetUser(id string) (*User, error)
}
func ProcessUser(store UserStore, id string) error {
user, err := store.GetUser(id)
// ...
}
優點:
- 更易於測試與模擬
- 鬆散耦合
- 清晰的依賴關係
依賴注入
使用建構子函數注入依賴:
func NewUserService(repo UserRepository, logger Logger) *UserService {
return &UserService{
repo: repo,
logger: logger,
}
}
模式:
- 建構子函數(New* 前綴)
- 明確的依賴作為參數
- 回傳具體型別
- 在建構子中驗證依賴
並發模式
工作者池
func workerPool(jobs <-chan Job, results chan<- Result, workers int) {
var wg sync.WaitGroup
for i := 0; i < workers; i++ {
wg.Add(1)
go func() {
defer wg.Done()
for job := range jobs {
results <- processJob(job)
}
}()
}
// 在所有工作者完成後關閉 results——在一個獨立的 goroutine 中執行,這樣此函數
// 就能立即返回,呼叫者可以在工作者仍在產生結果時對 results 進行 range。
// 內聯的 wg.Wait() 會導致死鎖:工作者在將資料傳送至 results 時會阻塞,直到有讀取者消耗它,
// 但讀取者只有在 workerPool 返回後才會執行。
go func() {
wg.Wait()
close(results)
}()
}
上下文傳播
始終將 context 作為第一個參數傳遞:
func FetchUser(ctx context.Context, id string) (*User, error) {
// 檢查上下文取消
select {
case <-ctx.Done():
return nil, ctx.Err()
default:
}
// ... 取得邏輯
}
錯誤處理
錯誤包裝
if err != nil {
return fmt.Errorf("無法取得使用者 %s:%w", id, err)
}
自訂錯誤
type ValidationError struct {
Field string
Msg string
}
func (e *ValidationError) Error() string {
return fmt.Sprintf("%s:%s", e.Field, e.Msg)
}
哨兵錯誤
var (
ErrNotFound = errors.New("未找到")
ErrInvalid = errors.New("無效輸入")
)
// 使用 errors.Is 檢查
if errors.Is(err, ErrNotFound) {
// 處理未找到的情況
}
套件組織
結構
project/
├── cmd/ # 主要應用程式
│ └── server/
│ └── main.go
├── internal/ # 私有應用程式碼
│ ├── domain/ # 業務邏輯
│ ├── handler/ # HTTP 處理器
│ └── repository/ # 資料存取
└── pkg/ # 公開函式庫
命名慣例
- 套件名稱:小寫,單一單詞
- 避免重複:
user.User而非user.UserModel - 使用
internal/存放私有程式碼 - 保持
main套件儘量精簡
測試模式
表格驅動測試
func TestValidate(t *testing.T) {
tests := []struct {
name string
input string
wantErr bool
}{
{"有效", "[email protected]", false},
{"無效", "not-an-email", true},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
err := Validate(tt.input)
if (err != nil) != tt.wantErr {
t.Errorf("取得錯誤 %v,預期 wantErr %v", err, tt.wantErr)
}
})
}
}
測試輔助函數
// 匯入純 Go 驅動程式:_ "modernc.org/sqlite"(註冊為 "sqlite")。
// 請勿使用 "sqlite3"(mattn/go-sqlite3)——它需要 CGO 且會破壞 CGO_ENABLED=0
// 的靜態建置。greenfield-go-stack 套裝要求純 Go / 無 CGO。
func testDB(t *testing.T) *sql.DB {
t.Helper()
db, err := sql.Open("sqlite", ":memory:")
if err != nil {
t.Fatalf("無法開啟測試資料庫:%v", err)
}
// ":memory:" 資料庫對單一連線是私有的,而 database/sql
// 是一個惰性連線池:若不這麼做,每個連接池中的連線都會獲得自己獨立的空資料庫,
// 因此在一個連線上建立的表格,在下一個連線上會找不到。
// 將連線池固定為一個連線,可使整個測試共用一個記憶體中的 DB。
// 注意:使用單一連線時,若有一個事務處於開啟狀態(db.Begin),
// 該事務會獨佔該連線——所有工作都要透過該事務進行,直到 Commit/
// Rollback;同時對連線池進行的 db.Query 會阻塞等待。如果測試真的需要多個即時連線,
// 請改用共享快取 DSN("file:testdb?mode=memory&cache=shared")
// 並保持至少一個連線開啟,以避免記憶體中 DB 被釋放。
db.SetMaxOpenConns(1)
t.Cleanup(func() { db.Close() })
return db
}
何時使用此技能
- 設計 Go API 與套件
- 實作並發系統
- 組織 Go 專案結構
- 編寫慣用的 Go 程式碼
- 重構 Go 程式碼庫