Partilhar via

Prompt de comando do desenvolvedor do Visual Studio e PowerShell do desenvolvedor

  • Artigo

O Visual Studio inclui dois shells de linha de comando para desenvolvedores, um prompt de comando e uma instância do PowerShell, da seguinte maneira:

  • Visual Studio Developer Command Prompt - Um prompt de comando padrão com determinadas variáveis de ambiente definidas para facilitar o uso de ferramentas de desenvolvedor de linha de comando.

    Captura de tela do prompt de comando do desenvolvedor para Visual Studio 2019 mostrando a ferramenta clrver.

    Captura de tela do prompt de comando do desenvolvedor para Visual Studio 2022 que mostra a ferramenta clrver.

  • Visual Studio Developer PowerShell - Mais poderoso do que um prompt de comando. Por exemplo, você pode passar a saída de um comando (conhecido como cmdlet ) para outro cmdlet. Esse shell tem as mesmas variáveis de ambiente definidas como o Prompt de Comando do Desenvolvedor. Disponível desde o Visual Studio 2019.

    Captura de tela da ferramenta Developer PowerShell no Visual Studio 2022.

A partir de Visual Studio 2019, o Visual Studio inclui um de terminal integrado que pode hospedar qualquer um desses shells (Prompt de Comando do Desenvolvedor e PowerShell do Desenvolvedor). Você também pode abrir várias abas de cada shell. O terminal do Visual Studio é construído sobre Terminal do Windows. Para abrir o terminal no Visual Studio, selecione Exibir >Terminal.

Captura de tela do painel de terminal do Visual Studio que mostra várias guias.

Captura de tela do terminal do Visual Studio mostrando várias guias.

Dica

Esta página descreve como usar os shells de linha de comando no Visual Studio. Se procurar o equivalente em Visual Studio Code— também conhecido como VS Code— consulte Interface de Linha de Comando (CLI) e Noções Básicas do Terminal.

Quando você abre um dos shells de desenvolvedor do Visual Studio, como um aplicativo separado ou na janela Terminal, ele é aberto para o diretório da sua solução atual (se você tiver uma solução carregada). Esse comportamento torna conveniente executar comandos na solução ou em seus projetos.

Ambos os shells têm variáveis de ambiente específicas definidas que permitem que você use ferramentas de desenvolvedor de linha de comando com mais facilidade. Depois de abrir um desses shells, você pode inserir os comandos para diferentes utilitários sem ter que saber onde eles estão localizados.

Comandos populares Descrição
MSBuild Criar um projeto ou solução
dotnet Um comando .NET CLI
dotnet run Um comando .NET CLI
clrver Uma ferramenta do .NET Framework para o CLR
ildasm Uma ferramenta .NET Framework para desassemblador
CL Ferramenta de compilação C/C++
NMAKE Ferramenta de compilação C/C++
LIB Ferramenta de compilação C/C++
DUMPBIN Ferramenta de compilação C/C++

Iniciar no Visual Studio

Siga estas etapas para abrir o Prompt de Comando do Desenvolvedor ou o Developer PowerShell de dentro do Visual Studio:

  1. Abra o Visual Studio.

  2. Na barra de menus, selecione Ferramentas >Linha de Comando>Prompt de Comando do Desenvolvedor ou Developer PowerShell.

    Captura de tela do menu Linha de Comando no Visual Studio 2022.

    Captura de tela do menu Linha de comando no Visual Studio 2019.

Iniciar a partir do menu do Windows

Outra maneira de iniciar os shells é a partir do menu Iniciar. Você pode ter vários prompts de comando, dependendo da versão do Visual Studio e de quaisquer SDKs e cargas de trabalho adicionais que você instalou.

Windows 11

  1. Selecione Iniciarcaptura de tela do botão Iniciar no Windows 11. e, em seguida, na caixa de diálogo Digite aqui para pesquisar, digite developer command prompt ou developer powershell.

  2. Selecione o resultado do aplicativo associado ao texto da pesquisa.

