Use as ferramentas de compilação do Microsoft C++ a partir da linha de comando

Você pode criar aplicativos C e C++ na linha de comando usando ferramentas incluídas no Visual Studio. As ferramentas de compilação do Microsoft C++ (MSVC) também podem ser baixadas 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 compilação de projeto nativo no Visual Studio, baseado em MSBuild, não usa o ambiente conforme descrito neste artigo. Para obter mais informações sobre como usar o MSBuild a partir da linha de comando, consulte MSBuild na linha de comando - C++.

Faça o download e instale as ferramentas

Se você instalou o Visual Studio e uma carga de trabalho C++, você tem todas as ferramentas de linha de comando. Para obter informações sobre como instalar C++ e Visual Studio, consulte Instalar suporte a C++ no Visual Studio. Se você quiser apenas o conjunto de ferramentas de linha de comando, baixe as Ferramentas de compilação para Visual Studio. Quando você executa o executável baixado, ele atualiza e executa o Visual Studio Installer. Para instalar apenas as ferramentas necessárias para o desenvolvimento em C++, selecione a carga de trabalho de desenvolvimento Desktop com C++ . Você pode selecionar bibliotecas opcionais e conjuntos de ferramentas para incluir em Detalhes da instalação. Para criar código usando os conjuntos de ferramentas do Visual Studio 2015, 2017 ou 2019, selecione as ferramentas de compilação opcionais MSVC v140, v141 ou v142. Quando estiver satisfeito com as suas seleções, escolha Instalar.

Como usar as ferramentas de linha de comando

