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

Importante

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 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. 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á foi resolvido ou encontre soluções alternativas na seção Problemas Conhecidos de nossas notas sobre a versão.

Etapa 2 – Tentar reparar Visual Studio

O reparo corrige muitos problemas comuns de atualização. Para obter mais informações sobre quando e como reparar Visual Studio, consulte Reparar Visual Studio.

Etapa 3 – Verificar com a comunidade de desenvolvedores

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 problema.

Etapa 4 – Excluir a pasta Instalador do Visual Studio para corrigir problemas de atualização

O Visual Studio bootstrapper é um executável leve que inicia a instalação do Instalador do Visual Studio e, em seguida, o Visual Studio produto. Excluir os arquivos Instalador do Visual Studio e, em seguida, a nova operação do 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 Instalador do Visual Studio de instalação do . Normalmente, o diretório é C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Execute o Visual Studio bootstrapper. 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 indo para Visual Studio página downloads mais antigos 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, vá para a etapa Relatar um problema.
  1. Fechar o instalador do Visual Studio.
  2. Exclua a Instalador do Visual Studio de dados. 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 na pasta Downloads com um nome de arquivo que corresponde 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 Visual Studio downloads. 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, vá 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 a ajudá-lo, 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 Próximo para revisar 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 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 Visual Studio Comentários. 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 configuraçã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 Visual Studio de instalação

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

  1. Siga as etapas neste artigo: Remover Visual Studio página.
  2. Rerun the Instalador do Visual Studio bootstrapper. Você pode encontrar o bootstrapper na pasta Downloads com um nome de arquivo que corresponde 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 Visual Studio downloads.
  3. Tente reinstalar 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 ajudar você ao criar uma instalação offline e instalar de um layout local.

Problema Solução
Os usuários não podem acessar arquivos Certifique-se de ajustar as permissões (ACLs) para que elas concedam acesso de leitura a outros usuários antes de compartilhar a instalação offline.
Falha na instalação de novas cargas de trabalho, componentes ou pacotes de idiomas Certifique-se de que você tenha acesso à Internet se instalar 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, consulte Solucionar problemas de erros relacionados à rede ao instalar ou usar Visual Studio.

Atualizações de administrador

As atualizações do administrador podem não ser aplicadas corretamente devido a uma vareidade de situações. Consulte os códigos de erro de solução de problemas de atualizações de 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 configuração mais recente do Instalador do Visual Studio é adicionado automaticamente ao relatório.

Se você entrar em contato Suporte da Microsoft, poderá ser solicitado que você colete logs de instalação usando a ferramenta Microsoft Visual Studio e .NET Framework 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 instalador do Windows e informações de log de eventos do Windows para o Instalador do Visual Studio, o instalador Windows e 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 arquivo vslogs.zip em sua pasta %TEMP% , 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 Visual Studio seja instalado.

Duas políticas controlam a capacidade de instalar o WebView2: Microsoft Edge 'Instalar (WebView)' e Microsoft Edge 'InstallDefault'.

• Se a Microsoft Edge política 'Instalar (WebView)' estiver configurada, ela determinará se o WebView2 pode ser instalado. • Se a Microsoft Edge política "Instalar (WebView)" não estiver configurada, Microsoft Edge política 'InstallDefault' 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 ao vivo

Se as soluções listadas neste guia de solução de problemas não ajudarem você a instalar ou atualizar o Visual Studio, use nossa opção de suporte ao chat ao vivo (somente em inglês) para mais assistência.

Confira também