Solução de problemas de instalação e atualização do Visual Studio
Aplica-se a:
Visual Studio 
Visual Studio para Mac Visual Studio Code
Importante
Está com problema para instalar? Podemos ajudá-lo. Oferecemos uma opção de suporte de chat de instalação (somente inglês).
Este guia de solução de problemas apresenta instruções passo a passo que resolvem a maioria dos problemas de instalação.
Instalações online
As etapas a seguir se aplicam a uma instalação online típica. Para uma instalação offline, consulte Como solucionar problemas de uma instalação offline.
Etapa 1 – Verificar se o problema é um problema conhecido
Existem alguns problemas conhecidos com o instalador do Visual Studio que a Microsoft está trabalhando para corrigir. Para saber se há uma solução para o problema, consulte a seção Problemas Conhecidos das nossas notas de versão.
Existem alguns problemas conhecidos com o instalador do Visual Studio que a Microsoft está trabalhando para corrigir. Verifique se o problema já está resolvido ou encontre soluções alternativas na seção Problemas Conhecidos de nossas notas de versão.
Etapa 2 – Tentar reparar o Visual Studio
O reparo corrige muitos problemas comuns de atualização. Para saber mais sobre quando e como reparar o Visual Studio, consulte Reparar o Visual Studio.
Etapa 3 – Verificar com a comunidade de desenvolvedores
Pesquise sua mensagem de erro na Comunidade de Desenvolvedores do Visual Studio. Outros membros da comunidade podem ter encontrado uma solução ou solução alternativa para o problema.
Etapa 4 – Excluir a pasta do Instalador do Visual Studio para corrigir problemas de atualização
O bootstrapper do Visual Studio é um executável leve que inicia a instalação do Instalador do Visual Studio e, em seguida, do produto do Visual Studio. Excluir os arquivos do Instalador do Visual Studio e executar novamente o bootstrapper resolve algumas falhas de atualização.
Observação
Executar as seguintes ações reinstalará os arquivos do Instalador do Visual Studio e redefinirá os metadados de instalação.
- Fechar o instalador do Visual Studio.
- Exclua o diretório de instalação do Instalador do Visual Studio. Normalmente, o diretório é
C:\Program Files (x86)\Microsoft Visual Studio\Installer. - Execute o bootstrapper do Visual Studio. Você pode encontrar o bootstrapper na pasta Downloads com um nome de arquivo que segue um padrão
vs_[Visual Studio edition]__*.exe. Se você não encontrar esse aplicativo, poderá baixar o bootstrapper acessando a página de downloads mais antigos do Visual Studio e clicando em Baixar para sua edição do Visual Studio. Em seguida, execute o arquivo executável para redefinir os metadados de instalação. - Tente instalar ou atualizar o Visual Studio. Se o Instalador continuar falhando, prossiga para o Relatório uma etapa de problema .
- Fechar o instalador do Visual Studio.
- Exclua a pasta do Instalador do Visual Studio. Normalmente, o caminho da pasta é
C:\Program Files (x86)\Microsoft Visual Studio\Installer. - Execute o bootstrapper de instalação do Visual Studio. Você pode encontrar o bootstrapper em sua pasta Downloads com um nome de arquivo que corresponda a um
vs_[Visual Studio edition]__*.exepadrão. Ou você pode baixar o bootstrapper para sua edição do Visual Studio na página de downloads do Visual Studio . Em seguida, execute o arquivo executável para redefinir os metadados de instalação. - Tente instalar ou atualizar o Visual Studio. Se o Instalador do Visual Studio continuar falhando, prossiga para o Relatório uma etapa de problema .
Etapa 5 – Relatar um problema
Em algumas situações, como quando há arquivos corrompidos, os problemas podem exigir solução de problemas caso a caso. Para nos ajudar a ajudá-lo, siga estas etapas:
- Colete os logs de configuração. Para saber mais detalhes, consulte Como obter os logs de instalação do Visual Studio.
- Abra o instalador do Visual Studio e clique em Relatar um problema para abrir a ferramenta de comentários do Visual Studio.
- Dê um título ao relatório de problemas e forneça detalhes relevantes. Clique em Avançar para ir até a seção Anexos e anexar o arquivo de log gerado (normalmente, o arquivo está em
%TEMP%\vslogs.zip). - Clique em Avançar para examinar o relatório de problemas e clique em Enviar.
- Colete os logs de configuração. Para saber mais detalhes, consulte Como obter os logs de instalação do Visual Studio.
- Abra o Instalador do Visual Studio e escolha Relatar um problema para abrir a ferramenta comentários do Visual Studio.
- Dê um título ao relatório de problemas e forneça os detalhes relevantes. O log de instalação mais recente do Instalador do Visual Studio é adicionado automaticamente à seção Anexos adicionais do relatório de problemas.
- Escolha Enviar.
Etapa 6 – Remover arquivos de instalação do Visual Studio
Como último recurso, você pode remover todos os arquivos de instalação do Visual Studio e informações do produto:
- Siga as etapas deste artigo: remover a página do Visual Studio .
- Execute novamente o bootstrapper do Instalador do Visual Studio. Você pode encontrar o bootstrapper em sua pasta Downloads com um nome de arquivo que corresponda a um
vs_[Visual Studio edition]__*.exepadrão. Ou você pode baixar o bootstrapper para sua edição do Visual Studio na página de downloads do Visual Studio . - Tente reinstalar o Visual Studio.
Etapa 7 – Entre em contato conosco (opcional)
Se nenhuma das etapas anteriores ajudá-lo a instalar ou a atualizar o Visual Studio, entre em contato conosco usando a nossa opção de suporte por chat ao vivo (somente em inglês) para obter mais assistência.
Instalações offline
Aqui estão alguns problemas conhecidos e soluções alternativas que podem ajudá-lo quando você cria uma instalação offline e instala a partir de um layout local.
| Problema | Solução |
|---|---|
| Os usuários não podem acessar arquivos | Certifique-se de ajustar as ACLs (permissões) para que elas concedam acesso de leitura a outros usuários antes de compartilhar a instalação offline. |
| Novas cargas de trabalho, componentes ou pacotes de idiomas não são instalados | Verifique se você tem acesso à Internet se você instalar a partir de um layout parcial e se selecionar cargas de trabalho, componentes ou idiomas que não foram baixados anteriormente para esse layout parcial. |
Para resolver problemas com uma instalação de rede, confira Solucionar problemas relacionados à rede ao instalar ou usar o Visual Studio.
Atualizações de administrador
As atualizações de administrador podem não ser aplicadas corretamente devido a uma vareity de situações. Consulte as atualizações de administrador que solucionam problemas de códigos de erro para obter mais informações.
Logs de instalação
Os logs de instalação nos ajudam a solucionar a maioria dos problemas de instalação. Quando você envia um problema usando Relatar um problema no Instalador do Visual Studio, o log de instalação mais recente do Instalador do Visual Studio é adicionado automaticamente ao seu relatório.
Se você entrar em contato com o Suporte da Microsoft, poderá ser solicitado a coletar logs de instalação usando a ferramenta de coleção de logs do Microsoft Visual Studio e do .NET Framework. A ferramenta de coleta de log coleta os logs de configuração de todos os componentes instalados pelo Visual Studio, incluindo .NET Framework, SDK do Windows e SQL Server. Ele também coleta informações do computador, um inventário do Windows Installer e informações de log de eventos do Windows para o Instalador do Visual Studio, o Windows Installer e o System Restore.
Para coletar os logs:
- Baixe a ferramenta.
- Abra um prompt de comando administrativo.
- Execute
Collect.exena pasta em que você salvou a ferramenta. - A ferramenta gera um
vslogs.ziparquivo em sua%TEMP%pasta, normalmente emC:\Users\YourName\AppData\Local\Temp\vslogs.zip.
Observação
A ferramenta deve ser executada na mesma conta de usuário em que a instalação com falha foi executada. Se estiver executando a ferramenta em uma conta de usuário diferente, defina a opção –user:<name> para especificar a conta de usuário na qual a instalação com falha foi executada. Execute Collect.exe -? em um prompt de comando do administrador para obter informações adicionais de uso e opções.
Problemas ao instalar o WebView2
O WebView2 é um componente exigido pelo Visual Studio, mas a instalação desse componente pode ser bloqueada pelas Políticas de Grupo da sua organização. Bloquear a instalação do WebView2 impedirá que o Visual Studio seja instalado.
Duas políticas controlam a capacidade de instalar o WebView2: Microsoft Edge 'Install (WebView)' e Microsoft Edge 'InstallDefault'.
• Se a política "Instalar (WebView)" do Microsoft Edge estiver configurada, ela determinará se o WebView2 pode ser instalado. • Se a política "Instalar (WebView)" do Microsoft Edge não estiver configurada, a política "InstallDefault" do Microsoft Edge determinará se o WebView2 pode ser instalado.
Observação
Se nenhuma das políticas estiver configurada, a instalação do WebView2 será permitida pela sua organização.
Ajuda dinâmica
Se as soluções listadas neste guia de solução de problemas não ajudarem você a instalar ou atualizar com êxito o Visual Studio, use nossa opção de suporte de chat ao vivo (somente inglês) para obter mais assistência.