Go Academy · Aula

Inspecionando campos e tags de structs

Itere pelos campos e leia as tags de structs

Inspecionando campos e tags de structs é uma aula grátis de Go Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Go Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Go Academy inclui 4 aulas no total.

Tipo StructField

reflect.StructField descreve um campo de uma struct: Name, Type, Tag, Index, Offset, Anonymous e IsExported.

Iterando pelos campos

Percorra todos os campos de um tipo struct:

t := reflect.TypeOf(struct{ ID int; Name string }{})
for i := 0; i < t.NumField(); i++ {
    f := t.Field(i)
    fmt.Println(f.Name, f.Type, f.IsExported())
}

Lendo tags de struct

As tags são acessadas por meio de StructField.Tag.Get("key"):

type User struct {
    ID   int    `json:"id" db:"user_id"`
    Name string `json:"name,omitempty"`
}

f, _ := reflect.TypeOf(User{}).FieldByName("Name")
fmt.Println(f.Tag.Get("json")) // "name,omitempty"

Analisando opções de tags

As tags podem conter opções separadas por vírgulas. Analise-as com strings.Split:

tag := f.Tag.Get("json") // "name,omitempty"
parts := strings.Split(tag, ",")
name := parts[0] // "name"
omitempty := len(parts) > 1 && parts[1] == "omitempty"

FieldByName e FieldByIndex

Procure um campo pelo nome ou pelo índice. FieldByName pesquisa campos exportados na struct e nas structs incorporadas:

f, ok := reflect.TypeOf(User{}).FieldByName("Name")
if ok { fmt.Println(f.Tag.Get("json")) }

Campos de structs incorporadas

Para structs incorporadas, Anonymous é verdadeiro. Use Type.FieldByIndex([]int{0,1}) para acessar campos aninhados.

Campos não exportados

Campos não exportados (em minúsculas) podem ser inspecionados quanto ao tipo e à tag, mas seus valores não podem ser lidos nem definidos por reflexão — isso causa um pânico.

Criando um cache de campos

Analisar tags de struct em cada chamada é dispendioso. Armazene o resultado em um sync.Map indexado por reflect.Type:

var fieldCache sync.Map
func getFields(t reflect.Type) []fieldInfo {
    if v, ok := fieldCache.Load(t); ok { return v.([]fieldInfo) }
    fields := parseFields(t)
    fieldCache.Store(t, fields)
    return fields
}

Caso de uso: ORM simples

Percorra todos os campos com uma tag "db" para criar dinamicamente uma lista de colunas INSERT:

t := reflect.TypeOf(u)
v := reflect.ValueOf(u)
for i := 0; i < t.NumField(); i++ {
    col := t.Field(i).Tag.Get("db")
    val := v.Field(i).Interface()
    // build query...
}

Caso de uso: carregador de configuração

Percorra os campos da struct com uma tag "env" e preencha-os a partir das variáveis de ambiente:

if env := f.Tag.Get("env"); env != "" {
    if val := os.Getenv(env); val != "" {
        v.Field(i).SetString(val)
    }
}

StructTag.Lookup

Tag.Lookup("key") retorna o valor da tag e um booleano que indica se a chave estava presente, ao contrário de Get, que retorna "" para chaves ausentes.

val, ok := f.Tag.Lookup("json")
if !ok { /* no json tag */ }

Verificação rápida

Como você lê o valor da tag de struct "json" de um reflect.StructField?

Recapitulação: campos e tags de struct

Pontos principais:

reflect.TypeOf → .NumField(), .Field(i) para obter metadados dos campos
StructField.Tag.Get("key") para ler valores de tags
Armazene os metadados dos campos em cache em um sync.Map para evitar análises repetidas
Use Tag.Lookup quando for importante distinguir uma tag ausente de uma string vazia

Perguntas Frequentes

A aula “Inspecionando campos e tags de structs” é grátis?

Sim — o texto completo de “Inspecionando campos e tags de structs” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Go Academy, atualize para CoddyKit PRO. O curso de Go Academy inclui 4 aulas no total.

O que vou aprender em “Inspecionando campos e tags de structs”?

Itere pelos campos e leia as tags de structs Você pratica Go Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Go Academy?

Nenhuma experiência prévia é necessária. Go Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Inspecionando campos e tags de structs”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Go Academy?

Sim. Cada aula de Go Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Go Academy