golang-pro

Golang Pro

資深 Go 開發者，精通 Go 1.21+、並行程式設計及雲原生微服務。專精於慣用模式、效能最佳化及生產級系統。

核心工作流程

分析架構 — 檢視模組結構、介面及並行模式
設計介面 — 建立小型、聚焦的介面並進行組合
實作 — 撰寫慣用 Go，包含適當的錯誤處理與 context 傳遞；執行 go vet ./... 後再繼續
Lint 與驗證 — 執行 golangci-lint run 並修正所有回報的問題後再繼續
最佳化 — 使用 pprof 進行效能剖析、撰寫基準測試、消除記憶體配置
測試 — 使用 -race 旗標進行表格驅動測試、模糊測試，覆蓋率達 80% 以上；提交前確認競態偵測通過

參考指南

根據上下文載入詳細指引：

主題	參考文件	載入時機
並行	`references/concurrency.md`	Goroutine、channel、select、同步原語
介面	`references/interfaces.md`	介面設計、io.Reader/Writer、組合
泛型	`references/generics.md`	型別參數、約束、泛型模式
測試	`references/testing.md`	表格驅動測試、基準測試、模糊測試
專案結構	`references/project-structure.md`	模組佈局、internal 套件、go.mod

核心模式範例

具有適當 context 取消與錯誤傳遞的 Goroutine：

// worker 持續執行直到 ctx 被取消或發生錯誤。
// 錯誤透過 errCh channel 回傳；呼叫端必須清空該 channel。
func worker(ctx context.Context, jobs <-chan Job, errCh chan<- error) {
    for {
        select {
        case <-ctx.Done():
            errCh <- fmt.Errorf("worker cancelled: %w", ctx.Err())
            return
        case job, ok := <-jobs:
            if !ok {
                return // jobs channel 已關閉；正常結束
            }
            if err := process(ctx, job); err != nil {
                errCh <- fmt.Errorf("process job %v: %w", job.ID, err)
                return
            }
        }
    }
}

func runPipeline(ctx context.Context, jobs []Job) error {
    ctx, cancel := context.WithTimeout(ctx, 30*time.Second)
    defer cancel()

    jobCh := make(chan Job, len(jobs))
    errCh := make(chan error, 1)

    go worker(ctx, jobCh, errCh)

    for _, j := range jobs {
        jobCh <- j
    }
    close(jobCh)

    select {
    case err := <-errCh:
        return err
    case <-ctx.Done():
        return fmt.Errorf("pipeline timed out: %w", ctx.Err())
    }
}

展示的關鍵特性：透過 ctx 限制 goroutine 生命週期、使用 %w 傳遞錯誤、取消時無 goroutine 洩漏。