Solução de problemas de instalação e atualização do Visual StudioTroubleshoot Visual Studio installation and upgrade issues

Important

Está com problema para instalar?Having a problem installing? Podemos ajudá-lo.We can help. Oferecemos um chat ao vivo a opção de suporte (apenas em inglês).We offer a live chat (English only) support option.

Este guia de solução de problemas apresenta instruções passo a passo que resolvem a maioria dos problemas de instalação.This troubleshooting guide includes step-by-step instructions that should resolve most installation issues.

Como solucionar problemas de uma instalação offlineHow to troubleshoot an online installation

As etapas a seguir são otimizadas para uma instalação online típica.The following steps are optimized for a typical online installation. Para um problema que afeta uma instalação offline, confira Como solucionar problemas de uma instalação offline.For an issue that affects an offline installation, please see How to troubleshoot an offline installation.

Etapa 1: verificar se esse é um problema conhecidoStep 1 - Check whether this problem is a known issue

Existem alguns problemas conhecidos com o instalador do Visual Studio que a Microsoft está trabalhando para corrigir.There are some known issues with the Visual Studio Installer that Microsoft is working on fixing. Para saber se há uma solução para o problema, consulte a seção Problemas Conhecidos das nossas notas de versão.To see if there's a workaround for your problem, check the Known Issues section of our release notes.

Existem alguns problemas conhecidos com o instalador do Visual Studio que a Microsoft está trabalhando para corrigir.There are some known issues with the Visual Studio Installer that Microsoft is working on fixing. Para saber se há uma solução para o problema, consulte a seção Problemas Conhecidos das nossas notas de versão.To see if there's a workaround for your problem, check the Known Issues section of our release notes.

Etapa 2: conferir com a comunidade de desenvolvedoresStep 2 - Check with the developer community

Pesquise em sua mensagem de erro com a Comunidade de Desenvolvedores do Visual Studio.Search on your error message with the Visual Studio Developer Community. Outros membros da comunidade podem ter documentado uma solução para o seu problema.Other members of the community might have documented a solution to your problem.

Etapa 3 - excluir o diretório de instalação do Visual Studio para corrigir problemas de atualizaçãoStep 3 - Delete the Visual Studio Installer directory to fix upgrade problems

O bootstrapper de instalação do Visual Studio é um executável leve mínimo que instala o restante do instalador do Visual Studio.The Visual Studio Installer bootstrapper is a minimal light-weight executable that installs the rest of the Visual Studio Installer. A exclusão de arquivos de instalação do Visual Studio e a nova execução do bootstrapper podem resolver algumas falhas de atualização.Deleting Visual Studio Installer files and then rerunning the bootstrapper might solve some update failures.

Note

Executar as seguintes ações reinstalará os arquivos do Instalador do Visual Studio e redefinirá os metadados de instalação.Performing the following actions reinstalls the Visual Studio Installer files and resets the installation metadata.

  1. Fechar o instalador do Visual Studio.Close the Visual Studio Installer.
  2. Exclua o diretório de instalação do Visual Studio.Delete the Visual Studio Installer directory. Normalmente, o diretório é C:\Program Files (x86)\Microsoft Visual Studio\Installer.Typically, the directory is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Execute o bootstrapper de instalação do Visual Studio.Run the Visual Studio Installer bootstrapper. Você pode encontrar o bootstrapper na pasta Downloads com um nome de arquivo que segue um padrão vs_[Visual Studio edition]__*.exe.You might find the bootstrapper in your Downloads folder with a file name that follows a vs_[Visual Studio edition]__*.exe pattern. Se não encontrar esse aplicativo, você poderá baixar o bootstrapper indo para a página Downloads do Visual Studio e clicando em Baixar para sua edição do Visual Studio.If you don't find that application, you can download the bootstrapper by going to the Visual Studio downloads page and clicking Download for your edition of Visual Studio. Em seguida, execute o arquivo executável para redefinir os metadados de instalação.Then, run the executable to reset your installation metadata.
  4. Tente instalar ou atualizar o Visual Studio.Try to install or update Visual Studio again. Se o Instalador continuar a falhar, vá para a próxima etapa.If the Installer continues to fail, go to the next step.
  1. Fechar o instalador do Visual Studio.Close the Visual Studio Installer.
  2. Exclua o diretório de instalação do Visual Studio.Delete the Visual Studio Installer directory. Normalmente, o diretório é C:\Program Files (x86)\Microsoft Visual Studio\Installer.Typically, the directory is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Execute o bootstrapper de instalação do Visual Studio.Run the Visual Studio Installer bootstrapper. Você pode encontrar o bootstrapper na pasta Downloads com um nome de arquivo que segue um padrão vs_[Visual Studio edition]__*.exe.You might find the bootstrapper in your Downloads folder with a file name that follows a vs_[Visual Studio edition]__*.exe pattern. Se não encontrar esse aplicativo, você poderá baixar o bootstrapper indo para a página Downloads do Visual Studio e clicando em Baixar para sua edição do Visual Studio.If you don't find that application, you can download the bootstrapper by going to the Visual Studio downloads page and clicking Download for your edition of Visual Studio. Em seguida, execute o arquivo executável para redefinir os metadados de instalação.Then, run the executable to reset your installation metadata.
  4. Tente instalar ou atualizar o Visual Studio.Try to install or update Visual Studio again. Se o Instalador continuar a falhar, vá para a próxima etapa.If the Installer continues to fail, go to the next step.