Quando você escolhe uma das cargas de trabalho C++ no Visual Studio Installer, por padrão, ele instala uma versão específica do pacote MSVC Build Tools. Para o Visual Studio 2022 e versões anteriores, isso é organizado por um conjunto de ferramentas de 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 posterior, isso consiste na versão MSVC (formato de versão v##.##), que tem todas as ferramentas C e C++ para esse pacote MSVC específico. A versão MSVC é dissociada 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. Eles também são usados internamente pelo IDE do Visual Studio. 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. Você pode executar um desses arquivos de comando para definir uma arquitetura de compilação específica de host e destino, a versão do SDK do Windows e o 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 você tiver o Windows de 64 bits, as ferramentas hospedadas em x64 e as ferramentas cruzadas que criam código x86 e x64 também serão instaladas. Se você escolher as ferramentas opcionais da Plataforma Universal do Windows C++, as ferramentas x86 e x64 que criam código ARM e ARM64 também serã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 você mesmo defina essas variáveis 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. Utilize uma ferramenta de comparação, como a incorporada no Visual Studio, para destacar 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

No menu Iniciar do Windows, os atalhos do prompt de comando são instalados numa pasta do Visual Studio específica para a versão. 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.

A pasta do menu Iniciar e os nomes 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, suponha 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 Developer Command Prompt for VS 2022 (Latest), numa pasta chamada Visual Studio 2022.

Observação

Várias ferramentas de linha de comando ou opções de ferramentas podem exigir permissão de administrador. Se você tiver problemas de permissão ao usá-los, recomendamos que 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 para a 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. No Windows 11, escolha o botão Todos os aplicativos para abrir a lista de aplicativos instalados. No Windows 10, a lista está aberta à esquerda. Role a lista para baixo para localizar e abrir a pasta (não o aplicativo) da sua versão do Visual Studio, por exemplo, Visual Studio 2022.

2. Na pasta, escolha o prompt de comando do desenvolvedor para 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.

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 em seu diretório de usuário, normalmente em %USERPROFILE%\source\repos.

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 local do arquivo de comando depende da versão do Visual Studio instalada e das escolhas feitas durante a instalação. Para o Visual Studio 2019, o local de instalação típico em um sistema de 64 bits está em \Program Files\Microsoft Visual Studio\2022\<edition>. O <edition> pode ser Community, Professional, Enterprise, BuildTools ou outro apelido fornecido.

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.

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

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:

Arquivo de comando	Arquiteturas de host e de destino
vcvars32.bat	Use as ferramentas nativas x86 de 32 bits para criar código x86 de 32 bits.
vcvars64.bat	Use as ferramentas nativas x64 de 64 bits para criar código x64 de 64 bits.
vcvarsx86_amd64.bat	Utilize as ferramentas nativas de cruzamento x86 de 32 bits para compilar código x64 de 64 bits.
vcvarsamd64_x86.bat	Use as ferramentas cruzadas nativas x64 de 64 bits para criar código x86 de 32 bits.
vcvarsx86_arm.bat	Use as ferramentas cruzadas nativas x86 de 32 bits para criar código ARM.
vcvarsamd64_arm.bat	Utilize as ferramentas de compilação cruzada nativas de 64 bits x64 para criar código ARM.
vcvarsx86_arm64.bat	Use as ferramentas cruzadas nativas x86 de 32 bits para criar código ARM64.
vcvarsamd64_arm64.bat	Utilize as ferramentas cruzadas nativas x64 de 64 bits para criar código ARM64.
vcvarsall.bat	Use parâmetros para especificar as arquiteturas de host e de destino, o SDK do Windows e as opções de plataforma. Para obter uma lista de opções suportadas, chame usando um /help parâmetro.

Atenção

O vcvarsall.bat arquivo e outros arquivos de comando do Visual Studio podem variar de computador para computador. Não substitua um ficheiro em falta ou danificado vcvarsall.bat utilizando um ficheiro de outro computador. Execute novamente o instalador do Visual Studio para substituir o arquivo ausente.

O vcvarsall.bat arquivo também varia de versão para versão. Se a versão atual do Visual Studio estiver instalada em um computador que também tenha uma versão anterior do Visual Studio, não execute vcvarsall.bat ou outro arquivo de comando do Visual Studio de versões diferentes na mesma janela de prompt 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 destinar-se às plataformas Microsoft Store, Plataforma Universal do Windows e ao Windows Desktop. Você pode até 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 x86 atual para destinos da Área de Trabalho do Windows 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 a arquitetura não for especificada, o ambiente de compilação padrão será usado. Estes argumentos são suportados:

architecture	Compilador	Arquitetura do computador host	Construir arquitetura de saída (destino)
x86	x86 nativo de 32 bits	x86, x64	x86
x86_amd64 ou x86_x64	x64 em x86 compatibilidade cruzada	x86, x64	x64
x86_arm	ARM na cruz x86	x86, x64	ARM
x86_arm64	ARM64 na cruz x86	x86, x64	ARM64
amd64 ou x64	x64 nativo de 64 bits	x64	x64
amd64_x86 ou x64_x86	x86 na cruz x64	x64	x86
amd64_arm ou x64_arm	ARM em cruzamento com x64	x64	ARM
amd64_arm64 ou x64_arm64	ARM64 em x64 cruzado	x64	ARM64

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 ser usada. Por padrão, o SDK do Windows instalado mais recente é usado. Para especificar a versão do SDK do Windows, você pode usar um número completo do SDK do Windows, como 10.0.10240.0, ou especificar 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 é definido para usar o conjunto de ferramentas do compilador do Visual Studio atual.

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

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

Use -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 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 comando, use o comando CD para alterar para o diretório de instalação do Visual Studio. Em seguida, use o CD novamente para alterar para o subdiretório que contém os arquivos de comando específicos da configuração. Para Visual Studio 2019 e Visual Studio 2017, use o subdiretório VC\Auxiliary\Build . Para o Visual Studio 2015, use o subdiretório VC .

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

   vcvarsall.bat amd64_arm uwp

Crie o seu próprio atalho de prompt de comando

Abra a caixa de diálogo "Propriedades" de um atalho de prompt de comando do desenvolvedor para ver o destino de comando utilizado. Por exemplo, o destino do atalho x64 Native Tools Command Prompt for VS 2019 é algo semelhante a:

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

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 criar código ARM para UWP em uma plataforma de 64 bits, usando o SDK do Windows mais recente. 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

Ajuste o caminho para refletir seu diretório de instalação do Visual Studio. O arquivo vcvarsall.bat tem informações adicionais sobre números de versão específicos.

Ferramentas de linha de comando

Para criar um projeto C/C++ em 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 em aplicativos, bibliotecas e DLLs.

Link
Use o vinculador (link.exe) para vincular arquivos de objetos compilados e bibliotecas em aplicativos 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, insira sua consulta na caixa de pesquisa na parte superior de qualquer artigo.

Ferramentas de gerenciamento de projetos de linha de comando

Por padrão, o IDE do Visual Studio usa sistemas de compilação de projeto nativos baseados em MSBuild. Você pode invocar o MSBuild diretamente para criar projetos sem usar o IDE. Você também pode usar o comando para usar o devenv Visual Studio para criar projetos e soluções. Visual Studio também suporta sistemas de compilação baseados em CMake ou NMake.

MSBuild
Use MSBuild (msbuild.exe) e um arquivo de projeto (.vcxproj) para configurar uma compilação e invocar o conjunto de ferramentas sem carregar o IDE do Visual Studio. É equivalente a executar o projeto Build ou o comando Build Solution no IDE do Visual Studio. 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 uma opção de linha de comando, como /Build ou /Clean para executar determinados comandos de compilação sem exibir o IDE do Visual Studio.

CMake
CMake (cmake.exe) é uma ferramenta multiplataforma, de código aberto para definir processos de construção que são executados em várias 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 NMAKE (nmake.exe) para criar projetos C++ usando um makefile tradicional.

Observação

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

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 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 Tempo de Execução do Windows.

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

MSBuild na linha de comando - C++
Fornece links para artigos que discutem como usar msbuild.exe a partir da linha de comando.

Secções relacionadas

/MD, /MT, /LD (Usar biblioteca de 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 links para artigos que discutem as opções do compilador C e C++ e CL.exe.

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

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

Ver também

Projetos e construção de sistemas