Você quer executar seus testes de unidade rapidamente sem configurar manualmente cada framework de teste no VS Code. O Test Explorer pode descobrir e executar testes automaticamente, mas configurá-lo para projetos complexos geralmente exige editar arquivos launch.json ou tasks.json. Este artigo mostra como o GitHub Copilot pode gerar a configuração de teste correta para seu projeto, fazendo com que o Test Explorer detecte seus testes imediatamente.
O Test Explorer depende das configurações de extensão do VS Code e de adaptadores específicos de framework para encontrar arquivos de teste. Quando o Copilot gera essas configurações, ele lê a estrutura do seu projeto e sugere os caminhos de adaptador corretos, padrões de arquivos de teste e variáveis de ambiente. Você aprenderá as etapas exatas para solicitar ao Copilot dentro do VS Code, aplicar a configuração gerada e verificar se o Test Explorer lista todos os seus casos de teste.
Ao final deste guia, você poderá configurar a descoberta de testes para qualquer linguagem ou framework sem tentativa e erro manual. Você também saberá como lidar com casos especiais como monorepos e projetos com várias linguagens.
Principais Aprendizados: Usando o Copilot para Configurar o Test Explorer
- Copilot Chat > /fix ou /configure: Use esses comandos de barra para gerar configurações de adaptador de teste para a linguagem do seu projeto.
- settings.json > testExplorer.useNativeTesting: Alterne esta opção para ativar a descoberta nativa de testes sem extensões de terceiros.
- Barra lateral do Test Explorer > ícone de engrenagem: Abre o arquivo de configuração onde o Copilot insere o código gerado.
Como o Test Explorer Descobre Testes e Por Que o Copilot Ajuda
A barra lateral do Test Explorer do VS Code não verifica seu projeto por padrão. Ela depende de uma extensão de adaptador de teste que sabe como interpretar seu framework de teste. Por exemplo, a extensão Python Test Explorer procura por arquivos chamados test_py ou _test.py e executa pytest ou unittest. As configurações do adaptador ficam no arquivo .vscode/settings.json do seu workspace.
Quando você trabalha com vários frameworks de teste ou um monorepo, a configuração se torna complexa. Você precisa especificar o caminho correto do framework de teste, variáveis de ambiente e padrões de exclusão de arquivos. O Copilot pode inspecionar a estrutura do seu projeto e sugerir as configurações JSON ou YAML exatas necessárias. Ele usa a mesma lógica que um desenvolvedor humano aplicaria, mas completa a tarefa em segundos.
O Copilot também ajuda quando você alterna entre projetos. Em vez de lembrar a sintaxe exata do adaptador para Jest, Mocha, PyTest ou NUnit, você descreve seu projeto em português claro e o Copilot escreve a configuração. Isso reduz o tempo de configuração e elimina erros de sintaxe que impedem a descoberta de testes.
Passos para Configurar o Test Explorer com o Copilot
Siga estes passos para deixar o Copilot gerar as configurações do adaptador de teste para seu projeto. O processo funciona para JavaScript, Python, C#, Java e a maioria das outras linguagens suportadas pelos adaptadores de teste do VS Code.
- Abra o painel Copilot Chat
Pressione Ctrl+Shift+I no Windows ou Cmd+Shift+I no macOS para abrir o Copilot Chat. Se você usar o chat inline, pressione Ctrl+I ou Cmd+I dentro do arquivo settings.json. - Descreva seu projeto e framework de teste
Digite um prompt como:Configure o test explorer para um projeto Python usando pytest. Os testes estão na pasta tests/. Use unittest como fallback.O Copilot gerará as configurações JSON necessárias para seu workspace. - Revise as configurações geradas
O Copilot produz código JSON. Procure porpython.testing.pytestEnabled,python.testing.unittestEnabledepython.testing.cwd. Verifique se os caminhos correspondem à estrutura do seu projeto. - Aplique as configurações ao seu workspace
Clique no botão Inserir em settings.json que aparece na resposta do Copilot Chat. Se o botão não aparecer, copie o código manualmente e cole em.vscode/settings.json. - Recarregue a barra lateral do Test Explorer
Clique no ícone Recarregar na barra de ferramentas do Test Explorer ou pressione Ctrl+Shift+P e execute Desenvolvedor: Recarregar Janela. A barra lateral agora deve mostrar seus arquivos de teste e casos de teste. - Execute um teste para confirmar a descoberta
Clique no ícone de play ao lado de qualquer teste no Test Explorer. Se o teste passar, a configuração está correta. Se o teste falhar com um erro de framework, verifique a versão do adaptador e os caminhos dos arquivos de teste.
Usando o Copilot para um Projeto JavaScript com Jest
Para um projeto JavaScript ou TypeScript usando Jest, solicite ao Copilot: Configure a descoberta de testes Jest no VS Code. Os testes estão em src/__tests__/ e usam a extensão .test.js. O Copilot gerará configurações que ativam a extensão Jest Test Explorer e definem o padrão de arquivos de teste. Aplique as configurações em .vscode/settings.json e recarregue o Test Explorer.
Usando o Copilot para um Projeto C# com NUnit
Para projetos .NET usando NUnit, solicite ao Copilot: Configure o adaptador de teste .NET para NUnit. O projeto está na pasta src/MyProject.Tests. Use dotnet test. O Copilot pode sugerir adicionar a configuração .vscode/tasks.json para dotnet test e a configuração csharp.testExplorer.nunit.enabled. Insira o código e recarregue o workspace.
Problemas Comuns Quando o Copilot Gera Configuração de Teste
Mesmo com o Copilot, você pode encontrar problemas que impedem a descoberta de testes. Os problemas mais frequentes envolvem extensões ausentes, padrões de arquivo incorretos ou variáveis de ambiente que o Copilot não consegue inferir. Abaixo estão os problemas mais comuns e suas correções.
Test Explorer Não Mostra Testes Após a Configuração
Isso geralmente significa que a extensão do adaptador de teste não está instalada ou o padrão de arquivo não corresponde. Primeiro, instale o adaptador de teste correto para sua linguagem. Para Python, instale Python Test Explorer for Visual Studio Code. Para JavaScript, instale Jest Test Explorer ou Mocha Test Explorer. Em seguida, verifique o padrão de arquivo gerado. O Copilot pode usar um padrão como /test_py, mas seus arquivos podem usar uma convenção de nomenclatura diferente. Edite o padrão manualmente em settings.json para corresponder aos seus arquivos.
Copilot Gera Configurações para o Framework Errado
Se seu projeto usa vários frameworks de teste, o Copilot pode adivinhar o errado. Seja explícito em seu prompt. Por exemplo, diga Use apenas pytest, não unittest ou Configure Jest, não Mocha. Se as configurações geradas ainda contiverem o framework errado, exclua as chaves incorretas e peça ao Copilot para regenerar com um prompt mais específico.
Variáveis de Ambiente Não Configuradas Corretamente
Alguns frameworks de teste exigem variáveis de ambiente para encontrar bancos de dados de teste ou endpoints de API. O Copilot não pode ver suas variáveis de ambiente do sistema. Após o Copilot gerar a configuração, abra .vscode/launch.json e adicione um bloco env com as variáveis necessárias. Por exemplo, adicione "env": {"DATABASE_URL": "localhost:5432/testdb"}.
Copilot Chat vs Copilot Inline para Configuração de Teste
| Item | Copilot Chat | Copilot Inline |
|---|---|---|
| Método de acesso | Ctrl+Shift+I ou Cmd+Shift+I | Ctrl+I ou Cmd+I dentro de um arquivo |
| Melhor para | Gerar blocos de configuração completos do zero | Editar pequenas seções de um settings.json existente |
| Formato de saída | JSON ou YAML completo com botão Inserir | Linha única ou trecho curto |
| Consciência de contexto | Lê toda a estrutura do workspace | Lê apenas o arquivo aberto e a posição do cursor |
| Confiabilidade para projetos com múltiplos frameworks | Alta, pois vê todos os arquivos no workspace | Média, pois pode perder arquivos não referenciados no arquivo aberto |
Use o Copilot Chat quando precisar de uma configuração completa para um novo projeto. Use o Copilot Inline quando precisar ajustar um padrão existente ou adicionar uma configuração ausente.
Conclusão
Agora você pode configurar a descoberta de testes do Test Explorer do VS Code usando configurações geradas pelo Copilot para qualquer framework suportado. O segredo é descrever claramente a estrutura do seu projeto e o framework de teste no prompt do Copilot Chat. Após aplicar as configurações, sempre recarregue a janela e execute um teste para confirmar que a descoberta funciona.
Para projetos monorepo, tente solicitar ao Copilot com Configure o test explorer para um monorepo com testes Python em packages/backend/tests e testes JavaScript em packages/frontend/__tests__. O Copilot gerará configurações de adaptador separadas para cada subpasta. Essa abordagem economiza horas de configuração manual quando você trabalha com bases de código grandes.