Windows 10

  1. Selecione Iniciarcaptura de tela do botão Iniciar no Windows 10.e, em seguida, desloque-se para a letra V.

  2. Expanda o Visual Studio 2019 ou pasta de do Visual Studio 2022.

  3. Se você estiver executando o Visual Studio 2019, selecione Prompt de Comando do Desenvolvedor para VS 2019 ou Developer PowerShell para VS 2019. Se você estiver executando o Visual Studio 2022, selecione Prompt de Comando do Desenvolvedor para VS 2022 ou Developer PowerShell para VS 2022.

    Como alternativa, você pode começar a digitar o nome do shell na caixa de pesquisa na barra de tarefas e selecionar o resultado desejado quando a lista de resultados começar a exibir as correspondências de pesquisa.

    Uma animação que mostra o comportamento de pesquisa no Windows 10.

Windows 8.1

  1. Aceda ao ecrã Iniciar, premindo a tecla do logótipo do Windows Captura de ecrã da tecla do logótipo do Windows no teclado. no teclado, por exemplo.

  2. No ecrã Iniciar, prima Ctrl+Tab para abrir a lista de Apps e, em seguida, prima V. Isso apresenta uma lista com todos os atalhos de comando do Visual Studio instalados.

  3. Se você estiver executando o Visual Studio 2019, selecione Prompt de Comando do Desenvolvedor para VS 2019 ou Developer PowerShell para VS 2019. Se você estiver executando o Visual Studio 2022, selecione Prompt de Comando do Desenvolvedor para VS 2022 ou Developer PowerShell para VS 2022.

Iniciar a partir do navegador de ficheiros

Normalmente, os atalhos para os shells que você instalou são colocados na pasta Menu Iniciar do Visual Studio, como em %ProgramData%\Microsoft\Windows\Start Menu\Programs\Visual Studio 2019\Visual Studio Tools. Mas se a pesquisa pelo prompt de comando não produzir os resultados esperados, você pode tentar localizar manualmente os arquivos em sua máquina.

Prompt de comando do desenvolvedor

Procure o nome do arquivo de prompt de comando, que é VsDevCmd.bat, ou vá para a pasta Ferramentas do Visual Studio, como %ProgramFiles%\Microsoft Visual Studio\2022\Community\Common7\Tools (o caminho muda de acordo com sua versão, edição e local de instalação do Visual Studio).

Depois de localizar o arquivo do prompt de comando, abra-o digitando o seguinte comando em uma janela de prompt de comando regular:

"%ProgramFiles%\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat"

Ou digite o seguinte comando na caixa de diálogo Executar do Windows:

%comspec% /k "C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat"

"%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools\VsDevCmd.bat"

Ou digite o seguinte comando na caixa de diálogo Executar do Windows:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\Tools\VsDevCmd.bat"

Desde o Visual Studio 2015, o Prompt de Comando do Desenvolvedor define a variável de ambiente VSCMD_VER que contém as informações de versão para o Visual Studio (por exemplo, 17.9.0). Se você precisar detetar se o Prompt de Comando do Desenvolvedor já foi executado em seu console, é recomendável verificar se VSCMD_VER foi definido ou não.

Dica

Certifique-se de editar o caminho para corresponder à versão ou edição do Visual Studio que você está usando.

Desenvolvedor PowerShell

Procure um arquivo de script do PowerShell chamado Launch-VsDevShell.ps1ou vá para a pasta Ferramentas do Visual Studio, como %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools. (O caminho muda de acordo com sua versão, edição e local de instalação do Visual Studio.) Depois de localizar o arquivo do PowerShell, execute-o inserindo o seguinte comando em um prompt do Windows PowerShell ou PowerShell 6.

Para o Visual Studio 2022:

& 'C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\Launch-VsDevShell.ps1'

Para o Visual Studio 2019:

& 'C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\Tools\Launch-VsDevShell.ps1'

Por padrão, o Developer PowerShell que é executado está configurado para a instalação do Visual Studio cujo caminho contém o arquivo Launch-VsDevShell.ps1.

Dica

A política de execução deve ser definida para que o cmdlet seja executado.

