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

Aplica-se a:yes Visual Studio noVisual Studio para Mac noVisual 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.

  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 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.
  4. Tente instalar ou atualizar o Visual Studio. Se o Instalador continuar falhando, prossiga para o Relatório uma etapa de problema .
  1. Fechar o instalador do Visual Studio.
  2. Exclua a pasta do 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 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:

  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. Screenshot showing the Provide feedback button in the Visual Studio Installer.
  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. Screenshot showing the Provide feedback button in the Visual Studio Installer.
  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 deste artigo: remover a página do Visual Studio .
  2. 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]__*.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 – 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:

  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.

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.

Confira também