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

              Aplica-se a: Visual Studio 2022

Este guia de solução de problemas inclui instruções passo a passo para resolve problemas comuns com a instalação e atualização do Visual Studio.

Dica

Tem problemas para instalar? Podemos ajudar. Oferecemos uma opção de suporte para chat de instalação (somente inglês).

Instalações ou atualizações online

Experimente as resoluções possíveis a seguir que se aplicam a um problema típico de instalação online em ordem.

1. Verifique se o problema é um problema conhecido

A primeira coisa a marcar é se o problema que você está encontrando ou não é um problema conhecido com o Instalador do Visual Studio que a Microsoft está trabalhando na correção.

Para ver se há uma solução alternativa para o problema, marcar Problemas Conhecidos do Visual Studio 2019 e Problemas Conhecidos do Visual Studio 2022.

2. Tente reparar o Visual Studio

Tente reparar sua instalação. Ele pode corrigir muitos problemas comuns de atualização.

3. Veja o que a comunidade de desenvolvedores diz sobre o erro

Se o reparo não corrigir o problema, pesquise sua mensagem de erro no Visual Studio Developer Community. Outros membros da comunidade podem ter encontrado uma solução ou solução alternativa para o seu problema.

4. Exclua a pasta do instalador (problemas de atualização)

Se você encontrou um problema ao atualizar, tente excluir a pasta Instalador do Visual Studio e execute novamente o bootstrapper de instalação pode resolver determinadas falhas de atualização. Isso reinstala os arquivos Instalador do Visual Studio e redefine os metadados de instalação.

1. Feche o Instalador do Visual Studio.
2. Exclua a pasta Instalador do Visual Studio. Normalmente, o caminho da pasta é C:\Arquivos de Programa (x86)\Microsoft Visual Studio\Installer.
3. Execute o Instalador do Visual Studio bootstrapper. Você pode encontrar o bootstrapper na pasta Downloads com um nome de arquivo VisualStudioSetup.exe (Visual Studio 2022) ou vs_<edition>*.exe (Visual Studio 2019 e versões anteriores). Ou você pode baixar o bootstrapper das páginas de download para Visual Studio 2022 ou Visual Studio 2019 e versões anteriores. Em seguida, execute o executável para redefinir os metadados de instalação.
4. Tente instalar ou atualizar o Visual Studio novamente. Se o Instalador do Visual Studio continuar falhando, denuncie um problema a ser suportado.

5. Relatar o problema para dar suporte

Em algumas situações, quando há arquivos corrompidos, os problemas podem exigir solução de problemas caso a caso.

Siga estas etapas para enviar o problema para Suporte da Microsoft:

• Para Visual Studio 2022:

  1. Colete seus logs de configuração. Confira Como obter os logs de instalação do Visual Studio para obter detalhes.

  2. Abra o Instalador do Visual Studio e, em seguida, escolha Relatar um problema para abrir a ferramenta Comentários do Visual Studio.

     

  3. Dê um título ao relatório de problemas e forneça os detalhes relevantes. O log de configuração mais recente do Instalador do Visual Studio é adicionado automaticamente à seção Anexos adicionais do relatório de problemas.

  4. Choose Submit.

• Para o Visual Studio 2019 e versões anteriores:

  1. Colete seus logs de configuração. Confira Como obter os logs de instalação do Visual Studio para obter detalhes.
  2. Abra o Instalador do Visual Studio e selecione Relatar um problema para abrir a ferramenta Comentários do Visual Studio.
  3. Dê um título ao relatório de problemas e forneça detalhes relevantes. Selecione Avançar para ir para a seção Anexos e, em seguida, anexar o arquivo de log gerado (normalmente, o arquivo está em %TEMP%\vslogs.zip).
  4. Selecione Avançar para examinar seu relatório de problemas e selecione Enviar.

6. Remover todos os 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. Remova tudo com InstallCleanup.exe.
2. Execute novamente o Instalador do Visual Studio bootstrapper. Você pode encontrar o bootstrapper na pasta Downloads com um nome de arquivo VisualStudioSetup.exe (Visual Studio 2022) ou vs<edition>*.exe_ (Visual Studio 2019 e versões anteriores). Ou você pode baixar o bootstrapper das páginas de download para Visual Studio 2022 ou Visual Studio 2019 e versões anteriores.
3. Tente reinstalar o Visual Studio.