Etapa 4 - relatar um problemaStep 4 - Report a problem

Em algumas situações, como aquelas relacionadas a arquivos corrompidos, os problemas talvez precisem ser resolvidos caso a caso.In some situations, such as those related to corrupted files, the problems might have to be looked at on a case-by-case basis. Para que possamos ajudá-lo, faça o seguinte:To help us help you, please do the following:

  1. Colete os logs de configuração.Collect your setup logs. Para saber mais detalhes, consulte Como obter os logs de instalação do Visual Studio.See How to get the Visual Studio installation logs for details.
  2. Abra o instalador do Visual Studio e clique em Relatar um problema para abrir a ferramenta de comentários do Visual Studio.Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool. Você pode pressionar Tab até acessar o botão Fornecer Comentários para abrir a ferramenta de comentáriosYou can tab to the Provide Feedback button to open the feedback tool
  3. Dê um título ao relatório de problemas e forneça detalhes relevantes.Give your problem report a title, and provide relevant details. 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).Click Next to go to the Attachments section, and then attach the generated log file (typically, the file is at %TEMP%\vslogs.zip).
  4. Clique em Avançar para examinar o relatório de problemas e clique em Enviar.Click Next to review your problem report, and then click Submit.
  1. Colete os logs de configuração.Collect your setup logs. Para saber mais detalhes, consulte Como obter os logs de instalação do Visual Studio.See How to get the Visual Studio installation logs for details.
  2. Abra o instalador do Visual Studio e clique em Relatar um problema para abrir a ferramenta de comentários do Visual Studio.Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool. Você pode pressionar Tab até acessar o botão Fornecer Comentários para abrir a ferramenta de comentáriosYou can tab to the Provide Feedback button to open the feedback tool
  3. Dê um título ao relatório de problemas e forneça detalhes relevantes.Give your problem report a title, and provide relevant details. 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).Click Next to go to the Attachments section, and then attach the generated log file (typically, the file is at %TEMP%\vslogs.zip).
  4. Clique em Avançar para examinar o relatório de problemas e clique em Enviar.Click Next to review your problem report, and then click Submit.

Etapa 5 – Executar InstallCleanup.exe para remover os arquivos de instalaçãoStep 5 - Run InstallCleanup.exe to remove installation files

Como último recurso, você pode remover o Visual Studio para remover todos os arquivos de instalação e informações do produto.As a last resort, you can remove Visual Studio to remove all installation files and product information.

  1. Siga as instruções em Remover o Visual Studio.Follow the instructions in Remove Visual Studio.
  2. Execute novamente o bootstrapper descrito na Etapa 3 - excluir o diretório do Instalador do Visual Studio para corrigir problemas de atualização.Rerun the bootstrapper that's described in Step 3 - Delete the Visual Studio Installer directory to fix upgrade problems.
  3. Tente instalar ou atualizar o Visual Studio.Try to install or update Visual Studio again.

