A extensão VS Code Go fornece suporte de linguagem avançado para a linguagem de programação Go.
Visual Studio Code 1.75 ou mais recente (ou editores compatíveis com APIs do VS Code 1.75+)
Vá para 1.21 ou mais recente.
Bem-vindo! ??
Quer você seja novo no Go ou um desenvolvedor Go experiente, esperamos que esta extensão atenda às suas necessidades e aprimore sua experiência de desenvolvimento.
Instale o Go 1.21 ou mais recente, caso ainda não o tenha feito.
Instale a extensão VS Code Go.
Abra qualquer arquivo Go ou arquivo go.mod para ativar automaticamente a extensão. A barra de status do Go aparece no canto inferior direito da janela e exibe sua versão do Go.
A extensão depende de go
, gopls
(o servidor de linguagem Go) e de ferramentas opcionais dependendo de suas configurações. Se gopls
estiver faltando, a extensão tentará instalá-lo. O sinal ⚡ próximo à versão Go indica que o servidor de idioma está em execução e você está pronto para começar.
(Instalar ferramentas ausentes)
Você está pronto para ir :-) ???
Explore mais recursos da extensão VS Code Go.
Veja a documentação de configurações e os tópicos avançados para personalizar a extensão.
Consulte a documentação das ferramentas para obter uma lista completa de ferramentas das quais a extensão VS Code Go depende. Você pode instalar ferramentas adicionais e atualizá-las usando "Go: Install/Update Tools".
Resolva problemas com os guias de solução de problemas gerais e de depuração.
registre um problema por problemas com a extensão.
Inicie uma discussão no GitHub ou obtenha ajuda no Stack Overflow.
Explore os recursos da linguagem Go em go.dev/learn e golang.org/help.
Se você é novo no Go, este artigo fornece uma visão geral da organização do código Go e dos comandos go
básicos. Assista a "Introdução ao VS Code Go" para obter uma explicação de como criar seu primeiro aplicativo Go usando o VS Code Go.
IntelliSense – Os resultados aparecem para símbolos conforme você digita.
Navegação de código - Vá ou dê uma olhada na declaração de um símbolo.
Edição de código – Suporte para trechos salvos, formatação e organização de código e organização automática de importações.
Diagnóstico - Erros de compilação, verificação e lint mostrados conforme você digita ou salva.
Suporte aprimorado para teste e depuração
Veja a análise completa dos recursos para obter mais detalhes.
(Preenchimento de código e ajuda de assinatura)
Além dos recursos de edição integrados, a extensão oferece diversos comandos para trabalhar com arquivos Go. Você pode acessar qualquer um deles abrindo a Paleta de Comandos ( Ctrl+Shift+P
no Linux/Windows e Cmd+Shift+P
no Mac) e digitando o nome do comando. Veja a lista completa de comandos fornecidos por esta extensão.
(Alternar arquivo de teste)
Para um melhor realce de sintaxe, recomendamos ativar o realce semântico ativando a configuração ui.semanticTokens
do Gopls. "gopls": { "ui.semanticTokens": true }
A extensão VS Code Go suporta os modos dos módulos GOPATH
e Go.
Os módulos Go são usados para gerenciar dependências em versões recentes do Go. Os módulos substituem a abordagem baseada em GOPATH
para especificar quais arquivos de origem são usados em uma determinada compilação e são o modo de compilação padrão em go1.16+. É altamente recomendável o desenvolvimento Go no modo de módulo. Se você estiver trabalhando em projetos existentes, considere migrar para módulos.
Ao contrário do modo GOPATH
tradicional, o modo módulo não requer que o espaço de trabalho esteja localizado em GOPATH
nem use uma estrutura específica. Um módulo é definido por uma árvore de diretórios de arquivos de origem Go com um arquivo go.mod
no diretório raiz da árvore.
Seu projeto pode envolver um ou mais módulos. Se estiver trabalhando com vários módulos ou layouts de projeto incomuns, você precisará configurar seu espaço de trabalho usando Pastas de Espaço de Trabalho. Consulte a documentação de layouts de espaço de trabalho suportados para obter mais informações.
Se desejar obter acesso antecipado a novos recursos e correções de bugs, você pode usar a extensão de pré-lançamento. Seguindo a convenção do vscode, usamos a versão secundária do número da versão da extensão para distinguir versões estáveis e de pré-lançamento ( 0.ODD_NUMBER.patch
para pré-lançamento, 0.EVEN_NUMBER.patch
para versão estável).
Para instalar a versão de pré-lançamento, use a lista suspensa para selecionar "Instalar versão de pré-lançamento" ou, se a extensão Go já estiver instalada, use a opção "Mudar para versão de pré-lançamento" no gerenciamento de extensão do Visual Studio Code página. Para obter mais detalhes sobre esse mecanismo, consulte a documentação do Visual Studio Code.
A extensão VS Code Go depende da telemetria Go para obter insights sobre o desempenho e a estabilidade da extensão e do servidor de linguagem ( gopls
). O upload de dados do Go Telemetry está desabilitado por padrão e pode ser habilitado com o seguinte comando:
go run golang.org/x/telemetry/cmd/gotelemetry@latest on
Depois que a telemetria for habilitada, o servidor de idiomas fará upload de métricas e rastreamentos de pilha para telemetry.go.dev. Você pode inspecionar quais dados são coletados e podem ser carregados executando:
go run golang.org/x/telemetry/cmd/gotelemetry@latest view
Se conseguirmos adoção suficiente, esses dados poderão avançar significativamente o ritmo de desenvolvimento da extensão Go e nos ajudar a atingir um padrão mais elevado de confiabilidade. Por exemplo:
Mesmo com relatórios de falhas semiautomáticos no VS Code, vimos vários crashers não serem relatados por semanas ou meses.
Mesmo com um conjunto de benchmarks, algumas regressões de desempenho não aparecem em nosso ambiente de benchmark (como o bug de conclusão mencionado abaixo!).
Mesmo com muitas ideias excelentes sobre como melhorar os gopls, temos recursos limitados. A telemetria pode nos ajudar a identificar quais novos recursos são mais importantes e quais recursos existentes não estão sendo usados ou não estão funcionando bem.
Estas são apenas algumas maneiras pelas quais a telemetria pode melhorar os gopls. A série de postagens do blog sobre telemetria contém muito mais.
A telemetria Go foi projetada para ser transparente e preservar a privacidade. Saiba mais em https://go.dev/doc/telemetry.
A extensão Go é mantida por engenheiros da equipe de ferramentas Go, que monitoram ativamente o VS Code Go e os rastreadores de problemas Go.
Oferecemos suporte apenas às versões estáveis e de pré-lançamento mais recentes da extensão.
A extensão Go segue a Política de Lançamento Go, o que significa que ela oferece suporte oficial aos dois lançamentos principais mais recentes do Go. A equipe Go mantém o melhor suporte para as últimas três versões principais do Go.
A extensão Go depende de ferramentas como gopls
e dlv
para suas funcionalidades principais e elas têm sua própria política e cronograma de lançamento. Testamos apenas as versões mais recentes dessas ferramentas.
Caso você precise trabalhar com uma versão mais antiga do Go, verifique a página Compatibilidade e instale manualmente a versão compatível da extensão e das ferramentas.
Agradecemos suas contribuições e agradecemos por trabalhar para melhorar a experiência de desenvolvimento Go no VS Code. Se você quiser ajudar a trabalhar na extensão VS Code Go, consulte nosso guia de contribuição para aprender como construir e executar a extensão VS Code Go localmente e contribuir com o projeto.
Este projeto segue o Código de Conduta da Comunidade Go. Se você encontrar um problema relacionado à conduta, envie um e-mail para [email protected].
MIT