1.22-1.25: Modern Features Era

Go 1.22-1.25 - Features Modernas (Tool Dependencies, GOAUTH, Telemetria)

Visão geral

Go 1.22-1.25 poliu o sistema de módulos com features modernas focadas em produtividade, segurança e observabilidade.

Timeline:

Go 1.22: Fevereiro 2024
Go 1.23: Agosto 2024
Go 1.24: Fevereiro 2025
Go 1.25: Agosto 2025

Go 1.22 (Fevereiro 2024)

🔄 go work vendor

Workspace agora suporta vendoring!

# Criar vendor para workspace inteiro
go work vendor

# Build usando vendor
go build -mod=vendor ./...

🔧 for loop "fix"

Finalmente! Variáveis de loop não vazam:

// Go ≤ 1.21: Bug clássico
for i := range items {
    go func() {
        fmt.Println(i)  // ❌ Sempre imprime último valor
    }()
}

// Go ≥ 1.22: Funciona corretamente!
for i := range items {
    go func() {
        fmt.Println(i)  // ✅ Valor correto
    }()
}

📊 Improved telemetry support

Go agora coleta telemetria (opt-in) para melhorar o Go:

# Opt-in
go telemetry on

# Opt-out (padrão)
go telemetry off

# Ver dados coletados
go telemetry view

Outras melhorias

range sobre integers
Melhorias de performance
Melhor suporte a WASM

Go 1.23 (Agosto 2024)

🎯 Improved Module Graph Resolution

Resolução de dependências mais eficiente e correta.

🔐 Enhanced Security Features

Melhorias no checksum database e proteções adicionais.

📦 Better Workspace Integration

Workspaces agora integram melhor com todas as ferramentas.

Outras melhorias

Iterator support (experimental)
Performance de garbage collector
Melhorias no compilador

Go 1.24 (Fevereiro 2025)

🛠️ `tool` directive

FEATURE MUITO ESPERADA!

Finalmente, gerenciamento oficial de ferramentas:

// go.mod
module example.com/project

go 1.25

// Dependências de runtime
require (
    github.com/gin-gonic/gin v1.10.0
)

// Ferramentas de desenvolvimento
tool (
    golang.org/x/tools/cmd/goimports
    github.com/golangci/golangci-lint/cmd/golangci-lint
    github.com/swaggo/swag/cmd/swag
)

Comandos:

# Adicionar ferramenta
go get -tool github.com/golangci/golangci-lint/cmd/golangci-lint@latest

# Executar ferramenta
go tool golangci-lint run

# Instalar ferramentas
go install tool  # Instala todas no GOBIN

Ver capítulo completo: Tool Dependencies

🔐 GOAUTH - Module Authentication

Sistema moderno de autenticação para módulos privados:

# GitHub
export GOAUTH="github.com/empresa=git:echo username=token:$GITHUB_TOKEN"

# GitLab
export GOAUTH="gitlab.empresa.com=netrc"

# Custom
export GOAUTH="git.empresa.com=command:/usr/local/bin/auth-helper"

Provedores suportados:

git - Git credential helper
netrc - Arquivo ~/.netrc
command - Script customizado
off - Desabilita autenticação

Ver capítulo: Security Features

📋 Structured Output (-json flags)

Muitos comandos agora suportam -json:

# go list com JSON
go list -json -m all

# go build com JSON
go build -json ./...

# go test com JSON
go test -json ./...

Benefícios:

Parsing fácil em scripts
Integração com ferramentas
CI/CD mais robusto

🔄 `go run` caching

go run agora cacheia executáveis:

# Primeira execução: compila
go run main.go  # 2s

# Segunda execução: usa cache
go run main.go  # 0.1s

Outras melhorias

Melhorias no PGO
Performance geral
Suporte a novas plataformas

Go 1.25 (Agosto 2025)

🚫 `ignore` directive

Ignore diretórios ao matching patterns:

// go.mod
module example.com/project

go 1.25

// Ignorar diretórios específicos
ignore (
    testdata
    _examples
    deprecated
)

Uso:

# ./... agora ignora os diretórios especificados
go build ./...
go test ./...

📁 Suporte a subdiretórios de módulo

