Documentação

A linguagem de programação Go é um projeto de código aberto para tornar os programadores mais produtivos.

Go é expressiva, concisa, limpa e eficiente. Seus mecanismos de concorrência facilitam escrever programas que aproveitam ao máximo máquinas multicore e em rede, enquanto seu sistema de tipos inovador permite construir programas flexíveis e modulares. Go compila rapidamente para código de máquina, mas tem a conveniência do coletor de lixo e o poder da reflexão em tempo de execução. É uma linguagem compilada, de tipagem estática e rápida, que tem a sensação de uma linguagem interpretada de tipagem dinâmica.

Primeiros passos

Instalando o Go

Instruções para baixar e instalar o Go.

Tutorial: Primeiros passos

Um tutorial breve de Olá, Mundo para começar. Aprenda um pouco sobre código Go, ferramentas, pacotes e módulos.

Tutorial: Criar um módulo

Um tutorial com tópicos curtos que apresentam funções, tratamento de erros, arrays, maps, testes unitários e compilação.

Tutorial: Primeiros passos com workspaces de múltiplos módulos

Apresenta o básico de criar e usar workspaces de múltiplos módulos em Go. Workspaces de múltiplos módulos são úteis para fazer mudanças em vários módulos ao mesmo tempo.

Tutorial: Desenvolvendo uma API RESTful com Go e Gin

Apresenta o básico de escrever uma API de serviço web RESTful com Go e o framework web Gin.

Tutorial: Primeiros passos com generics

Com generics, você pode declarar e usar funções ou tipos escritos para funcionar com qualquer um de um conjunto de tipos fornecidos pelo código que os chama.

Tutorial: Primeiros passos com fuzzing

Fuzzing pode gerar entradas para seus testes que podem pegar casos de borda e problemas de segurança que você talvez tenha deixado passar.

Escrevendo aplicações web

Como construir uma aplicação web simples.

Como escrever código Go

Este documento explica como desenvolver um conjunto simples de pacotes Go dentro de um módulo, e mostra como usar o go comando para compilar e testar pacotes.

Um tour por Go

Uma introdução interativa ao Go em quatro seções. A primeira seção cobre sintaxe básica e estruturas de dados; a segunda trata de métodos e interfaces; a terceira fala sobre Generics; e a quarta apresenta as primitivas de concorrência do Go. Cada seção termina com alguns exercícios para você praticar o que aprendeu. Você pode fazer o tour online ou instalá-lo localmente com:

	$ go install golang.org/x/website/tour@latest
	

Isso vai colocar o binário tour no diretório bin do seu GOPATH.

Usando e entendendo Go

Effective Go

Um documento com dicas para escrever código Go claro e idiomático. Leitura obrigatória para quem está começando em Go. Ele complementa o tour e a especificação da linguagem, que devem ser lidos antes.

Perguntas frequentes (FAQ)

Respostas para perguntas comuns sobre Go.

Plugins de editor e IDEs

Um documento que resume plugins de editor e IDEs comumente usados com suporte a Go.

Diagnósticos

Resume ferramentas e metodologias para diagnosticar problemas em programas Go.

Um guia do coletor de lixo do Go

Um documento que descreve como o Go gerencia memória e como aproveitá-la ao máximo.

Gerenciando dependências

Quando seu código usa pacotes externos, esses pacotes (distribuídos como módulos) se tornam dependências.

Fuzzing

Página principal da documentação de fuzzing em Go.

Cobertura para aplicações Go

Página principal da documentação de testes de cobertura de aplicações Go.

Otimização guiada por perfil

Página principal da documentação de otimização guiada por perfil (PGO) de aplicações Go.

Guia de migração para encoding/json/v2

Guia para migrar com segurança, passo a passo, de encoding/json para encoding/json/v2.

Referências

Documentação dos pacotes

A documentação da biblioteca padrão do Go.

Documentação dos comandos

A documentação das ferramentas do Go.

Especificação da linguagem

A especificação oficial da linguagem Go.

Referência de módulos Go

Um manual de referência detalhado do sistema de gerenciamento de dependências do Go.

Referência do arquivo go.mod

Referência das diretivas incluídas em um arquivo go.mod.

O modelo de memória do Go

Um documento que especifica as condições sob as quais leituras de uma variável em uma goroutine podem ter a garantia de observar valores produzidos por escritas na mesma variável em outra goroutine.

Guia de contribuição

Como contribuir com o Go.

Histórico de versões

Um resumo das mudanças entre as versões do Go.

Acessando bancos de dados

Tutorial: Acessando um banco de dados relacional

Apresenta o básico de acessar um banco de dados relacional usando Go e o pacote database/sql da biblioteca padrão.

Acessando bancos de dados relacionais

Uma visão geral dos recursos de acesso a dados do Go.

Abrindo um handle de banco de dados

