Usar o conjunto de ferramentas do Microsoft C++ na linha de comando

Compile aplicativos C e C++ na linha de comando usando as ferramentas incluídas no Visual Studio. O conjunto de ferramentas do compilador do Microsoft C++ (MSVC) também pode ser baixado como um pacote autônomo. Você não precisa instalar o IDE do Visual Studio se não planeja usá-lo.

Observação

Este artigo é sobre como configurar um ambiente para usar os compiladores individuais, vinculadores, bibliotecário e outras ferramentas básicas. O sistema de build de projeto nativo no Visual Studio, baseado no MSBuild, não usa o ambiente conforme descrito neste artigo. Para obter mais informações de como usar o MSBuild a partir da linha de comando, consulte MSBuild na linha de comando - C++.

Baixar e instalar o agente as ferramentas

Se você instalou o Visual Studio e uma carga de trabalho C++, você tem todas as ferramentas de linha de comando. Para saber mais sobre como instalar C++ e o Visual Studio, confira Instalar o suporte ao C++ no Visual Studio. Se você deseja somente o conjunto de ferramentas de linha de comando, baixe as Ferramentas de Build para Visual Studio. Quando você executa o arquivo executável baixado, ele atualiza e executa o Instalador do Visual Studio. Para instalar somente as ferramentas necessárias para o desenvolvimento do C++, selecione a carga de trabalho desenvolvimento da área de trabalho com C++. Você pode selecionar bibliotecas e conjuntos de ferramentas opcionais a serem incluídos nos Detalhes da instalação. Para criar código usando os conjuntos de ferramentas do Visual Studio 2015, 2017 ou 2019, selecione as ferramentas de build opcionais MSVC v140, v141 ou v142. Quando você estiver satisfeito com as seleções, escolha Concluir.

Como usar as ferramentas de linha de comando

Quando você escolhe uma das cargas de trabalho do C++ no Instalador do Visual Studio, ele instala o Conjunto de ferramentas da plataforma do Visual Studio. Um conjunto de ferramentas de plataforma tem todas as ferramentas C e C++ para uma versão do Visual Studio especifica. As ferramentas incluem os compiladores C/C++, vinculadores, montadores e outras ferramentas de build, além de bibliotecas e arquivos de cabeçalho correspondentes. Você pode usar todas essas ferramentas na linha de comando. Eles também são usados internamente pelo IDE do Visual Studio. Há ferramentas e compiladores hospedados no x86 e no x64 separados para compilar o código para os destinos x86, x64, ARM e ARM64. Cada conjunto de ferramentas para uma arquitetura específica de build de host e destino é armazenado em seu próprio diretório.

Para que funcionem corretamente, as ferramentas exigem a definição de diversas variáveis de ambiente específicas. Essas variáveis são usadas para adicionar as ferramentas ao caminho e para definir os locais de arquivos incluídos, arquivos de biblioteca e SDKs. Para facilitar a definição dessas variáveis de ambiente, o instalador cria arquivos de comando personalizados ou arquivos em lotes, durante a instalação. Execute um desses arquivos de comando para definir uma arquitetura de build de host e destino, uma versão do SDK do Windows e o conjunto de ferramentas da plataforma específicos. Por conveniência, o instalador também cria atalhos no menu Iniciar. Os atalhos abrem janelas de prompt de comando do desenvolvedor usando esses arquivos de comando para combinações específicas de host e destino. Esses atalhos garantem que todas as variáveis de ambiente necessárias estejam definidas e prontas para uso.

As variáveis de ambiente necessárias são específicas à instalação e à arquitetura de build escolhida. Eles também podem ser alterados por atualizações ou atualizações de produtos. Essa variabilidade é um dos motivos pelos quais recomendamos que você use um atalho de prompt de comando instalado ou um arquivo de comando, em vez de definir as variáveis de ambiente por conta própria.

Os conjuntos de ferramentas, arquivos de comando e atalhos instalados dependem do processador do computador e das opções que você selecionou durante a instalação. As ferramentas hospedadas em x86 e as ferramentas cruzadas que criam código x86 e x64 são sempre instaladas. Se você tiver o Windows 64-bit, as ferramentas hospedadas em x64 e as ferramentas cruzadas que criam código x86 e x64 também são instaladas. Caso você escolha as ferramentas opcionais da Plataforma Universal do Windows para C++, as ferramentas de x64 e x86 que compilam ARM e código do ARM64 também serão instaladas. Outras cargas de trabalho podem instalar essas e outras ferramentas.

Caminho e variáveis de ambiente para builds de linha de comando