Etapa 6 – Entrar em contato conosco (opcional)Step 6 - Contact us (optional)

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.If none of the previous steps help you successfully install or upgrade Visual Studio, contact us by using our live chat support option (English only) for further assistance.

Como solucionar problemas de uma instalação offlineHow to troubleshoot an offline installation

Vejamos uma tabela de problemas conhecidos e algumas soluções alternativas que podem ajudar durante a instalação a partir de um layout local.Here is a table of known issues and some workarounds that might help you when you install from a local layout.

ProblemaIssue ItemItem SoluçãoSolution
Os usuários não têm acesso aos arquivos.Users do not have access to files. permissões (ACLs)permissions (ACLs) Lembre-se de ajustar as permissões (ACLs) para que elas concedam acesso de Leitura aos outros usuários antes de você compartilhar a instalação offline.Make sure that you adjust the permissions (ACLs) so that they grant Read access to other users before you share the offline install.
Falha na instalação de novas cargas de trabalho, novos componentes ou idiomas.New workloads, components, or languages fail to install. --layout Verifique se você tem acesso à Internet se estiver instalando com base em um layout parcial e selecione as cargas de trabalho, os componentes ou idiomas que não foram baixado anteriormente nesse layout parcial.Make sure that you have internet access if you install from a partial layout and select workloads, components, or languages that were not downloaded previously in that partial layout.

Como obter os logs de instalação do Visual StudioHow to get Visual Studio installation logs

Os logs de instalação são necessários para solucionar a maioria dos problemas de instalação.Setup logs are needed to troubleshoot most installation issues. Quando você enviar um problema usando Relatar um Problema no Instalador do Visual Studio, esses logs serão incluídos automaticamente no relatório.When you submit an issue by using Report a Problem in the Visual Studio Installer, these logs are automatically included in your report.

Caso contate o Suporte da Microsoft, talvez você precise fornecer esses logs de configuração usando a Ferramenta de Coleta de Log do .NET Framework e o Microsoft Visual Studio.If you contact Microsoft Support, you might need to provide these setup logs by using the Microsoft Visual Studio and .NET Framework Log Collection Tool. 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.The log collection tool collects setup logs from all components installed by Visual Studio, including .NET Framework, Windows SDK, and SQL Server. Ela também coleta informações do computador, um inventário do Windows Installer e as informações de log de eventos do Instalador do Visual Studio, Windows Installer e Restauração do Sistema.It also collects computer information, a Windows Installer inventory, and Windows event log information for Visual Studio Installer, Windows Installer, and System Restore.

Para coletar os logs:To collect the logs:

  1. Baixe a ferramenta.Download the tool.
  2. Abra um prompt de comando administrativo.Open an administrative command prompt.
  3. Execute Collect.exe no diretório em que você salvou a ferramenta.Run Collect.exe from the directory where you saved the tool.
  4. Localize o arquivo vslogs.zip resultante no diretório %TEMP%, por exemplo, C:\Users\YourName\AppData\Local\Temp\vslogs.zip.Find the resulting vslogs.zip file in your %TEMP% directory, for example, C:\Users\YourName\AppData\Local\Temp\vslogs.zip.

Note

A ferramenta deve ser executada na mesma conta de usuário em que a instalação com falha foi executada.The tool must be run under the same user account that the failed installation was run under. 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.If you are running the tool from a different user account, set the –user:<name> option to specify the user account under which the failed installation was run. Execute Collect.exe -? em um prompt de comando do administrador para obter opções e informações de uso adicionais.Run Collect.exe -? from an administrator command prompt for additional options and usage information.

Obter ajuda ao vivoGet live help

Se as soluções listadas neste guia de solução de problemas não ajudarem a instalar ou atualizar o Visual Studio, use a nossa opção de suporte por chat ao vivo (somente em inglês) para obter mais assistência.If the solutions listed in this troubleshooting guide do not help you to successfully install or upgrade Visual Studio, use our live chat support option (English only) for further assistance.

Consulte tambémSee also