Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Introdução ao GitHub Copilot no Visual Studio Code

Saiba como instalar o GitHub Copilot no Visual Studio Code,e passar a ver sugestões enquanto escreve comentários e códigos.

GitHub Copilot está disponível para clientes GitHub com uma conta pessoal nas organizações GitHub.com e GitHub Enterprise Cloud pertencentes a uma conta corporativa.

O GitHub Copilot é gratuito para uso de alunos, professores e mantenedores verificados de projetos populares de software livre. Se você não for aluno, professor nem mantenedor de um projeto popular de software livre, experimente o GitHub Copilot gratuitamente com uma avaliação única de 60 dias. Após a avaliação gratuita, você precisará de uma assinatura paga para uso contínuo. Para obter mais informações, confira "Sobre a cobrança de GitHub Copilot".

Experimente o GitHub Copilot

Sobre o GitHub Copilot e o Visual Studio Code

O GitHub Copilot oferece sugestões de preenchimento automático de um programador de par de IA à medida que você cria o código. Para ver mais informações, confira "Sobre o GitHub Copilot".

Usando o Visual Studio Code, você pode ver e incorporar sugestões do GitHub Copilot diretamente no editor. Este guia demonstra como usar o GitHub Copilot dentro do Visual Studio Code para macOS, Windows ou Linux.

Pré-requisitos

Como instalar a extensão Visual Studio Code

Para usar o GitHub Copilot, primeiro você precisa instalar a extensão Visual Studio Code.

  1. No Visual Studio Code Marketplace, acesse a página da extensão GitHub Copilot e clique em Instalar. Instalar a extensão Visual Studio Code do GitHub Copilot
  2. Um pop-up será exibido, solicitando que você abra o Visual Studio Code. Clique em Abrir o Visual Studio Code .
  3. Na guia "Extensão: GitHub Copilot" no Visual Studio Code, clique em Instalar. Botão de instalação no Visual Studio Code
  4. Se você ainda não tiver autorizado o Visual Studio Code na conta do GitHub, será solicitado que você entre no GitHub no Visual Studio Code.
    • Se você já tiver autorizado o Visual Studio Code para sua conta no GitHub, o GitHub Copilot será autorizado automaticamente. Captura da tela de autorização do Visual Studio Code
  5. No navegador, o GitHub solicitará as permissões necessárias para o GitHub Copilot. Para aprovar essas permissões, clique em Autorizar o Visual Studio Code .
  6. No Visual Studio Code, na caixa de diálogo "Visual Studio Code", para confirmar a autenticação, clique em Abrir.

Como ver a primeira sugestão

Observação: quando a detecção de duplicação está habilitada para o GitHub Copilot, há a possibilidade de você receber sugestões limitadas ou nenhuma sugestão ao usar os exemplos de código fornecidos. Como alternativa, é possível começar digitando seu próprio código a fim de ver sugestões do GitHub Copilot. Para saber mais sobre a detecção de duplicação, confira "Habilitar ou desabilitar a detecção de duplicação".

O GitHub Copilot oferece sugestões para várias linguagens e uma ampla variedade de estruturas, mas funciona melhor para Python, JavaScript, TypeScript, Ruby, Go, C# e C++. Os exemplos a seguir estão em JavaScript, mas as outras linguagens funcionarão da mesma forma.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
  2. No arquivo JavaScript, digite o cabeçalho da função a seguir. O GitHub Copilot vai sugerir automaticamente um corpo inteiro da função em texto esmaecido, como é mostrado abaixo. A sugestão exata pode variar.
    JavaScript
    function calculateDaysBetweenDates(begin, end) {
    Captura de tela de uma primeira sugestão Visual Studio Code 1. Para aceitar a sugestão, pressione Tab.

Como ver sugestões alternativas

Para qualquer entrada fornecida, GitHub Copilot podem oferecer várias sugestões. Você pode selecionar qual sugestão usar ou rejeitar todas as sugestões.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).

  2. No arquivo JavaScript, digite o cabeçalho da função a seguir. GitHub Copilot mostrará uma sugestão.

    JavaScript
    function calculateDaysBetweenDates(begin, end) {
  3. Opcionalmente, você pode ver sugestões alternativas, quando há alguma disponível.

    Sistema operacionalVer a próxima sugestãoVer a sugestão anterior
    macOSOpção (⌥) ou Alt+]Opção (⌥) ou Alt+[
    WindowsAlt+]Alt+[
    LinuxAlt+]Alt+[
  4. Como alternativa, você pode focalizar a sugestão para ver a paleta de comandos do GitHub Copilot e escolher sugestões.

  5. Para aceitar uma sugestão, pressione Tab. Para rejeitar todas as sugestões, pressione Esc.

Como ver várias sugestões em uma nova guia

Você pode não querer nenhuma das sugestões iniciais que o GitHub Copilot oferece. Você pode usar um atalho de teclado para solicitar que GitHub Copilot mostre várias sugestões em uma nova guia.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
  2. No arquivo JavaScript, digite o cabeçalho da função a seguir. GitHub Copilot mostrará uma sugestão.
    JavaScript
    function calculateDaysBetweenDates(begin, end) {
  3. Para abrir uma nova guia com várias opções adicionais, pressione Ctrl+Enter.
  4. Para aceitar uma sugestão, acima da sugestão, clique em Aceitar Solução. Para rejeitar todas as sugestões, feche a guia.

Como gerar sugestões de código por meio de comentários

Você pode descrever algo que deseja fazer usando linguagem natural em um comentário e o GitHub Copilot sugerirá o código para atingir sua meta.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
  2. No arquivo JavaScript, digite o comentário a seguir. O GitHub Copilot vai sugerir uma implementação da função.
    JavaScript
    // find all images without alternate text
    // and give them a red border
    function process() {

Como usar uma estrutura

Você também pode usar o GitHub Copilot para gerar sugestões de APIs e estruturas. O exemplo a seguir usa o GitHub Copilot para criar um servidor Express simples que retorna a hora atual.

  1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
  2. No arquivo JavaScript, digite o comentário a seguir e pressione Enter. O GitHub Copilot vai sugerir uma implementação do aplicativo Express.
    JavaScript
    // Express server on port 3000
  3. To accept each line, press Tab, then Enter.
  4. Type the following comment and then press Enter. GitHub Copilot will suggest an implementation for the default handler.
    JavaScript
    // Return the current time
  5. Para aceitar cada linha, pressione Tab.

Como habilitar ou desabilitar o GitHub Copilot

Você pode habilitar ou desabilitar o GitHub Copilot de dentro do Visual Studio Code. O ícone de status do GitHub Copilot no painel inferior da janela do Visual Studio Code indica se o GitHub Copilot está habilitado ou desabilitado. Quando ele estiver habilitado, a cor da tela de fundo do ícone corresponderá à cor da barra de status. Quando ele estiver desabilitado, a cor da tela de fundo do ícone se contrastará com a cor da barra de status.

  1. Para habilitar ou desabilitar o GitHub Copilot, clique no ícone de status no painel inferior da janela do Visual Studio Code. Captura de tela do ícone de status no Visual Studio Code

  2. Quando você estiver desabilitando o GitHub Copilot, será perguntado se deseja desabilitar as sugestões globalmente ou para a linguagem do arquivo em edição no momento.

    • Para desabilitar as sugestões do GitHub Copilot globalmente, clique em Desabilitar Globalmente.
    • Para desabilitar as sugestões do GitHub Copilot para a linguagem especificada, clique em Desabilitar para LINGUAGEM. Captura de tela da opção para desabilitar o GitHub Copilot globalmente ou para a linguagem atual

Leitura adicional