As ferramentas de linha de comando do MSVC usam variáveis de ambiente PATH, TMP, INCLUDE, LIB e LIBPATH, além de também usar outras variáveis de ambiente específicas para suas ferramentas, plataformas e SDKs instalados. Até mesmo uma instalação simples do Visual Studio pode definir vinte ou mais variáveis de ambiente. Essa complexidade é a razão pela qual recomendamos fortemente que você use um atalho de prompt de comando do desenvolvedor ou um dos arquivos de comando personalizados. Não recomendamos que você defina essas variáveis no ambiente do Windows por conta própria.

Para ver quais variáveis de ambiente são definidas por um atalho de prompt de comando do desenvolvedor, você pode usar o comando SET. Abra uma janela de prompt de comando sem formatação e capture a saída do comando SET para uma linha de base. Abra uma janela de prompt de comando de desenvolvedor e capture a saída do comando SET para comparação. Use uma ferramenta de diferenciação, como a interna no Visual Studio, para realçar as variáveis de ambiente definidas pelo prompt de comando do desenvolvedor. Para obter mais informações sobre as variáveis de ambiente do compilador e do vinculador, consulte variáveis de ambiente CL.

Atalhos do prompt de comando do desenvolvedor

Os atalhos do prompt de comando são instalados em uma pasta do Visual Studio específica da versão no menu Iniciar do Windows. Esta é uma lista dos atalhos do prompt de comando base e das arquiteturas de build às quais eles dão suporte:

• Prompt de Comando do Desenvolvedor – define o ambiente para uso das ferramentas nativas do x86 de 32 bits para compilar o código nativo do x86 de 32 bits.
• Prompt de Comando de Ferramentas Nativas do x86 – define o ambiente para uso das ferramentas nativas do x86 de 32 bits para compilar o código nativo do x86 de 32 bits.
• Prompt de Comando de Ferramentas Nativas do x64 – define o ambiente para uso das ferramentas nativas do x64 de 64 bits para compilar o código nativo do x64 de 64 bits.
• Prompt de Comando de Ferramentas Cruzadas do x86_x64 – define o ambiente para uso das ferramentas nativas do x86 de 32 bits para compilar o código nativo do x64 de 64 bits.
• Prompt de Comando de Ferramentas Cruzadas do x64_x86 – define o ambiente para uso das ferramentas nativas do x64 de 64 bits para compilar o código nativo do x86 de 32 bits.

Os nomes da pasta de menu Iniciar e de atalho variam dependendo da versão instalada do Visual Studio. Se você definir um, eles também dependem do Apelido de instalação. Por exemplo, considere que você instalou o Visual Studio 2022 e deu a ele um apelido de Mais recente. O atalho do prompt de comando do desenvolvedor é chamado prompt de comando do desenvolvedor para VS 2022 (mais recente), em uma pasta chamada Visual Studio 2022.

Observação

Diversas ferramentas de linha de comando ou opções de ferramenta podem requerer a permissão de Administrador. Se você tiver problemas de permissão ao usá-los, recomendamos que você abra a janela do prompt de comando do desenvolvedor usando a opção Executar como Administrador. Clique com o botão direito do mouse para abrir o menu de atalho da janela do prompt de comando e escolha Mais, Executar como administrador.

Para abrir uma janela de prompt de comando do desenvolvedor

1. Na área de trabalho, abra o menu Iniciar do Windows. Em Windows 11, escolha o botão Todos os aplicativos para abrir a lista de aplicativos instalados. Em Windows 10, a lista está aberta à esquerda. Faça a rolagem pela lista para localizar e abrir a pasta (não o aplicativo) para sua versão do Visual Studio, por exemplo, Visual Studio 2022.

2. Na pasta, escolha o Prompt de Comando do Desenvolvedor da versão do Visual Studio. Esse atalho inicia uma janela do Prompt de Comando do Desenvolvedor que usa a arquitetura de build padrão das ferramentas nativas do x86 de 32 bits para compilar o código nativo do x86 de 32 bits. Caso prefira uma arquitetura de build não padrão, escolha um dos prompts de comando de ferramentas nativas ou cruzadas para especificar a arquitetura de host e de destino.

Para obter uma maneira ainda mais rápida de abrir um prompt de comando do desenvolvedor, insira o prompt de comando do desenvolvedor na caixa de pesquisa da área de trabalho. Em seguida, escolha o resultado desejado.

Observação

