Solução de problemas de instalação e atualização do Visual Studio

Aplica-se a:simVisual Studio nãoVisual Studio para Mac nãoVisual Studio Code

Dica

Está com problema para instalar? Podemos ajudá-lo. Oferecemos uma opção de suporte de chat de instalação (somente em 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 de rede (layout) ou offline, consulte Como solucionar problemas de uma instalação offline.

Etapa 1 – Verificar se o 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 sobre a 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 no Developer Community 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 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, o produto do Visual Studio. Excluir os arquivos 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.

  1. Fechar o instalador do Visual Studio.
  2. Exclua o diretório de instalação do Instalador do Visual Studio. Normalmente, o diretório é C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. 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 antiga 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.
  4. Tente instalar ou atualizar o Visual Studio. Se o Instalador continuar falhando, prossiga para a etapa Relatar um problema .
  1. Fechar o instalador do Visual Studio.
  2. Exclua a pasta Instalador do Visual Studio. Normalmente, o caminho da pasta é C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. 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]__*.exe padrã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.
  4. Tente instalar ou atualizar o Visual Studio. Se o Instalador do Visual Studio continuar falhando, prossiga para a etapa Relatar um 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, siga estas etapas:

  1. Colete os logs de configuração. Para saber mais detalhes, consulte Como obter os logs de instalação do Visual Studio.
  2. Abra o instalador do Visual Studio e clique em Relatar um problema para abrir a ferramenta de comentários do Visual Studio. Captura de tela mostrando o botão Fornecer comentários no Instalador do Visual Studio.
  3. 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).
  4. Clique em Avançar para examinar o relatório de problemas e clique em Enviar.
  1. Colete os logs de configuração. Para saber mais detalhes, consulte Como obter os logs de instalação do Visual Studio.
  2. Abra o Instalador do Visual Studio e escolha Relatar um problema para abrir a ferramenta comentários do Visual Studio. Captura de tela mostrando o botão Fornecer comentários no Instalador do Visual Studio.
  3. 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.
  4. 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:

  1. Siga as etapas neste artigo: página Remover Visual Studio .
  2. Execute novamente o Instalador do Visual Studio bootstrapper. Você pode encontrar o bootstrapper em sua pasta Downloads com um nome de arquivo que corresponda a um vs_[Visual Studio edition]__*.exe padrão. Ou você pode baixar o bootstrapper para sua edição do Visual Studio na página de downloads do Visual Studio .
  3. Tente reinstalar o Visual Studio.

Etapa 7 – Reversão

Se nenhuma das etapas anteriores ajudar você a atualizar com êxito o Visual Studio, você poderá tentar reverter para sua versão instalada anteriormente. Saiba mais sobre o recurso de reversão no Visual Studio antes de tentar reverter.

Observação

A partir do Visual Studio 2022 versão 17.4, você poderá reverter para sua versão instalada anteriormente se:

  • você não instalou de um layout.
  • sua versão original estava no canal atual versão 17.1.7 ou superior, ou no 17.0 Fall 2021 LTSC channel 17.0.10 ou superior.

Você pode reverter para sua versão instalada anteriormente usando o Instalador do Visual Studio ou usando a linha de comando.

Reversão usando o Instalador do Visual Studio

  1. Inicie o Instalador do Visual Studio no computador.

  2. No instalador, procure a edição do Visual Studio instalada por você. Em seguida, escolha Mais e, em seguida, escolha Reverter para a versão anterior.

    Captura de tela da opção Reverter para a versão anterior.

  3. Selecione OK para confirmar sua escolha.

Importante

A reversão pode estar desabilitada ou sua tentativa de reversão poderá ser desfeita se você estiver em uma organização que tenha requisitos de conformidade de segurança ou atualização de software. Entre em contato com o administrador de TI para obter mais detalhes.

Etapa 8 – 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.

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.

Layout de rede ou instalações offline

Para resolver problemas com uma instalação de rede, consulte Códigos de erro ou Solucionar erros relacionados à rede ao instalar ou usar o Visual Studio.

Administrador Atualizações

As atualizações do administrador podem não ser aplicadas corretamente devido a uma variedade de situações. Consulte os códigos de erro de solução de problemas de atualizações do administrador 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 relatório.

Se você entrar em contato com Suporte da Microsoft, talvez seja solicitado que você colete logs de instalação usando o Microsoft Visual Studio e .NET Framework ferramenta de coleta de logs. 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 a Restauração do Sistema.

Para coletar os logs:

  1. Baixe a ferramenta.
  2. Abra um prompt de comando administrativo.
  3. Execute Collect.exe na pasta em que você salvou a ferramenta.
  4. A ferramenta gera um vslogs.zip arquivo em sua %TEMP% pasta, normalmente em C:\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.