7. Reverter para uma instalação anterior (somente para Visual Studio 2022)

Antes de tentar reverter, saiba mais sobre o recurso de reversão no Visual Studio.

Se nenhuma das etapas anteriores o ajudou a atualizar com êxito o Visual Studio, você poderá tentar reverter para sua versão instalada anteriormente. Desde o Visual Studio 2022 versão 17.4, você pode reverter para sua versão instalada anteriormente se sua versão original estiver 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.

Importante

Se você estiver em uma organização e estiver usando um layout para atualizar o Visual Studio, espera-se que o administrador de TI mantenha os pacotes anteriores no layout se espera que o cliente possa reverter. Além disso, a reversão pode estar desabilitada ou sua tentativa de reversão pode ser desfeita se você estiver em uma organização com conformidade de segurança ou requisitos de atualização de software. Entre em contato com o administrador de TI para obter mais detalhes.

Para reverter com o Instalador do Visual Studio, siga estas etapas:

1. Inicie o Instalador do Visual Studio em seu computador.

2. No instalador, procure a edição do Visual Studio que você instalou.

3. Selecione Mais.

4. Selecione Reversão para a versão anterior.

   

5. Selecione OK para confirmar.

8. Entre em contato com nosso chat ao vivo

Se nenhuma das etapas anteriores ajudar você a instalar ou atualizar o Visual Studio com êxito, entre em contato conosco usando nossa opção de suporte de chat ao vivo (somente inglês) para obter mais assistência.

Layout de rede ou instalações offline

Para resolve problemas com uma instalação de rede, consulte Códigos de Erro ou 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 várias situações. Para obter mais informações, consulte Administrador atualiza códigos de erro de solução de problemas.

Você pode usar os seguintes métodos para fornecer comentários sobre atualizações de administrador do Visual Studio ou problemas de relatório que afetam as atualizações:

• Faça perguntas à comunidade no Visual Studio Setup Q&Um Fórum.
• Acesse a página de suporte do Visual Studio e marcar se o problema está listado nas perguntas frequentes.
• Forneça comentários de recursos ou reporte um problema à equipe do Visual Studio em relação à sua experiência.
• Entre em contato com o gerente de conta técnica da sua organização para a Microsoft.

Coletar logs de instalação para Suporte da Microsoft

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 coleção de logs. A ferramenta de coleção de logs coleta logs de instalação de todos os componentes instalados pelo Visual Studio, incluindo .NET Framework, SDK do Windows e SQL Server. Ele também coleta informações de computador, um inventário do Windows Installer e informações de log de eventos do Windows para o Instalador do Visual Studio, o Instalador do Windows e a Restauração do Sistema.

Para coletar os logs, siga estas etapas:

1. Baixe a ferramenta.

2. Abra um prompt de comando administrativo.

3. Execute Collect.exe na pasta em que você salvou a ferramenta.

   A ferramenta deve ser executada na mesma conta de usuário em que a instalação com falha foi executada. Se você estiver executando a ferramenta de 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 -? a partir de um prompt de comando de administrador para obter mais opções e informações de uso.

A ferramenta gera um arquivo vslogs.zip na pasta %TEMP%, normalmente em C:\Users\YourName\AppData\Local\Temp\vslogs.zip.

Relatar problemas de produto para nós usando a ferramenta Relatar um problema que aparece no Instalador do Visual Studio e no IDE do Visual Studio. Se você for um administrador de TI e não tiver o Visual Studio instalado, você poderá enviar comentários Administração de TI aqui.

Problemas ao instalar o WebView2

Se as políticas de Grupo da sua organização bloquearem a instalação do componente WebView2, você não poderá instalar o Visual Studio porque o instalador exigirá que o WebView2 seja instalado. Se isso acontecer, marcar estas políticas:

• Se o Microsoft Edge 'Install (WebView)' estiver configurado, ele 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.

Aviso

Se nenhuma das políticas estiver configurada, a instalação do WebView2 será permitida pela sua organização.