affaan-m/golang-patterns

Go 的惯用模式、最佳实践与约定，用于构建健壮、高效且可维护的 Go 应用程序。

编程协作开发 Agent Agent 技能调研 skill agent-skill golang patterns affaan-m ECC ai-agent

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

Skill 介绍Skill 文件

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

在 GitHub 查看 ↗

原文译文

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

Patrones de Desarrollo Go

Patrones idiomáticos de Go y buenas prácticas para construir aplicaciones robustas, eficientes y mantenibles.

Cuándo Activar

Escribir nuevo código Go
Revisar código Go
Refactorizar código Go existente
Diseñar paquetes/módulos Go

Principios Fundamentales

1. Simplicidad y Claridad

Go favorece la simplicidad sobre la astucia. El código debe ser obvio y fácil de leer.

// Bien: Claro y directo
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
}

// Mal: Demasiado ingenioso
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. Hacer que el Valor Cero Sea Útil

Diseñar tipos para que su valor cero sea inmediatamente usable sin inicialización.

// Bien: El valor cero es útil
type Counter struct {
    mu    sync.Mutex
    count int // el valor cero es 0, listo para usar
}

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.3 KB在 GitHub 查看 ↗