Por padrão, o diretório de trabalho atual em um prompt de comando do desenvolvedor é a raiz da instalação do Visual Studio no diretório Arquivos de Programas. Este não é um local apropriado para seu código e projetos. Altere o diretório de trabalho atual para outro local antes de criar um projeto. O IDE cria projetos no diretório do usuário, normalmente em %USERPROFILE%\source\repos.

Locais dos arquivos de comando do desenvolvedor

Caso prefira definir o ambiente de build em uma janela do prompt de comando existente, você pode usar um dos arquivos de comando criados pelo instalador. É recomendável que você defina o ambiente em uma janela de prompt de comando nova. Não é recomendável que você alterne ambientes posteriormente na mesma janela de comando.

A localização dos arquivos de comando depende da versão instalada do Visual Studio e das escolhas que você fez durante a instalação. No Visual Studio 2019, o local de instalação comum em um sistema de 64 bits é em \Program Files\Microsoft Visual Studio\2022\<edition>. Pode <edition> ser Community, Professional, Enterprise, BuildTools ou outro apelido fornecido por você.

O desenvolvedor primário de arquivo de comando de prompt de comando, VsDevCmd.bat, está localizado no subdiretório Common7\Tools. Quando não são especificados parâmetros, isso define que o ambiente use ferramentas nativas do x86 para build de código x86 de 32 bits.

Mais arquivos de comando estão disponíveis para configurar arquiteturas de build específicas. Os arquivos de comando disponíveis dependem das cargas de trabalho do Visual Studio e das opções que você instalou. No Visual Studio 2017 e Visual Studio 2019, você os encontrará no subdiretório VC\Auxiliary\Build.

Esses arquivos de comando definem os parâmetros padrão e chamam VsDevCmd.bat para configurar o ambiente da arquitetura de build especificada. Uma instalação típica pode incluir estes arquivos de comando:

Arquivo de comando	Arquiteturas de host e de destino
vcvars32.bat	Use as ferramentas nativas do x86 de 32 bits para compilar o código do x86 de 32 bits.
vcvars64.bat	Use as ferramentas nativas do x64 de 64 bits para compilar o código do x64 de 64 bits.
vcvarsx86_amd64.bat	Use as ferramentas cruzadas nativas do x86 de 32 bits para compilar o código do x64 de 64 bits.
vcvarsamd64_x86.bat	Use as ferramentas cruzadas nativas do x64 de 64 bits para compilar o código do x86 de 32 bits.
vcvarsx86_arm.bat	Use as ferramentas cruzadas nativas do x86 de 32 bits para compilar o código do ARM.
vcvarsamd64_arm.bat	Use as ferramentas cruzadas nativas do x64 de 64 bits para compilar o código do ARM.
vcvarsx86_arm64.bat	Use as ferramentas cruzadas nativas do x86 de 32 bits para compilar o código do ARM64.
vcvarsamd64_arm64.bat	Use as ferramentas cruzadas nativas do x64 de 64 bits para compilar o código do ARM64.
vcvarsall.bat	Use parâmetros para especificar as arquiteturas de host e de destino, as opções de plataforma e SDK do Windows. Para obter uma lista das opções compatíveis, faça uma chamada usando um parâmetro /help.

Cuidado

O arquivo vcvarsall.bat e outros arquivos de comando do Visual Studio podem variar conforme o computador. Não substitua um arquivo vcvarsall.bat não encontrado ou danificado usando um arquivo de outro computador. Execute novamente o Instalador do Visual Studio para substituir o arquivo ausente.

O arquivo vcvarsall.bat também varia de uma versão para outra. Se a versão atual do Visual Studio estiver instalada em um computador que também tem uma versão anterior do Visual Studio, não execute vcvarsall.bat nem outro arquivo de comando do Visual Studio de versões diferentes na mesma janela do prompt de comando.

Usar as ferramentas para desenvolvedores em uma janela Comando existente

A maneira mais simples de especificar uma arquitetura de build específica em uma janela Comando existente é usar o arquivo vcvarsall.bat. Use vcvarsall.bat para definir variáveis de ambiente para configurar a linha de comando para compilação nativa de 32 bits ou 64 bits. Os argumentos permitem especificar a compilação cruzada para processadores x86, x64, ARM ou ARM64. Você pode direcionar o Microsoft Store, a Plataforma Universal do Windows ou plataformas da Área de Trabalho do Windows. Você pode até mesmo especificar qual SDK do Windows usar e selecionar a versão do conjunto de ferramentas da plataforma.

