Você tem várias janelas do VS Code abertas para diferentes projetos. Cada projeto precisa de configurações diferentes do Copilot. Um projeto usa Python e requer sugestões do Copilot para código de ciência de dados. Outro projeto usa JavaScript e precisa que o Copilot siga um guia de estilo rigoroso. Alternar manualmente as configurações do Copilot toda vez que você muda de projeto perde tempo e leva a erros. Este artigo mostra como criar perfis separados no VS Code. Cada perfil armazena sua própria configuração do Copilot. Você pode alternar entre perfis instantaneamente e manter cada projeto isolado.
Principais Conclusões: Copilot Específico por Projeto com Perfis do VS Code
- Paleta de comandos de perfil do VS Code: Crie um novo perfil executando “Preferências: Criar Perfil” na Paleta de Comandos (Ctrl+Shift+P).
- Configurações do Copilot por perfil: Ative ou desative o Copilot, altere sugestões inline e defina regras de nível de repositório de forma independente para cada perfil.
- Atalho para alternar perfis: Use Ctrl+Alt+P para abrir o seletor de perfis e trocar de perfil sem fechar ou reabrir o VS Code.
Como os Perfis do VS Code Funcionam com o GitHub Copilot
Os perfis do VS Code permitem criar conjuntos separados de configurações, extensões e atalhos de teclado. Cada perfil é uma configuração isolada que não afeta outros perfis. Quando você ativa o GitHub Copilot em um perfil, a extensão do Copilot é executada com as configurações armazenadas apenas naquele perfil. Isso significa que você pode ter o Copilot ativo em um perfil e desativado em outro. Você também pode definir diferentes modos de sugestão inline do Copilot, desabilitar o Copilot para certos tipos de arquivo ou carregar regras personalizadas de nível de repositório por perfil.
A extensão do Copilot em si não tem lógica ciente de perfil. Ela lê as configurações do perfil ativo do VS Code em tempo de execução. Quando você alterna perfis, o VS Code recarrega a extensão com as novas configurações. Isso é transparente para você. Você não precisa reiniciar o VS Code ou reinstalar a extensão. O sistema de perfis lida com a troca de configuração automaticamente.
Antes de começar, instale a extensão GitHub Copilot no perfil padrão. A extensão estará disponível em todos os perfis após a instalação. Você não precisa instalá-la separadamente para cada perfil. O sistema de perfis compartilha extensões entre perfis por padrão. Você pode alterar esse comportamento definindo a extensão como específica de perfil, mas para o Copilot isso não é necessário.
Crie um Perfil do VS Code para Cada Projeto
Você precisa de um perfil por tipo de projeto distinto. Por exemplo, crie um perfil chamado “Ciência de Dados” para notebooks Python e um perfil chamado “Desenvolvimento Web” para projetos JavaScript. Siga as etapas abaixo para criar cada perfil.
- Abra a Paleta de Comandos
Pressione Ctrl+Shift+P para abrir a Paleta de Comandos. Digite “Preferências: Criar Perfil” e selecione o comando na lista. Isso abre a caixa de diálogo de criação de perfil. - Nomeie o perfil
Na caixa de diálogo, insira um nome descritivo para o perfil. Use um nome que corresponda ao tipo de projeto, como “CienciaDados” ou “WebDev”. Clique no botão “Criar”. O VS Code cria o novo perfil e alterna para ele automaticamente. - Configure as configurações do Copilot para o perfil
Abra as Configurações pressionando Ctrl+, (vírgula). Digite “Copilot” na barra de pesquisa. Ajuste as configurações desejadas para este perfil. Por exemplo, defina “GitHub Copilot: Ativar Auto Completions” como ativado ou desativado. Defina “GitHub Copilot: Sugestão Inline” como ativado ou desativado. Essas configurações se aplicam apenas a este perfil. - Defina regras de nível de repositório, se necessário
Se o seu projeto exigir regras específicas do Copilot, crie um arquivo.github/copilot-instructions.mdna raiz do projeto. O Copilot lê este arquivo apenas quando o perfil ativo tem a pasta de trabalho correta aberta. As regras neste arquivo se aplicam àquele projeto independentemente do perfil. No entanto, as configurações de ativação/desativação do perfil substituem o arquivo. - Salve e teste o perfil
Abra um arquivo do projeto. Comece a digitar código. O Copilot deve se comportar de acordo com as configurações que você definiu. Se o Copilot não aparecer, verifique se a extensão está ativada no perfil. Você pode verificar isso abrindo a visualização de Extensões (Ctrl+Shift+X) e verificando o indicador de perfil ao lado da extensão do Copilot.
Repita o processo para cada tipo de projeto. Cada perfil armazena suas próprias configurações. Você pode criar até 50 perfis no VS Code.
Alterne Entre Perfis Rapidamente
Alternar perfis não exige fechar o VS Code ou reabrir o projeto. Use o seletor de perfis para mudar o perfil ativo em segundos.
- Abra o seletor de perfis
Pressione Ctrl+Alt+P. Uma lista suspensa aparece no topo da janela mostrando todos os seus perfis. - Selecione o perfil de destino
Clique no nome do perfil para o qual deseja alternar. O VS Code recarrega a janela com o novo perfil. A extensão do Copilot recarrega com as configurações do perfil selecionado. - Confirme as configurações do Copilot
Abra um arquivo do projeto. Comece a digitar. Verifique se o Copilot se comporta de acordo com as configurações do perfil. Se o comportamento estiver incorreto, abra as Configurações do perfil atual e ajuste as opções do Copilot.
Você também pode alternar perfis pela barra de status do VS Code. Clique no ícone de perfil no lado esquerdo da barra de status. Um menu aparece com todos os perfis. Selecione o desejado. Este método é útil se você prefere usar o mouse.
Erros Comuns ao Usar Copilot com Perfis
Extensão do Copilot Não Aparece no Novo Perfil
A extensão do Copilot é instalada globalmente por padrão. Se você não vir o ícone do Copilot na barra de status após alternar perfis, abra a visualização de Extensões. Procure pela extensão do Copilot. Se ela mostrar um ícone de perfil com uma barra, a extensão está desativada para este perfil. Clique no ícone de engrenagem ao lado da extensão e selecione “Ativar (Perfil)”. A extensão é ativada imediatamente.
Configurações do Copilot Não se Aplicam ao Projeto Atual
As configurações do Copilot são globais para o perfil, não por espaço de trabalho. Se você tiver vários espaços de trabalho abertos no mesmo perfil, todos compartilham as mesmas configurações do Copilot. Para isolar ainda mais as configurações, crie um perfil separado para cada espaço de trabalho. Abra o espaço de trabalho primeiro, depois crie um perfil enquanto esse espaço de trabalho estiver ativo. O VS Code salva a associação do espaço de trabalho com o perfil.
Regras do Copilot em Nível de Repositório São Ignoradas
O Copilot lê as regras de nível de repositório do arquivo .github/copilot-instructions.md apenas se o arquivo existir na raiz do espaço de trabalho aberto. Se você tiver o arquivo no local errado ou a raiz do espaço de trabalho for diferente, o Copilot ignora as regras. Verifique se o arquivo está no caminho exato .github/copilot-instructions.md relativo à raiz do espaço de trabalho. Também verifique se o perfil tem o Copilot ativado. Copilot desativado ignora todas as regras.
Configurações do Perfil São Redefinidas Após uma Atualização do VS Code
As atualizações do VS Code preservam as configurações do perfil. No entanto, se você usar uma versão de pré-visualização ou uma compilação noturna, as configurações podem ser redefinidas. Para proteger seus perfis, exporte-os regularmente. Abra a Paleta de Comandos e execute “Preferências: Exportar Perfil”. Salve o arquivo JSON. Se as configurações forem redefinidas, importe o perfil usando “Preferências: Importar Perfil”.
Recursos de Perfil do VS Code vs Configurações de Projeto do Copilot: Principais Diferenças
| Item | Recursos de Perfil do VS Code | Configurações de Projeto do Copilot |
|---|---|---|
| Escopo | Global para o perfil, aplica-se a todos os espaços de trabalho abertos nesse perfil | Por projeto via arquivo copilot-instructions.md na raiz do repositório |
| Método de configuração | Interface de Configurações ou settings.json | Arquivo Markdown com front matter YAML específico |
| Mecanismo de alternância | Seletor de perfis (Ctrl+Alt+P) ou clique na barra de status | Nenhuma alternância necessária; as regras são lidas automaticamente quando o arquivo está presente |
| Granularidade | Pode ativar/desativar o Copilot completamente, alterar o modo de sugestão e definir exclusões por tipo de arquivo | Pode definir instruções personalizadas para estilo de código, uso de bibliotecas e convenções de nomenclatura |
| Persistência entre atualizações | Preservado a menos que seja excluído manualmente ou exportado | Preservado no repositório; controlado por versão |
| Compartilhamento com a equipe | Exporte o JSON do perfil e compartilhe via controle de versão ou arquivo | Faça commit do arquivo copilot-instructions.md no repositório |
Use os perfis do VS Code para controlar a ativação e o comportamento de sugestão do Copilot. Use as configurações de nível de repositório para definir regras de codificação específicas do projeto. Os dois sistemas funcionam juntos. Por exemplo, você pode ter um perfil que ativa o Copilot para um projeto de ciência de dados e um arquivo copilot-instructions.md que instrui o Copilot a preferir funções pandas em vez de loops Python puros.
Agora você pode criar perfis separados do VS Code para diferentes projetos e configurar o Copilot de forma independente em cada perfil. Comece criando um perfil para o tipo de projeto mais comum. Defina as opções do Copilot de acordo com os requisitos do projeto. Alterne entre perfis usando Ctrl+Alt+P. Para projetos em equipe, adicione um arquivo copilot-instructions.md ao repositório para impor regras de codificação consistentes. Uma dica avançada: use a configuração “GitHub Copilot: Ativar Auto Completions” em cada perfil para desabilitar sugestões para arquivos sensíveis, como arquivos de configuração contendo segredos, definindo o valor como falso e adicionando um padrão de exclusão de arquivo no settings.json.