Você usa o handle de banco de dados do Go para executar operações no banco. Depois de abrir um handle com as propriedades de conexão, ele representa um pool de conexões que é gerenciado em seu nome.

Executando instruções SQL que não retornam dados

Para operações SQL que podem alterar o banco, incluindo INSERT, UPDATE e DELETE do SQL, você usa os métodos Exec.

Consultando dados

Para instruções SELECT que retornam dados de uma consulta, use o método Query ou QueryRow.

Usando prepared statements

Definir um prepared statement para uso repetido pode fazer seu código rodar um pouco mais rápido, evitando o custo de recriar a instrução a cada vez que o código executa a operação no banco.

Executando transações

sql.Tx exporta métodos que representam a semântica específica de transações, incluindo Commit e Rollback, além dos métodos que você usa para executar operações comuns no banco.

Cancelando operações de banco de dados em andamento

Usando context.Context, você pode fazer com que as chamadas de função e os serviços da sua aplicação parem antes e retornem um erro quando o processamento não for mais necessário.

Gerenciando conexões

Em alguns programas avançados, você pode precisar ajustar os parâmetros do pool de conexões ou trabalhar com as conexões explicitamente.

Evitando o risco de SQL injection

Você pode evitar o risco de SQL injection passando os valores dos parâmetros SQL como argumentos das funções do pacote sql

Desenvolvendo módulos

Desenvolvendo e publicando módulos

Você pode reunir pacotes relacionados em módulos e depois publicar os módulos para que outros desenvolvedores os usem. Este tópico apresenta uma visão geral de desenvolver e publicar módulos.

Fluxo de lançamento e versionamento de módulos

Quando você desenvolve módulos para uso por outros desenvolvedores, pode seguir um fluxo que ajuda a garantir uma experiência confiável e consistente para quem usa o módulo. Este tópico descreve os passos de alto nível desse fluxo.

Gerenciando o código-fonte do módulo

Quando você desenvolve módulos para publicar para outras pessoas usarem, pode ajudar a garantir que eles sejam mais fáceis de usar seguindo as convenções de repositório descritas neste tópico.

Organizando um módulo Go

Qual é a forma certa de organizar os arquivos e diretórios em um projeto Go típico? Este tópico discute alguns layouts comuns, dependendo do tipo de módulo que você tem.

Desenvolvendo uma atualização de versão maior

Uma atualização de versão maior pode ser muito disruptiva para os usuários do seu módulo, porque inclui mudanças incompatíveis e representa um novo módulo. Saiba mais neste tópico.

Publicando um módulo

Quando você quer disponibilizar um módulo para outros desenvolvedores, você o publica para que ele fique visível para as ferramentas do Go. Depois de publicar o módulo, os desenvolvedores que importarem seus pacotes conseguirão resolver a dependência do módulo executando comandos como go get.

Numeração de versões de módulos

O desenvolvedor do módulo usa cada parte do número de versão para sinalizar a estabilidade e a compatibilidade retroativa da versão. A cada nova release, o número de versão reflete especificamente a natureza das mudanças no módulo desde a release anterior.

Palestras

Um tour em vídeo pelo Go

Três coisas que tornam o Go rápido, divertido e produtivo: interfaces, reflexão e concorrência. Constrói um web crawler de brinquedo para demonstrar esses pontos.

Código que cresce com elegância

Um dos principais objetivos de design do Go é a adaptabilidade do código: deve ser fácil pegar um design simples e construir sobre ele de forma limpa e natural. Nesta palestra, Andrew Gerrand descreve um servidor simples de "roleta de chat" que pareia conexões TCP recebidas e, em seguida, usa os mecanismos de concorrência, as interfaces e a biblioteca padrão do Go para estendê-lo com uma interface web e outros recursos. Embora a função do programa mude drasticamente, a flexibilidade do Go preserva o design original enquanto ele cresce.

Padrões de concorrência em Go

Concorrência é a chave para projetar serviços de rede de alta performance. As primitivas de concorrência do Go (goroutines e channels) oferecem uma forma simples e eficiente de expressar execução concorrente. Nesta palestra, vemos como problemas complicados de concorrência podem ser resolvidos com elegância usando código Go simples.

Padrões avançados de concorrência em Go

Esta palestra expande a palestra Padrões de concorrência em Go para se aprofundar nas primitivas de concorrência do Go.

Mais

Veja o site de palestras sobre Go e a página da wiki para mais palestras sobre Go.

Codewalks

Tours guiados por programas Go.

Linguagem

Pacotes

Módulos

Ferramentas

Wiki

A Wiki do Go, mantida pela comunidade Go, inclui artigos sobre a linguagem Go, ferramentas e outros recursos.

Veja a página Learn na Wiki para mais recursos de aprendizado de Go.

Documentação em outros idiomas

Veja a página NonEnglish na Wiki para a documentação localizada.