Quando usado sem argumentos, vcvarsall.bat configura as variáveis de ambiente para usar o compilador nativo do x86 atual para destinos da Área de Trabalho do Windows de 32 bits. Você pode adicionar argumentos para configurar o ambiente para usar uma das ferramentas do compilador nativo ou cruzado. vcvarsall.bat exibe uma mensagem de erro se você especificar uma configuração que não está instalada ou não está disponível no computador.

Sintaxe de vcvarsall

vcvarsall.bat [architecture] [platform_type] [winsdk_version] [-vcvars_ver=vcversion] [spectre_mode]

architecture
Esse argumento opcional especifica a arquitetura de host e de destino a ser usada. Se a arquitetura não for especificada, o ambiente de build padrão será usado. Há suporte para estes argumentos:

architecture	Compilador	Arquitetura do computador host	Arquitetura da saída do build (destino)
x86	Nativa de 32 bits x86	x86, x64	x86
x86_amd64 ou x86_x64	Cruzada do x64 no x86	x86, x64	x64
x86_arm	ARM em x86 cruzado	x86, x64	ARM
x86_arm64	Cruzada do ARM64 no x86	x86, x64	ARM64
amd64 ou x64	Nativa do x64 de 64 bits	x64	x64
amd64_x86 ou x64_x86	Cruzada do x86 no x64	x64	x86
amd64_arm ou x64_arm	Cruzada do ARM no x64	x64	ARM
amd64_arm64 ou x64_arm64	Cruzada do ARM64 no x64	x64	ARM64

platform_type
Esse argumento opcional permite especificar store ou uwp como o tipo de plataforma. Por padrão, o ambiente está definido para compilar aplicativos da área de trabalho ou de console.

winsdk_version
Opcionalmente, especifica a versão do SDK do Windows a ser usada. Por padrão, o SDK do Windows mais recente instalado é usado. Para especificar a versão do SDK do Windows, é possível usar um número completo do SDK do Windows, como 10.0.10240.0 ou especifique 8.1 para usar o SDK do Windows 8.1.

vcversion
Opcionalmente, especifica o conjunto de ferramentas do compilador do Visual Studio a ser usado. Por padrão, o ambiente está definido para usar o conjunto de ferramentas do compilador do Visual Studio atual.

Usar -vcvars_ver=14.2x.yyyyy para especificar uma versão específica do conjunto de ferramentas do compilador do Visual Studio 2019.

Usar -vcvars_ver=14.29 para especificar a versão mais recente do conjunto de ferramentas do compilador do Visual Studio 2019.

Usar -vcvars_ver=14.0 para especificar o conjunto de ferramentas do compilador do Visual Studio 2015.

spectre_mode
Deixe esse parâmetro de fora para usar bibliotecas sem mitigações do Spectre. Use o valor spectre para usar bibliotecas com mitigações do Spectre.

Para configurar o ambiente de build em uma janela do prompt de comando existente

1. No prompt de comando, use o comando CD para alterar para o diretório de instalação do Visual Studio. Em seguida, use CD novamente para alterar para a subpasta que contém os arquivos de comando específicos da configuração. No Visual Studio 2019 e Visual Studio 2017, usar o subdiretório VC\Auxiliary\Build. No Visual Studio 2015, usar o subdiretório VC.

2. Insira o comando de seu ambiente de desenvolvedor preferido. Por exemplo, para compilar o código do ARM para o UWP em uma plataforma de 64 bits, usando o SDK do Windows mais recente e o conjunto de ferramentas de compilador do Visual Studio, use esta linha de comando:

   vcvarsall.bat amd64_arm uwp

Criar seu próprio atalho do prompt de comando

Abrir a caixa de diálogo Propriedades para um atalho de prompt de comando do desenvolvedor para ver o destino de comando usado. Por exemplo, o destino do atalho do Prompt de Comando de Ferramentas Nativas do x64 para VS 2019 é algo semelhante a:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"

Os arquivos em lotes específicos da arquitetura definem o parâmetro architecture e chamam vcvarsall.bat. É possível passar as mesmas opções para esses arquivos em lotes que você passaria para vcvarsall.bat ou somente chamar vcvarsall.batdiretamente. Para especificar parâmetros para seu próprio atalho de comando, adicione-os ao final do comando entre aspas duplas. Por exemplo, este é um atalho para o código ARM de build para UWP em uma plataforma de 64 bits, usando o SDK do Windows mais recente. Para usar um conjunto de ferramentas do compilador anterior, especifique o número da versão. Use algo como este destino de comando no atalho:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29

Ajuste o caminho para que ele reflita o diretório de instalação do Visual Studio. O arquivo vcvarsall.bat traz mais informações sobre os números de versão específicos.

