Como funcionam genéricos em Go?

Question

Accepted Answer

**Genéricos** (adicionados em Go 1.18) permitem que você escreva funções e tipos que funcionam com **múltiplos tipos** através de parâmetros de tipo, mantendo segurança de tipo em tempo de compilação. Eles eliminam o antigo dilema de duplicar código por tipo ou perder segurança com `interface{}`.

## O problema que genéricos resolvem

```go
// ❌ before generics — either duplicate per type...
func MaxInt(a, b int) int { ... }
func MaxFloat(a, b float64) float64 { ... }   // copy-paste for each type

// ...or use interface{} and lose type safety + need casts/assertions
func Max(a, b interface{}) interface{} { ... }   // unsafe, clunky
```

## Uma função genérica

```go
// T is a type parameter constrained to be "ordered" (comparable with < >)
func Max[T constraints.Ordered](a, b T) T {
    if a > b {
        return a
    }
    return b
}

Max(3, 5)         // T inferred as int → 5
Max(2.5, 1.1)     // T inferred as float64 → 2.5
Max("a", "b")     // T inferred as string → "b"
```

O `[T constraints.Ordered]` declara um parâmetro de tipo `T` com uma **restrição** (quais tipos são permitidos). O compilador infere `T` a partir dos argumentos — uma implementação funciona para muitos tipos, totalmente type-safe.

## Restrições de tipo

```go
// a constraint is an interface listing allowed types or required methods
type Number interface {
    ~int | ~int64 | ~float64        // the | union means "any of these"
}

func Sum[T Number](nums []T) T {
    var total T
    for _, n := range nums {
        total += n                   // safe — T is constrained to numeric types
    }
    return total
}
Sum([]int{1, 2, 3})       // 6
Sum([]float64{1.5, 2.5})  // 4.0

// built-in constraints:
any                        // any type (alias for interface{})
comparable                 // types usable with == (for map keys, etc.)
// golang.org/x/exp/constraints: Ordered, Integer, Float, etc.
```

Restrições definem quais operações são válidas no parâmetro de tipo (o `~` significa "qualquer tipo cujo tipo subjacente é este").

## Tipos genéricos

```go
// a generic stack that works for any type
type Stack[T any] struct {
    items []T
}
func (s *Stack[T]) Push(item T) { s.items = append(s.items, item) }
func (s *Stack[T]) Pop() T {
    item := s.items[len(s.items)-1]
    s.items = s.items[:len(s.items)-1]
    return item
}

intStack := Stack[int]{}       // a stack of ints
strStack := Stack[string]{}     // a stack of strings — same code
```

## Quando usar (e não usar) genéricos

```text
✓ Generic data structures (stacks, trees, sets), utility functions over collections
  (Map, Filter, Reduce), type-safe containers
✗ Don't overuse — if interfaces or a concrete type work simply, prefer them.
  Go's philosophy still favors simplicity; generics are a tool, not a default.
```

## Por que isso importa

Genéricos foram uma adição importante e muito aguardada ao Go (1.18) que resolveu um ponto crítico: antes deles, escrever código reutilizável para múltiplos tipos força você a duplicá-lo por tipo (verboso, difícil de manter) ou usar `interface{}` (perdendo segurança de tipo em tempo de compilação e exigindo asserções em tempo de execução).

Genéricos permitem que você escreva funções type-safe e reutilizáveis e estruturas de dados (containers, utilitários de coleção como Map/Filter/Reduce) uma única vez, com o compilador aplicando correção e inferindo tipos.

Compreender parâmetros de tipo, restrições (incluindo `any`, `comparable` e a sintaxe union/`~`) e tipos genéricos é cada vez mais importante conforme o ecossistema os adota.

Igualmente importante é a mentalidade Go de que genéricos são uma **ferramenta para reutilização genuína, não um padrão** — usá-los em excesso vai contra a filosofia de simplicidade do Go.

Este é um tópico atual e frequentemente discutido que reflete fluência com Go moderno.