affaan-m/golang-patterns

用于创建健壮、高效且易于维护的 Go 应用程序的惯用 Go 模式、最佳实践和约定。

编程协作开发 Agent Agent 技能调研 Go 语言惯用法 Go 代码审查 Go 重构建议 Go 包设计 Go 最佳实践

技术栈: cursor24万+许可证: MIT开发者: affaan-m

Skill 介绍Skill 文件

重要提示：本站仅作 Skill 资源导航与收录，正文以 GitHub 原仓库为准，版权归原项目所有。

在 GitHub 查看 ↗

原文译文

以下为摘要预览，完整内容请查看 GitHub 原文。

Go Geliştirme Desenleri

Sağlam, verimli ve bakımı kolay uygulamalar oluşturmak için idiomatic Go desenleri ve en iyi uygulamalar.

Ne Zaman Etkinleştirmeli

Yeni Go kodu yazarken
Go kodunu gözden geçirirken
Mevcut Go kodunu refactor ederken
Go paketleri/modülleri tasarlarken

Temel Prensipler

1. Basitlik ve Açıklık

Go, zekiceden ziyade basitliği tercih eder. Kod açık ve okunması kolay olmalıdır.

// İyi: Açık ve doğrudan
func GetUser(id string) (*User, error) {
    user, err := db.FindUser(id)
    if err != nil {
        return nil, fmt.Errorf("get user %s: %w", id, err)
    }
    return user, nil
}

// Kötü: Aşırı zeki
func GetUser(id string) (*User, error) {
    return func() (*User, error) {
        if u, e := db.FindUser(id); e == nil {
            return u, nil
        } else {
            return nil, e
        }
    }()
}

2. Sıfır Değeri Kullanışlı Yapın

Türleri, sıfır değerinin başlatma olmadan hemen kullanılabilir olacağı şekilde tasarlayın.

// İyi: Sıfır değer kullanışlıdır
type Counter struct {
    mu    sync.Mutex
    count int // sıfır değer 0'dır, kullanıma hazırdır
}

func (c *Counter) Inc() {
    c.mu.Lock()
    c.count++…

以下为摘要预览，完整内容请查看 GitHub 原文。

Go 开发模式

用于创建健壮、高效且易于维护的应用程序的惯用 Go 模式和最佳实践。

何时启用

编写新的 Go 代码时
审查 Go 代码时
重构现有的 Go 代码时
设计 Go 包/模块时

核心原则

1. 简单与清晰

Go 更倾向于简单，而不是炫技。代码应当清晰且易于阅读。

// 好：清晰且直接
func GetUser(id string) (*User, error) {
    user, err := db.FindUser(id)
    if err != nil {
        return nil, fmt.Errorf("get user %s: %w", id, err)
    }
    return user, nil
}

// 坏：过度炫技
func GetUser(id string) (*User, error) {
    return func() (*User, error) {
        if u, e := db.FindUser(id); e == nil {
            return u, nil
        } else {
            return nil, e
        }
    }()
}

2. 让零值变得有用

设计类型时，应使其零值无需初始化即可立即使用。

// 好：零值很有用
type Counter struct {
    mu    sync.Mutex
    count int // 零值为 0，可直接使用
}

func (c *Counter) Inc() {
    c.mu.Lock()
    c.count++
    c.mu.Unlock()
}

// 好：bytes.Buffer 可使用零值工作
var buf bytes.Buffer
buf.WriteString("hello")

// 坏：需要初始化
type BadCounter struct {
    counts map[string]int // nil map 会导致 panic
}

3. 接受接口，返回结构体

函数应接受接口参数并返回具体类型。

// 好：接受接口，返回具体类型
func ProcessData(r io.Reader) (*Result, error) {
    data, err := io.ReadAll(r)
    if err != nil {
        return nil, err
    }
    return &Result{Data: data}, nil
}

// 坏：…

重要提示：源文件不在本站托管，请通过 GitHub 查看与下载。

索引更新于 8/25/2026, 9:18:05 PMGitHub ↗

SKILL.md14.4 KB在 GitHub 查看 ↗