Ferramentas da linha de comando

Para compilar um projeto C/C++ eu um prompt de comando, o Visual Studio fornece estas ferramentas de linha de comando:

CL
Use o compilador (cl.exe) para compilar e vincular arquivos de código-fonte a aplicativos, bibliotecas e DLLs.

Link
Use o vinculador (link.exe) para vincular arquivos de objetos compilados e bibliotecas a aplicativos e DLLs.

Durante o build na linha de comando, o comando F1 não fica disponível para ajuda instantânea. Em vez disso, use um mecanismo de pesquisa para obter informações sobre avisos, erros e mensagens. Você também pode baixar e usar os arquivos de ajuda offline. Para usar a pesquisa no Microsoft Learn, insira sua consulta na caixa de pesquisa na parte superior de qualquer artigo.

Ferramentas de gerenciamento de projeto de linha de comando

Por padrão, o IDE do Visual Studio usa sistemas nativos de build de projeto com base no MSBuild. Você pode invocar o MSBuild diretamente para criar projetos sem usar o IDE. Você também pode usar o comando devenv para usar o Visual Studio para criar projetos e soluções. O Visual Studio também dá suporte a sistemas de build baseados em CMake ou NMake.

MSBuild
Use o MSBuild (msbuild.exe) e um arquivo de projeto (.vcxproj) para configurar um build e invocar o conjunto de ferramentas sem carregar o IDE do Visual Studio. Isso é equivalente a executar o projeto Build ou o comando Compilar Solução no IDE do Visual Studio. O MSBuild tem vantagens sobre o IDE quando você compila na linha de comando. Você não precisa instalar o IDE completo em todos os servidores de build e pipelines de build. Você evita a sobrecarga extra do IDE. O MSBuild é executado em ambientes de build em contêineres e dá suporte a um agente binário.

DEVENV
Use o DEVENV (devenv.exe) combinado com uma opção de linha de comando como /Build ou /Clean para executar determinados comandos de build sem exibir o IDE do Visual Studio.

CMake
O CMake (cmake.exe) é uma ferramenta multiplataforma de código aberto para definir os processos de build executados em várias plataformas. O CMake pode configurar e controlar ferramentas de build nativas para suas plataformas com suporte, como o MSBuild e o Make. Para obter mais informações sobre CMake, confira a documentação do CMake.

NMAKE
Use o NMAKE (nmake.exe) para compilar projetos C++ usando um makefile tradicional.

Observação

A partir do Visual Studio 2019 versão 16.5, o MSBuild e o DEVENV não usam o ambiente de linha de comando para controlar o conjunto de ferramentas e as bibliotecas usadas.

Nesta seção

Esses artigos mostram como criar aplicativos na linha de comando e descrevem como personalizar o ambiente de build de linha de comando. Alguns mostram como usar conjuntos de ferramentas de 64 bits e as plataformas x86, x64, ARM e ARM64 de destino. Eles também descrevem o uso das ferramentas de build de linha de comando MSBuild e NMAKE.

Instruções passo a passo: compilando um programa do C++ nativo na linha de comando
Apresenta um exemplo que mostra como criar e compilar um programa C++ na linha de comando.

Instruções passo a passo: compilar um programa em C na linha de comando
Descreve como compilar um programa gravado na linguagem de programação C.

Demonstra Passo a passo: Compilando um programa C++/CLI na linha de comando
Descreve como criar e compilar um programa C++/CLI que usa o .NET Framework.

Demonstra Passo a passo: Compilando um programa C++/CX na linha de comando
Descreve como criar e compilar um programa C++/CX que usa o Windows Runtime.

Referência de NMAKE
Fornece links a artigos que descrevem o Microsoft Program Maintenance Utility (NMAKE.EXE).

MSBuild na linha de comando – C++
Fornece links para artigos que explicam como usar o msbuild.exe na linha de comando.

Seções relacionadas

/MD, /MT, /LD (Usar biblioteca em tempo de execução)
Descreve como usar essas opções do compilador para usar uma biblioteca de tempo de execução de depuração ou versão.

Opções do compilador do C/C++
Fornece links a artigos que falam sobre as opções de compilador da linguagem C e C++ e sobre o CL.exe.

Opções do vinculador MSVC
Fornece links a artigos que falam sobre as opções do vinculador e sobre o LINK.exe.

Ferramentas de compilação adicionais MSVC
Fornece links para as ferramentas de build do C/C++ incluídas no Visual Studio.

Confira também

Sistemas de build e projetos