Usa as Ferramentas de Compilação Microsoft C++ a partir da linha de comandos

Pode construir aplicações em C e C++ na linha de comandos usando ferramentas incluídas no Visual Studio. As Ferramentas de Build Microsoft C++ (MSVC) também podem ser descarregadas como um pacote independente. Não precisas de instalar o Visual Studio IDE se não planeias usá-lo.

Faça o download e instale as ferramentas

Como usar as ferramentas de linha de comando

Quando escolhe uma das workloads de C++ no Visual Studio Installer, por padrão, instala-se uma versão específica do pacote MSVC Build Tools. Para Visual Studio 2022 e anteriores, isto é organizado por um conjunto de ferramentas plataforma (formato de versão v###) que tem todas as ferramentas C e C++ para uma versão específica do Visual Studio. Para o Visual Studio 2026 e posteriores, isto consiste na versão MSVC (formato v##.##), que inclui todas as ferramentas C e C++ para esse pacote MSVC em particular. A versão MSVC está desacoplada da versão do Visual Studio. As ferramentas incluem os compiladores C/C++, vinculadores, assemblers e outras ferramentas de compilação, e bibliotecas correspondentes e arquivos de cabeçalho. Você pode usar todas essas ferramentas na linha de comando. Também são usados internamente pelo Visual Studio IDE. Existem compiladores e ferramentas separados hospedados em x86 e x64 que criam código para destinos x86, x64, ARM e ARM64. Cada conjunto de ferramentas para uma determinada arquitetura de compilação de host e destino é armazenado em seu próprio diretório.

Para funcionar corretamente, as ferramentas exigem que várias variáveis de ambiente específicas sejam definidas. Essas variáveis são usadas para adicionar as ferramentas ao caminho e para definir os locais de incluir arquivos, 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 lote, durante a instalação. Podes executar um destes ficheiros de comandos para definir uma arquitetura de build específica para host e target, versão do SDK do Windows e conjunto de ferramentas da plataforma. Por conveniência, o instalador também cria atalhos no menu Iniciar. Os atalhos abrem as janelas do 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 para sua instalação e para a arquitetura de construção escolhida. Eles também podem ser alterados por atualizações de produtos ou upgrades. Essa variabilidade é uma das razões pelas 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 selecionadas durante a instalação. As ferramentas hospedadas em x86 e as ferramentas cruzadas que criam código x86 e x64 estão sempre instaladas. Se tiver Windows de 64 bits, as ferramentas hospedadas em x64 e as ferramentas de cruzamento que compilam código x86 e x64 também estão instaladas. Se escolheres as ferramentas opcionais C++ Plataforma Universal do Windows, então as ferramentas x86 e x64 que compilam código ARM e ARM64 também são instaladas. Outras cargas de trabalho podem instalar essas e outras ferramentas.

Variáveis de caminho e ambiente para compilações de linha de comando

As ferramentas de linha de comando MSVC usam as variáveis de ambiente PATH, TMP, INCLUDE, LIB e LIBPATH, e também usam outras variáveis de ambiente específicas para as suas ferramentas, plataformas e SDKs instalados. Mesmo uma instalação simples do Visual Studio pode definir vinte ou mais variáveis de ambiente. Essa complexidade é o motivo pelo qual recomendamos que você use um atalho de prompt de comando do desenvolvedor ou um dos arquivos de comando personalizados. Não recomendamos que definas estas variáveis tu próprio no ambiente Windows.

Para ver quais variáveis de ambiente são definidas por um atalho de prompt de comando do desenvolvedor, você pode usar o SET comando. Abra uma janela de prompt de comando simples e capture a saída do comando SET como uma referência. Abra uma janela de prompt de comando do desenvolvedor e capture a saída do comando SET para comparação. Use uma ferramenta diferencial, como a que está integrada no Visual Studio, para destacar as variáveis de ambiente definidas pelo prompt de comandos do programador. 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 comandos estão instalados numa pasta específica de versão do Visual Studio no menu Iniciar do Windows. Aqui está uma lista dos atalhos do prompt de comando base e as arquiteturas de compilação que eles suportam:

• Prompt de Comando do Desenvolvedor - Define o ambiente para usar ferramentas nativas x86 de 32 bits para criar código nativo x86 de 32 bits.
• x86 Native Tools Command Prompt - Define o ambiente para usar ferramentas nativas x86 de 32 bits para criar código nativo x86 de 32 bits.
• x64 Native Tools Command Prompt - Define o ambiente para usar ferramentas nativas de x64 para criar código nativo de 64 bits.
• x86_x64 Cross Tools Command Prompt - Define o ambiente para usar ferramentas nativas x86 de 32 bits para criar código nativo x64 de 64 bits.
• x64_x86 Cross Tools Command Prompt - Define o ambiente para usar ferramentas nativas de x64 de 64 bits para criar código nativo de x86 de 32 bits.

Para abrir uma janela de prompt de comando do desenvolvedor

1. No ambiente de trabalho, abra o menu Windows Start. No Windows 11, escolha o botão Todas as aplicações para abrir a lista de aplicações instaladas. No Windows 10, a lista está aberta à esquerda. Desça a lista para encontrar e abrir a pasta (não a aplicação) da sua versão do Visual Studio, por exemplo, Visual Studio 2022.

2. Na pasta, escolha o Developer Command Prompt para a sua versão do Visual Studio. Esse atalho inicia uma janela de prompt de comando do desenvolvedor que usa a arquitetura de compilação padrão de ferramentas nativas x86 de 32 bits para criar código nativo x86 de 32 bits. Se preferir uma arquitetura de compilação não padrão, escolha um dos prompts de comando nativos ou de ferramentas cruzadas para especificar a arquitetura de host e de destino.

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

Locais dos arquivos de comando do desenvolvedor

Se preferir definir o ambiente de compilação em uma janela de prompt de comando existente, você pode usar um dos arquivos de comando criados pelo instalador. Recomendamos que você defina o ambiente em uma nova janela de prompt de comando. Não recomendamos que você alterne ambientes posteriormente na mesma janela de comando.

O ficheiro de comando principal do prompt de comando do desenvolvedor, VsDevCmd.bat, está localizado no sub-diretório Common7\Tools. Quando nenhum parâmetro é especificado, ele define o ambiente para usar as ferramentas nativas x86 para criar código x86 de 32 bits.

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

Usar as ferramentas de desenvolvedor em uma janela de comando existente

A maneira mais simples de especificar uma arquitetura de compilação específica em uma janela de comando existente é usar o vcvarsall.bat arquivo. 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. Pode direcionar-se para a Microsoft Store, Plataforma Universal do Windows ou plataformas Windows Desktop. Podes até especificar qual o SDK do Windows a 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 x86-nativo atual para alvos de Windows Desktop de 32 bits. Você pode adicionar argumentos para configurar o ambiente para usar qualquer uma das ferramentas nativas ou de compilador 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 seu computador.

vcvarsall sintaxe

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

architecture
Esse argumento opcional especifica a arquitetura de host e destino a ser usada. Se architecture não for especificado, usa-se o ambiente de construção padrão. Estes argumentos são suportados:

platform_type
Esse argumento opcional permite especificar store ou uwp como o tipo de plataforma. Por padrão, o ambiente é definido para criar aplicativos de desktop ou console.

winsdk_version
Opcionalmente, especifica a versão do SDK do Windows a utilizar. Por padrão, é utilizado o SDK do Windows instalado mais recente. Para especificar a versão Windows SDK, pode usar um número Windows SDK completo, como 10.0.10240.0, ou especificar 8.1 para usar o SDK Windows 8.1.

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

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

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

Para configurar o ambiente de compilação numa janela de prompt de comando existente

1. No prompt de comandos, use o comando CD para mudar para o diretório de instalação Visual Studio. Depois, use CD novamente para mudar para o subdiretório que contém os ficheiros de comandos específicos da configuração. Para Visual Studio 2019 e Visual Studio 2017, utilize o subdiretório VC\Auxiliary\Build. Para Visual Studio 2015, utilize o subdiretório VC.

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

   vcvarsall.bat amd64_arm uwp
   

Crie o seu próprio atalho de prompt de comando

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64

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

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0

Ajusta o caminho para refletir o diretório de instalação do Visual Studio. O vcvarsall.bat ficheiro contém informações adicionais sobre números de versão específicos.

Ferramentas de linha de comando

Para construir um projeto em C/C++ num prompt de comandos, o Visual Studio disponibiliza estas ferramentas de linha de comandos:

CL
Use o compilador (cl.exe) para compilar e ligar ficheiros de código-fonte a aplicações, bibliotecas e DLLs.

Link
Use o linker (link.exe) para ligar ficheiros de objetos compilados e bibliotecas em aplicações e DLLs.

Quando constróis na linha de comando, o comando F1 não está disponível para ajuda instantânea. Em vez disso, você pode usar 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, introduza a sua consulta na caixa de pesquisa no topo de qualquer artigo.

Ferramentas de gerenciamento de projetos de linha de comando

Por defeito, o Visual Studio IDE utiliza sistemas nativos de compilação de projetos baseados no MSBuild. Você pode invocar o MSBuild diretamente para criar projetos sem usar o IDE. Também podes usar o comando devenv para usar Visual Studio e construir projetos e soluções. O Visual Studio também suporta sistemas de compilação baseados em CMake ou NMake.

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

DEVENV
Use DEVENV (devenv.exe) combinado com um comutador de linha de comandos como /Build ou /Clean para executar certos comandos de compilação sem mostrar o Visual Studio IDE.

CMake
CMake (cmake.exe) é uma ferramenta multiplataforma e de código aberto para definir processos de compilação que correm em múltiplas plataformas. O CMake pode configurar e controlar ferramentas de compilação nativas para suas plataformas suportadas, como MSBuild e Make. Para obter mais informações sobre o CMake, consulte a documentação do CMake.

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

Nesta secção

Estes artigos mostram como criar aplicativos na linha de comando e descrevem como personalizar o ambiente de compilação de linha de comando. Alguns mostram como utilizar conjuntos de ferramentas de 64 bits e apontar para plataformas x86, x64, ARM e ARM64. Eles também descrevem o uso das ferramentas de compilação de linha de comando MSBuild e NMAKE.

Passo a passo: Compilando um programa C++ nativo na linha de comando
Fornece um exemplo que mostra como criar e compilar um programa C++ na linha de comando.

Passo a passo: Compilar um programa C na linha de comando
Descreve como compilar um programa escrito 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 utilize 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 utiliza o Windows Runtime.

Referência NMAKE
Fornece ligações para artigos que descrevem a Microsoft Program Maintenance Utility (NMAKE.EXE).

MSBuild na linha de comando - C++
Fornece ligações para artigos que discutem como usar msbuild.exe a partir da linha de comandos.

Secçõ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 Debug ou Release.

Opções do compilador C/C++
Fornece ligações para artigos que discutem as opções dos compiladores C e C++ e CL.exe.

opções do vinculador MSVC
Fornece ligações para artigos que discutem as opções do linker e LINK.exe.

Ferramentas de compilação MSVC adicionais
Fornece ligações para as ferramentas de compilação em C/C++ incluídas no Visual Studio.

Ver também

Projetos e construção de sistemas