Noções Básicas de Configuração de Ferramentas Go

10 exemplos para você começar com gopls e Depuração - 7 básicos e 3 intermediários.

Pré-requisitos

• Instale o Go 1.26.x ou posterior em go.dev/dl.
• Crie um módulo: mkdir tooling-demo && cd tooling-demo && go mod init example.com/tooling-demo.
• Certifique-se de que $(go env GOPATH)/bin esteja no seu PATH para que as ferramentas instaladas sejam encontradas.

go install golang.org/x/tools/gopls@latest
go install github.com/go-delve/delve/cmd/dlv@latest
go install golang.org/x/vuln/cmd/govulncheck@latest
go install honnef.co/go/tools/cmd/staticcheck@latest

Exemplos Básicos

1. Verifique se as ferramentas principais estão no PATH

Confirme se os binários do servidor de linguagem e do depurador são resolvidos antes de configurar um editor.

which gopls dlv
gopls version
dlv version

• go install coloca os binários em GOPATH/bin (geralmente ~/go/bin).
• Editores invocam gopls pelo nome; uma entrada PATH ausente resulta em "servidor de linguagem não encontrado".
• Fixe versões na documentação da equipe quando o CI e os laptops devem corresponder.

Relacionado: Ferramentas de Desenvolvimento Go: LSP, Depurador e Analisadores - como as peças se encaixam

2. Configurações mínimas de gopls para um módulo

Aponte o gopls para a raiz do seu módulo e ative a formatação ao salvar em configurações no estilo VS Code.

{
  "gopls": {
    "ui.semanticTokens": true,
    "formatting.gofumpt": true
  },
  "go.useLanguageServer": true
}

• Abra a pasta que contém go.mod, não um diretório pai com módulos não relacionados.
• formatting.gofumpt aplica formatação mais rigorosa do que apenas gofmt.
• Outros editores expõem as mesmas chaves em sua configuração de cliente LSP.

Relacionado: gopls: Navegação, Refatoração e Diagnósticos - recursos do editor alimentados por gopls

3. Execute go vet no módulo

go vet é integrado e não requer instalação extra.

go vet ./...

• Detecta erros comuns (verbos de formato Printf, código inalcançável, tags de struct).
• Execute no CI junto com os testes para uma linha de base sem configuração.
• golangci-lint pode incluir verificações de vet, mas go vet continua útil em scripts rápidos.

Relacionado: staticcheck & golangci-lint no CI - sobrepondo analisadores no CI

4. Primeira passagem do staticcheck

staticcheck encontra problemas de correção e desempenho além do vet.

staticcheck ./...

• Instale uma vez com go install honnef.co/go/tools/cmd/staticcheck@latest.
• Comece com verificações padrão; adicione -checks apenas quando precisar desabilitar uma regra específica temporariamente.
• Trate novas descobertas como trabalho de preenchimento, não como bloqueadores imediatos de CI em repositórios legados.

Relacionado: staticcheck & golangci-lint no CI - severidade e linhas de base

5. Verifique dependências com govulncheck

Verifique se as CVEs conhecidas afetam o código que você realmente importa.

govulncheck ./...

• Usa o banco de dados de vulnerabilidades Go; nenhuma chave de API necessária.
• A saída distingue "módulo afetado presente" de "símbolo vulnerável alcançável".
• Adicione ao CI após go test para que o download do módulo já esteja aquecido.

Relacionado: govulncheck para Vulnerabilidades de Dependência - triagem e fiação do CI

6. Depure um programa simples com Delve

Inicie o depurador em main.go e pare na entrada do programa.

# main.go: package main com func main()
dlv debug .

Dentro do REPL do dlv:

(dlv) break main.main
(dlv) continue
(dlv) next
(dlv) print x

• dlv debug compila com símbolos de depuração e inicia o processo sob o depurador.
• Use continue, next e step como comandos no estilo gdb.
• quit encerra a sessão.

Relacionado: Depurando com Delve - goroutines e attach remoto

7. Início rápido do golangci-lint

Execute um conjunto de linters agrupados com um único comando.

# instale uma vez
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
 
golangci-lint run ./...

• Cria ou usa .golangci.yml quando você personaliza os linters habilitados.
• Feedback local mais rápido do que habilitar cada analisador manualmente.
• Corresponda à configuração do CI com o arquivo commitado na raiz do repositório.

Relacionado: staticcheck & golangci-lint no CI - configuração e adoção

Exemplos Intermediários

8. Workspace multi-módulo do gopls (go.work)

Ao desenvolver uma biblioteca e um consumidor juntos, use um arquivo de workspace.

go work init ./app ./lib
go work use ./lib

Abra o diretório que contém go.work em seu editor para que o gopls resolva importações entre módulos.

• Sem go.work, substituições locais exigem diretivas replace em go.mod.
• gopls carrega todos os módulos listados em go.work para referências cruzadas.
• O CI ainda compila cada módulo; workspaces são principalmente uma ferramenta de ergonomia local.

Relacionado: Ferramentas de Desenvolvimento Go: LSP, Depurador e Analisadores - modelo de ferramentas monorepo

9. Delve headless para attach IDE

Execute o Delve escutando em uma porta para que VS Code ou GoLand se conectem remotamente.

dlv debug --headless --listen=:2345 --api-version=2 --accept-multiclient .

• As configurações de inicialização da IDE apontam para localhost:2345 com a API v2.
• Útil para depurar testes ou binários com sinalizadores de compilação personalizados.
• Não exponha a porta publicamente; ela concede controle total do processo.

Relacionado: Depurando com Delve - attach remoto e em contêiner

10. Semear uma configuração golangci-lint para CI

Faça o commit de um .golangci.yml mínimo para que laptops e CI compartilhem regras.

run:
  timeout: 5m
linters:
  enable:
    - govet
    - staticcheck
    - ineffassign
    - misspell
issues:
  max-issues-per-linter: 0
  max-same-issues: 0

• Comece com uma pequena lista de habilitação; expanda após a limpeza da linha de base.
• max-issues-per-linter: 0 falha a execução em qualquer descoberta - afrouxe durante a migração.
• Emparelhe com govulncheck em um trabalho de CI separado para CVEs de dependência.

Relacionado: Melhores Práticas de gopls e Ferramentas de Análise - higiene do editor e do CI

Versões da Pilha: Esta página foi escrita para Go 1.26.x (padrão GC Green Tea, 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).

Y29kZWd1aWRlcy5pb3xjZ2lvNDE1fDIwMjYwNw