Partilhar via

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

Aplica-se a: Visual Studio

Este artigo inclui instruções passo a passo para resolver problemas comuns que afetam a instalação e a atualização do Microsoft Visual Studio.

Dica

Está com problema para instalar? Podemos ajudá-lo. Oferecemos uma opção de suporte de chat de instalação (somente em inglês).

Instalações ou atualizações online

Para solucionar problemas que afetam um problema típico de instalação online, tente as seguintes resoluções possíveis na ordem fornecida.

Verificar se o problema é um problema conhecido

Para verificar se você está enfrentando um problema conhecido no Instalador do Visual Studio que a Microsoft está trabalhando ativamente na correção, visite os seguintes sites:

Tente reparar o Visual Studio

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

Saiba o que a comunidade de desenvolvedores diz sobre o erro

Se um reparo não corrigir o problema, pesquise sua mensagem de erro na Comunidade de Desenvolvedores do Visual Studio. Outros membros da comunidade podem encontrar uma solução ou solução alternativa para o problema.

Excluir a pasta Instalador (problemas de atualização)

Se você encontrar um problema ao tentar atualizar o programa, tente excluir a pasta instalador do Visual Studio e execute novamente o bootstrapper de instalação. Essa ação pode resolver determinadas falhas de atualização. Ele reinstala os arquivos do Instalador do Visual Studio e redefine os metadados de instalação. Para excluir a pasta, siga estas etapas:

  1. Fechar o instalador do Visual Studio.

  2. Exclua a pasta do Instalador do Visual Studio. Normalmente, o caminho da pasta é C:\Arquivos de Programas (x86)\Microsoft Visual Studio\Installer.

  3. Execute o bootstrapper de instalação do Visual Studio.

    • Você pode obter o bootstrapper da versão mais recente do Visual Studio na página de downloads. Para versões anteriores do Visual Studio, consulte a página de downloads mais antiga.

    • Você também pode encontrar o bootstrapper na pasta Downloads . O bootstrapper é chamado VisualStudioSetup.exe para o Visual Studio 2022 e versões posteriores, ou vs_<edition>.exe para o Visual Studio 2019 e versões anteriores.

  4. Tente novamente instalar ou atualizar o Visual Studio. Se o Instalador do Visual Studio continuar falhando, vá para a próxima seção.

5. Relatar o problema ao suporte da Microsoft

Em algumas situações, arquivos corrompidos causam problemas que exigem solução de problemas caso a caso. Siga as etapas apropriadas para sua versão do Visual Studio.

  1. Colete os logs de configuração. Para obter detalhes, consulte Como obter os logs de instalação do Visual Studio.

  2. Abra o Instalador do Visual Studio. Em seguida, selecione Relatar um problema para abrir a ferramenta comentários do Visual Studio.

    O botão Fornecer comentários no Instalador do Visual Studio.

  3. Dê um título ao relatório de problema 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 problema.

  4. Selecione Enviar.

Remover todos os arquivos de instalação do Visual Studio

Como último recurso, você pode remover todos os arquivos de instalação e informações de produto do Visual Studio:

  1. Remova todos os arquivos usando InstallCleanup.exe.

  2. Execute novamente o bootstrapper do Instalador do Visual Studio.

    • Você pode obter o bootstrapper para a versão mais recente do Visual Studio na página de downloads. Para versões anteriores do Visual Studio, consulte a página de downloads mais antiga.

    • Você também pode encontrar o bootstrapper na pasta Downloads . O bootstrapper é denominado VisualStudioSetup.exe para Visual Studio 2022 e posterior, ou vs_<edition>.exe para Visual Studio 2019 e anterior.

  3. Tente novamente reinstalar o Visual Studio.

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

Se nenhuma das etapas anteriores ajudar você a atualizar com êxito o Visual Studio, você poderá reverter o programa para sua versão instalada anteriormente usando o Instalador do Visual Studio ou a linha de comando.

Importante

Se você estiver em uma organização que usa um layout para atualizar o Visual Studio, o administrador de TI normalmente mantém os pacotes anteriores no layout. Esses pacotes permitem que o cliente reverta a instalação. Além disso, o processo de reversão pode estar desabilitado ou sua tentativa de reversão pode ser desfeita. Isso poderá ocorrer se sua organização tiver requisitos de conformidade de segurança ou atualização de software. Para obter mais detalhes, entre em contato com o administrador de TI.

Reverter para uma versão anterior usando o Instalador do Visual Studio

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

  2. No instalador, procure a edição do Visual Studio para corresponder à edição instalada.

  3. Selecione Mais.

  4. Selecione Reverter para a versão anterior.

    Opção para reverter para uma versão anterior do programa.

  5. Para confirmar a ação, selecione OK.

Fazer rollback usando a linha de comando

Você pode reverter a atualização programaticamente. Use o instalador no computador cliente e passe o comando de reversão junto com a instância do caminho de instalação. Por exemplo:

VisualStudioSetup.exe rollback --installPath <VisualStudioInstallPath>

Para obter mais informações, consulte Usar parâmetros de linha de comando para instalar o Visual Studio.

Entre em contato com nosso chat ao vivo

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

Layout de rede ou instalações offline

Para resolver problemas que afetam uma instalação de rede, consulte Códigos de Erro ou solucione erros relacionados à rede ao instalar ou usar o Visual Studio.

Atualizações de administrador

Várias situações podem impedir que as atualizações do administrador sejam aplicadas corretamente. Para obter mais informações, consulte Atualizações do administrador para solucionar códigos de erro de problemas.

Para fornecer comentários sobre atualizações de administrador do Visual Studio ou relatar problemas que afetam as atualizações, use os seguintes métodos:

Coletar logs de instalação para o Suporte da Microsoft

Um agente de Suporte da Microsoft pode solicitar que você colete logs de instalação usando a ferramenta de coleta de logs do Microsoft Visual Studio e do .NET Framework. A ferramenta de coleta de logs coleta logs de instalação de todos os componentes instalados pelo Visual Studio, incluindo .NET Framework, SDK do Windows e SQL Server. Ela também coleta informações do computador, um inventário do Windows Installer e informações de log de eventos do Windows referentes ao Instalador do Visual Studio, ao Windows Installer e à Restauração do Sistema.

Para coletar os logs, siga estas etapas:

  1. Baixe a ferramenta.

  2. Abra uma janela de prompt de comando elevado.

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

    Observação

    Você deve executar a ferramenta na mesma conta de usuário usada para a tentativa de instalação com falha. Se você executar a ferramenta de uma conta de usuário diferente, defina a opção -user:<name> para especificar a conta de usuário para a instalação com falha. Para obter mais opções e informações de uso, execute Collect.exe -? em um prompt de comando com privilégios elevados.

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

Relatar problemas do produto 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, poderá enviar comentários de administrador de TI aqui.

Problemas ao instalar WebView2

Se as configurações de Política de Grupo da sua organização bloquearem a instalação do componente WebView2, você não poderá instalar o Visual Studio porque o instalador requer WebView2. Se esse problema ocorrer, verifique estas políticas:

Aviso

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

  • Last updated on