O script Launch-VsDevShell.ps1 funciona localizando o módulo Microsoft.VisualStudio.DevShell.dll PowerShell no caminho de instalação do Visual Studio, carregando-o e invocando o cmdlet Enter-VsDevShell. Os atalhos instalados, como os do menu Iniciar, carregam o módulo e invocam o cmdlet diretamente. Launch-VsDevShell.ps1 é a maneira recomendada de inicializar o Developer PowerShell interativamente ou para criar scripts de automação de compilação.

Argumentos de linha de comando

Pode usar argumentos de linha de comando com qualquer um dos shells, o Prompt de Comando do Desenvolvedor ou o PowerShell do Desenvolvedor.

Arquitetura de destino e arquitetura de host

Para ferramentas de compilação -- como o compilador C++ -- que criam saídas direcionadas a arquiteturas de CPU específicas, os shells do desenvolvedor podem ser configurados usando o argumento de linha de comando apropriado. A arquitetura dos binários da ferramenta de compilação também pode ser configurada usando argumentos de linha de comando. Isso é útil quando a máquina de compilação é uma arquitetura diferente da arquitetura de destino.

Dica

A partir do Visual Studio 2022, msbuild assumirá como padrão um binário de msbuild.exe de 64 bits, independentemente da Arquitetura de Host.

Shell Argumento
Prompt de comando do desenvolvedor -arch=<Arquitetura de destino>
Prompt de comando do desenvolvedor -host_arch=<Arquitetura do Anfitrião>
PowerShell para Desenvolvimento -Arch <Target Architecture>
PowerShell para Desenvolvedores -HostArch <Host Architecture>

Importante

Os argumentos -Arch e -HostArch do PowerShell do desenvolvedor só estão disponíveis a partir de Visual Studio 2022 versão 17.1.

A tabela a seguir lista quais arquiteturas são suportadas e se elas podem ser usadas para argumentos de Arquitetura de Destino ou Arquitetura de Host.

Arquitetura Arquitetura de destino Arquitetura do host
x86 Padrão Padrão
AMD64 Sim Sim
braço Sim Não
arm64 Sim Não

Dica

Se você definir apenas Arquitetura de Destino, os shells tentarão fazer com que a Arquitetura de Host corresponda. Isso pode resultar em erros quando apenas a Arquitetura de Destino é definida como um valor que também não é suportado pela Arquitetura de Host.

Exemplos

Inicie o prompt de comando do desenvolvedor para Visual Studio 2019 Community Edition em uma máquina de 64 bits, criando saídas de compilação destinadas a 64 bits:

"%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools\VsDevCmd.bat" -arch=amd64

Inicie o prompt de comando do desenvolvedor para Visual Studio 2019 Community Edition em uma máquina de 64 bits, criando saídas de compilação que visam o braço:

"%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\Tools\VsDevCmd.bat" -arch=arm -host_arch=amd64

Inicie o Developer PowerShell para a Community Edition do Visual Studio 2022 versão 17.1 ou posterior em uma máquina de 64 bits, criando saídas de compilação que visam arm64:

& 'C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\Launch-VsDevShell.ps1' -Arch arm64 -HostArch amd64

Ignorar Localização Automática

Para o Developer PowerShell, o diretório inicial do shell é o Local do Projeto do Visual Studio. Essa localidade padrão substitui quaisquer outros caminhos, como o diretório de trabalho. Esse comportamento pode ser desativado usando o argumento de linha de comando -SkipAutomaticLocation. Isso pode ser útil se você quiser que o shell permaneça no diretório atual após a inicialização.

A Localização do Projeto pode ser ajustada em Ferramentas>Opções>Projetos & Soluções>Localização do Projeto.

A Localização do Projeto pode ser ajustada em Ferramentas>Opções>Projetos & Soluções>Localizações.

Dica

Os argumentos de linha de comando -Arch, -HostArche -SkipAutomaticLocation são suportados pelo script Launch-VsDevShell.ps1 e pelo cmdlet Enter-VsDevShell.

Conteúdo relacionado