Módulos agora podem estar em subdiretórios de repos:

github.com/org/repo
├── go.mod (root module)
└── subproject/
    └── go.mod (submodule!)

Sintaxe:

import "github.com/org/repo/subproject@subdirectory"

🎯 Novo padrão de uso do `work`

Novo pattern para workspace modules:

# Testa todos os pacotes em TODOS os módulos do workspace
go test work

# Build todos os módulos do workspace
go build work

📊 `go doc -http`

Servidor de documentação integrado:

# Iniciar servidor de docs
go doc -http :8080

# Abre automaticamente no browser
# Mostra docs de todos os módulos do workspace

🐳 Container-Aware GOMAXPROCS

Go agora detecta limites de containers (Kubernetes, Docker):

// Antes: GOMAXPROCS = número de CPUs na máquina (ex: 96)
// Mesmo se container limitado a 2 CPUs!

// Go 1.25: GOMAXPROCS = CPUs do container (ex: 2)
// Automaticamente!

Benefícios:

Melhor performance em Kubernetes
Menos contenção
Uso otimizado de recursos

🗑️ Green Tea Garbage Collector (Experimental)

Novo GC experimental com pausas ainda menores:

GOEXPERIMENT=greentea go build

🔧 Atualizações em toolchain

Toolchain não é mais adicionado automaticamente ao atualizar go line
Melhor controle de versões

Outras melhorias

Performance do compilador
Melhorias em generics
Suporte a novas arquiteturas
Melhorias no runtime

Comparação de features

Versão

Feature Destaque

Categoria

1.22

go work vendor

Workflow

1.23

Telemetria

Observability

1.24

tool directive + GOAUTH

Produtividade

1.25

ignore + work pattern

Refinamento

Stack moderna (Go 1.25)

Um `go.mod` completo

module github.com/empresa/api

go 1.25

// Dependências de runtime
require (
    github.com/gin-gonic/gin v1.10.0
    gorm.io/gorm v1.25.10
)

// Dependências indiretas
require (
    github.com/gin-contrib/sse v0.1.0 // indirect
    // ...
)

// Ferramentas de desenvolvimento
tool (
    golang.org/x/tools/cmd/goimports
    github.com/golangci/golangci-lint/cmd/golangci-lint
    github.com/swaggo/swag/cmd/swag
)

// Ignorar diretórios
ignore (
    testdata
    _examples
)

O workflow completo

# 1. Setup inicial
go work init ./service1 ./service2

# 2. Baixar deps + ferramentas
go mod download

# 3. Instalar ferramentas
go install tool

# 4. Desenvolvimento
go tool goimports -w .
go tool golangci-lint run
go test work  # Testa todos os módulos do workspace

# 5. Build
go build ./...  # Usa container-aware GOMAXPROCS

Migração para Go 1.24-1.25

Preparação

# 1. Atualizar Go
go install golang.org/dl/go1.25@latest
go1.25 download

# 2. Atualizar go.mod
go mod edit -go=1.25
go mod edit -toolchain=go1.25.0

# 3. Migrar ferramentas
go get -tool golang.org/x/tools/cmd/goimports@latest
go get -tool github.com/golangci/golangci-lint/cmd/golangci-lint@latest

# 4. Remover tools.go (se existir)
rm tools.go

# 5. Adicionar ignore se necessário
go mod edit -ignore=testdata -ignore=_examples

# 6. Tidy
go mod tidy

# 7. Testar
go build ./...
go test work

Configurar GOAUTH

# Para módulos privados
export GOAUTH="github.com/empresa=git:echo username=token:${GITHUB_TOKEN}"

# Adicionar ao ~/.bashrc ou ~/.zshrc
echo 'export GOAUTH="github.com/empresa=git:echo username=token:${GITHUB_TOKEN}"' >> ~/.bashrc

Checklist de atualização

Go 1.22

Usar go work vendor se aplicável
Aproveitar fix de for loop
Decidir sobre telemetria

Go 1.23

Testar melhorias de resolução de deps
Atualizar ferramentas de segurança

Go 1.24

Migrar para tool directive
Configurar GOAUTH para repos privados
Usar -json flags em CI/CD
Aproveitar go run caching

Go 1.25

