Recursos Oficiais: go.dev, pkg.go.dev e o Blog Go
A documentação oficial do Go está dividida em um pequeno conjunto de fontes confiáveis.
//
Busque em todas as páginas da documentação
A documentação oficial do Go está dividida em um pequeno conjunto de fontes confiáveis.
Esta cheatsheet mapeia cada URL para a pergunta que ela responde, para que você pare de adivinhar se deve pesquisar blogs, GitHub ou Stack Overflow primeiro.
go.mod.| Fonte | Pergunta que responde | URL |
|---|---|---|
| Página inicial go.dev | Onde faço o download do Go e encontro caminhos de aprendizado? | https://go.dev |
| Downloads | Qual tarball ou instalador corresponde ao meu SO/arquitetura? | https://go.dev/dl/ |
| Especificação da Linguagem | Este programa é Go válido? | https://go.dev/ref/spec |
| Effective Go | Qual é o estilo idiomático do Go? | https://go.dev/doc/effective_go |
| Go Tour | Como aprendo a sintaxe interativamente? | https://go.dev/tour/ |
| Playground | Posso compartilhar um repro mínimo sem configuração? | https://go.dev/play/ |
| pkg.go.dev | O que este símbolo faz na versão V? | https://pkg.go.dev |
| Blog Go | Por que a equipe enviou essa mudança? | https://go.dev/blog |
| Notas de lançamento | O que quebra ou aperta em Go 1.N? | https://go.dev/doc/go1.N |
| Segurança | Onde estão os anúncios de segurança? | https://go.dev/security |
| Banco de Dados de Vulnerabilidades | Meu grafo de módulos é afetado por um CVE? | https://vuln.go.dev |
| Tarefa | Caminho no navegador | Equivalente CLI |
|---|---|---|
| Pacote da biblioteca padrão | pkg.go.dev/fmt | go doc fmt |
| Módulo na versão | pkg.go.dev/mod/path@v1.2.3 | go doc mod/path@v1.2.3 |
| Verificação de licença | Página do módulo → Aba Licenças | go list -m -json path@v1.2.3 |
| Grafo de importadores | Página do módulo → Importado por | go list -deps ./... localmente |
| APIs depreciadas | Selo de símbolo na página de documentação | go vet ./... após a atualização |
| Documento | Quando abrir | Ação do SME |
|---|---|---|
doc/go1.N | Planejando um pequeno ajuste | Arquivar ADR de atualização com seções sinalizadas |
doc/godebug | O comportamento do runtime difere após a implantação | Registrar chaves GODEBUG de rollback |
doc/modules | Autenticação de módulo, retrações, workspaces | Alinhar CI e política de proxy |
doc/telemetry | Debates sobre opt-in de telemetria | Decidir política da organização separadamente do código |
cmd/go | Desvio de script após a atualização | Atualizar Makefile e GitHub Actions |
cmd/vet | Novas falhas na CI sem erros de compilação | Habilitar ou documentar exceções |
| Necessidade | Ler primeiro | Por quê |
|---|---|---|
| Analisador Vet adicionado | Notas de lançamento, seção Ferramentas | Texto exato de habilitação e falha |
| Narrativa de redesign do GC | Blog Go + Notas de lançamento, Runtime | O blog explica os trade-offs; as notas listam os padrões |
| Novo pacote da biblioteca padrão | Anúncio no blog | Padrões de migração e exemplos |
| Escopo da correção de segurança | Página de Segurança + Notas de lançamento | Vinculação de CVE e versões afetadas |
| Proposta aceita | Issue do GitHub + blog se for importante | A issue tem o texto da decisão final |
| Recurso | URL | Uso |
|---|---|---|
| Repositório principal do Go | https://github.com/golang/go | Issues, propostas, milestones |
| Consulta de label de proposta | https://github.com/golang/go/issues?q=label%3AProposal | Filtrar threads de design ativas |
| Documento do processo de proposta | https://go.dev/s/proposal | Passos para arquivar e iterar |
| Gerrit (contribuições) | https://go-review.googlesource.com | Revisar CLs upstream |
| Repositórios x/* | https://github.com/orgs/golang/repositories | Subsistemas separados da árvore principal |
# Abrir documentação para um símbolo no terminal
go doc net/http.Server.Shutdown
# Baixar documentação do módulo para máquinas offline (opcional)
go install golang.org/x/tools/cmd/godoc@latest
# Listar versões de módulos disponíveis
go list -m -versions example.com/lib
# Verificar relatório de vulnerabilidade para o workspace
govulncheck ./...| Etapa | Recurso | Tempo estimado |
|---|---|---|
| 1 | Introdução + Ports do doc/go1.N | 10 min |
| 2 | Ferramentas + go vet | 15 min |
| 3 | Runtime / GC / GODEBUG | 15 min |
| 4 | Pacotes da biblioteca padrão que você importa | 20 min |
| 5 | Postagem do blog se linkado nas notas | 10 min |
| 6 | Atualizar cheatsheets internas | 30 min |
go.dev é o domínio canônico atual.
Links antigos do golang.org geralmente redirecionam; prefira go.dev em novas documentações.
pkg.go.dev suporta versões de módulos, licenças e contexto de vulnerabilidade.
godoc.org é legado para muitos fluxos de trabalho.
Use-as apenas para estudo.
Verifique símbolos e comportamento no pkg.go.dev na sua versão fixada.
Veja go.dev/ref/mod#workspaces linkado no hub de documentação de módulos.
Recursos importantes geralmente recebem posts no blog a cada minor.
Lançamentos de patch podem ter apenas notas; ainda assim, leia os avisos de segurança prontamente.
O Playground não pode abrir rede arbitrária ou todos os pacotes.
Mantenha os repros apenas com a biblioteca padrão ou compartilhe repros baseados em módulos nos issues em vez disso.
Link para URLs versionadas do pkg.go.dev e a âncora específica de doc/go1.N.
Inclua a data em que você as revisou.
Sim, para muitos pacotes.
Ainda confirme com go doc local quando as tags controlam suas matrizes de build.
No go.dev, em documentação e na página doc/telemetry.
Distinto da documentação de observabilidade de aplicativos em seus serviços.
golangci-lint envolve go vet e analisadores de terceiros.
Quando o vet muda nas notas de lançamento, atualize também a documentação da configuração do linter.
Versões de Stack: Esta página foi escrita para Go 1.26.x (padrão Green Tea GC, modernizadores go fix - verifique o patch na compilação), chi (última versão - verifique na compilação), gin (última versão - verifique na compilação), echo (última versão - verifique na compilação), google.golang.org/grpc (última versão - verifique na compilação), sigs.k8s.io/controller-runtime (última versão - verifique na compilação), kubebuilder (última versão - verifique na compilação), tinygo (última versão - verifique os alvos de placa na compilação), wazero (última versão - verifique na compilação) e golangci-lint (última versão - verifique o conjunto de linters na compilação).
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026