GitHub Copilot no Rider: Notas de Configuração para C# e .NET

Configurar o GitHub Copilot no JetBrains Rider para desenvolvimento C# e .NET exige etapas específicas além da instalação padrão. Muitos desenvolvedores percebem que as sugestões do Copilot são lentas, incompletas ou simplesmente não aparecem para código .NET. Isso acontece porque o Rider precisa se conectar ao GitHub Copilot por meio de um plugin, que depende da autenticação correta e das configurações de indexação. Este artigo explica como instalar o plugin do GitHub Copilot no Rider, autenticar sua conta do GitHub e configurar o Rider para obter completações de código C# e .NET ideais.

Como o GitHub Copilot Funciona no Rider para C# e .NET

O GitHub Copilot é um programador parceiro de IA que sugere trechos de código e funções inteiras com base no contexto do arquivo atual. No Rider, o Copilot opera por meio de um plugin dedicado que se comunica com os servidores do GitHub. O plugin analisa seus arquivos C# abertos, arquivos de projeto .csproj e quaisquer referências do .NET Framework para gerar sugestões relevantes. Os pré-requisitos incluem uma assinatura ativa do GitHub Copilot (Individual, Business ou Enterprise) e o JetBrains Rider 2022.3 ou posterior. O plugin funciona com projetos .NET Framework 4.7.2+ e .NET 6.0+, incluindo aplicações ASP.NET Core, Blazor e MAUI.

Passos para Instalar e Configurar o GitHub Copilot no Rider

Método 1: Instalando o Plugin do JetBrains Marketplace

1. Abra o Rider e acesse Configurações
   Pressione Ctrl+Alt+S para abrir a janela de Configurações. Alternativamente, vá em Arquivo > Configurações no Windows ou Rider > Preferências no macOS.
2. Navegue até Plugins
   No painel esquerdo, selecione Plugins. Em seguida, clique na aba Marketplace no topo da janela de Plugins.
3. Pesquise por GitHub Copilot
   Digite “GitHub Copilot” na caixa de pesquisa. O plugin oficial da GitHub aparece primeiro. Clique em Instalar ao lado da entrada do plugin.
4. Reinicie o Rider
   Após a instalação, clique no botão Reiniciar IDE. O Rider reinicia e carrega o plugin.

Método 2: Autenticando com Sua Conta GitHub

1. Abra a janela de ferramentas do GitHub Copilot
   Após reiniciar, vá em Ferramentas > GitHub Copilot > Mostrar Status do Copilot. Uma janela de ferramentas abre no canto inferior direito.
2. Clique no botão Entrar
   Na janela de ferramentas, clique em Entrar. O Rider abre seu navegador padrão para a página de autorização do GitHub.
3. Autorize o plugin GitHub Copilot
   Faça login na sua conta GitHub, se solicitado. Clique em Autorizar JetBrains Rider para conceder ao plugin acesso à sua assinatura do Copilot.
4. Volte ao Rider
   Após a autorização, uma página de confirmação aparece. Volte ao Rider. A janela de ferramentas agora mostra uma marca de verificação verde e seu nome de usuário do GitHub.

Método 3: Ativando Completations para Arquivos C# e .NET

1. Abra as configurações do Copilot
   Vá em Ferramentas > GitHub Copilot > Ativar Completations. Certifique-se de que esta opção esteja marcada. Se não estiver, o Copilot não fornecerá sugestões.
2. Ajuste o comportamento das sugestões
   Vá em Configurações > Ferramentas > GitHub Copilot. Em Completations, defina Atraso da sugestão como Rápido para sugestões imediatas ou Médio para um leve atraso. Para projetos .NET, Rápido funciona melhor para arquivos de solução grandes.
3. Teste com um arquivo C#
   Abra qualquer arquivo .cs em seu projeto. Digite um nome de método como public void CalcularTotal e pressione Enter. O Copilot sugere o corpo do método em texto cinza. Pressione Tab para aceitar.

Problemas Comuns de Configuração e Como Resolvê-los

Copilot Não Mostra Sugestões em Arquivos C#

Se o Copilot permanecer em silêncio apesar de instalado e autenticado, verifique o idioma do arquivo. O Rider deve reconhecer o arquivo como C#. Abra o arquivo e olhe no canto inferior direito da barra de status. Deve exibir “C#”. Se mostrar “Texto” ou outro idioma, clique e selecione C# na lista. Verifique também se o arquivo .cs faz parte de um projeto que compila com sucesso. O Copilot depende do contexto de compilação do projeto para gerar código relevante.

Copilot Mostra Sugestões para Frameworks Não .NET

Às vezes, o Copilot sugere trechos de JavaScript, Python ou outras linguagens dentro de arquivos C#. Isso acontece quando o plugin interpreta mal o contexto do arquivo. Para corrigir, feche todos os arquivos não C# no editor. O Copilot usa todo o conjunto de arquivos abertos como contexto. Certifique-se também de que a solução do Rider contenha apenas projetos .NET. Soluções com várias linguagens podem confundir o plugin.

Falha na Autenticação com Erro “Token Inválido”

Esse erro ocorre quando a assinatura do Copilot está inativa ou o token expirou. Vá para GitHub.com > Configurações > Copilot e confirme se o status da sua assinatura está como Ativo. Se a assinatura estiver ativa, revogue a autorização do Rider em Configurações do GitHub > Aplicativos > Aplicativos OAuth Autorizados e repita as etapas de autenticação no Rider.

GitHub Copilot Free vs GitHub Copilot Pro vs GitHub Copilot Business para Rider

Item	Copilot Free	Copilot Pro	Copilot Business
Custo mensal	$0	$10 por usuário	$19 por usuário
Completations C# e .NET	Limitado a 300 sugestões por mês	Sugestões ilimitadas	Sugestões ilimitadas
Suporte a IDEs	Apenas Rider	Rider e todas as IDEs JetBrains	Rider e todas as IDEs JetBrains
Resumos de revisão de código	Não disponível	Disponível em pull requests	Disponível em pull requests
Tipos de arquivo excluídos	Nenhum	Nenhum	Administrador pode bloquear tipos específicos

Agora você pode instalar o plugin do GitHub Copilot no Rider, autenticar sua conta e ativar as completations para projetos C# e .NET. Comece abrindo um arquivo .cs e digitando um padrão comum, como uma consulta LINQ ou um construtor, para ver sugestões. Para soluções grandes com muitos projetos, considere aumentar o limite de memória do Rider em Ajuda > Editar Opções Personalizadas da VM para evitar lentidão no desempenho.