Adicionar ignore directive se necessário
Usar work pattern em workspaces
Testar go doc -http
Verificar GOMAXPROCS em containers
Avaliar Green Tea GC (experimental)

Recursos adicionais

Resumo: O estado atual (Go 1.25)

Go modules em 2025 é maduro, poderoso e produtivo:

Problemas resolvidos

Problema

Solução (Go 1.25)

Gerenciar ferramentas

✅ tool directive

Autenticação privada

✅ GOAUTH

Multi-module dev

✅ Workspace mode

Versões do Go

✅ Toolchain management

Performance

✅ Lazy loading + pruning

Segurança

✅ GOVCS + Checksum DB + GOAUTH

Stack recomendada 2025

Go 1.25
├─ Módulos (obrigatórios)
├─ Workspace (multi-module)
├─ Toolchain automático
├─ Tool directive (ferramentas)
├─ GOAUTH (auth moderna)
├─ Lazy loading (performance)
└─ Container-aware (K8s)

Go 1.25 representa o ápice de 7 anos de evolução do sistema de módulos. É robusto, seguro, rápido e um prazer de usar!

Previous1.18-1.21: Workspace & Toolchain Era

Last updated 3 months ago

hashtagVisão geral

hashtagGo 1.22 (Fevereiro 2024)

hashtag🔄 go work vendor

hashtag🔧 for loop "fix"

hashtag📊 Improved telemetry support

hashtagOutras melhorias

hashtagGo 1.23 (Agosto 2024)

hashtag🎯 Improved Module Graph Resolution

hashtag🔐 Enhanced Security Features

hashtag📦 Better Workspace Integration

hashtagOutras melhorias

hashtagGo 1.24 (Fevereiro 2025)

hashtag🛠️ tool directive

hashtag🔐 GOAUTH - Module Authentication

hashtag📋 Structured Output (-json flags)

hashtag🔄 go run caching

hashtagOutras melhorias

hashtagGo 1.25 (Agosto 2025)

hashtag🚫 ignore directive

hashtag📁 Suporte a subdiretórios de módulo

hashtag🎯 Novo padrão de uso do work

hashtag📊 go doc -http

hashtag🐳 Container-Aware GOMAXPROCS

hashtag🗑️ Green Tea Garbage Collector (Experimental)

hashtag🔧 Atualizações em toolchain

hashtagOutras melhorias

hashtagComparação de features

hashtagStack moderna (Go 1.25)

hashtagUm go.mod completo

hashtagO workflow completo

hashtagMigração para Go 1.24-1.25

hashtagPreparação

hashtagConfigurar GOAUTH

hashtagChecklist de atualização

hashtagGo 1.22

hashtagGo 1.23

hashtagGo 1.24

hashtagGo 1.25

hashtagRecursos adicionais

hashtagResumo: O estado atual (Go 1.25)

hashtagProblemas resolvidos

hashtagStack recomendada 2025

Visão geral

Go 1.22 (Fevereiro 2024)

🔄 go work vendor

🔧 for loop "fix"

📊 Improved telemetry support

Outras melhorias

Go 1.23 (Agosto 2024)

🎯 Improved Module Graph Resolution

🔐 Enhanced Security Features

📦 Better Workspace Integration

Outras melhorias

Go 1.24 (Fevereiro 2025)

🛠️ `tool` directive

🔐 GOAUTH - Module Authentication

📋 Structured Output (-json flags)

🔄 `go run` caching

Outras melhorias

Go 1.25 (Agosto 2025)

🚫 `ignore` directive

📁 Suporte a subdiretórios de módulo

🎯 Novo padrão de uso do `work`

📊 `go doc -http`

🐳 Container-Aware GOMAXPROCS

🗑️ Green Tea Garbage Collector (Experimental)

🔧 Atualizações em toolchain

Outras melhorias

Comparação de features

Stack moderna (Go 1.25)

Um `go.mod` completo

O workflow completo

Migração para Go 1.24-1.25

Preparação

Configurar GOAUTH

Checklist de atualização

Go 1.22

Go 1.23

Go 1.24

Go 1.25

Recursos adicionais

Resumo: O estado atual (Go 1.25)

Problemas resolvidos

Stack recomendada 2025