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.

Baixar e instalar o agente as ferramentas

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.

Para abrir uma janela do 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.

Locais de arquivo 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.

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.

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:

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] [] [-vcvars_ver=winsdk_versionvcversion] [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:

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

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:

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.

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.

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.

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 de 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