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. Também pode descarregar as Ferramentas de Build do Microsoft C++ (MSVC) como um pacote independente. Não precisas de instalar o Visual Studio IDE se não planeias usá-lo.

Observação

Este artigo trata de como configurar um ambiente para usar compiladores individuais, linkers, bibliotecas e outras ferramentas básicas. O sistema nativo de construção do projeto no Visual Studio, baseado no MSBuild, não utiliza 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 instalares o Visual Studio e uma carga de trabalho em C++, tens todas as ferramentas de linha de comandos. Para informações sobre como instalar C++ e Visual Studio, consulte Install suporte a C++ em Visual Studio.

Se quiser apenas as ferramentas de linha de comandos, descarregue o Build Tools for Visual Studio. Na página de downloads, expanda Tools for Visual Studio para encontrar o download das Build Tools. Quando executas o executável descarregado, ele atualiza-se 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++ . Em Detalhes de instalação, pode selecionar bibliotecas e conjuntos de ferramentas opcionais. Para compilar código utilizando os conjuntos de ferramentas Visual Studio 2015, Visual Studio 2017 ou Visual Studio 2019, selecione as ferramentas 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 escolhe uma das cargas de trabalho C++ no Visual Studio Installer, instala-se por defeito uma versão específica do pacote MSVC Build Tools. Para Visual Studio 2022 e anteriores, o pacote está organizado por um conjunto de ferramentas plataforma (formato de versão v###) que inclui todas as ferramentas C e C++ para uma versão específica de Visual Studio. A partir do Visual Studio 2026, a versão MSVC é desacoplada da versão do Visual Studio. Ou seja, a partir do Visual Studio 2026 o pacote corresponde à versão do conjunto de ferramentas MSVC (formato de versão v##.##), que inclui todas as ferramentas C e C++ para esse pacote específico do MSVC Build Tools.

As ferramentas incluem compiladores C/C++, linkers, assemblers e outras ferramentas de compilação. Inclui bibliotecas e ficheiros de cabeçalho correspondentes. Podes usar todas estas ferramentas na linha de comandos. O Visual Studio IDE utiliza-os internamente. 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.

As ferramentas requerem que várias variáveis de ambiente sejam definidas. Estas variáveis adicionam as ferramentas ao caminho e definem as localizações dos ficheiros de inclusão, ficheiros 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.

Para conveniência, o instalador também cria atalhos no menu Iniciar . Os atalhos abrem janelas da Linha de Comandos para Programadores, utilizando estes ficheiros de comandos para combinações específicas de arquiteturas anfitriã e de 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. Atualizações ou atualizações de produtos podem alterar as variáveis. 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, ficheiros de comandos e atalhos que o instalador adiciona dependem do processador do seu computador e das opções que seleciona 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 escolher as ferramentas opcionais C++ Plataforma Universal do Windows, também estão instaladas as ferramentas x86 e x64 que compilam código ARM e ARM64. Outras cargas de trabalho podem instalar estas ferramentas.

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

As ferramentas de linha de comandos do MSVC usam as variáveis de ambiente PATH, TMP, INCLUDE, LIB e LIBPATH. Também usam outras variáveis de ambiente específicas das 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 as variáveis de ambiente que um atalho do prompt de comandos do programador configura, use o SET comando. Abra uma janela normal do Prompt de Comando e capture a saída do comando SET para referência. Abra uma janela da Linha de Comandos do Programador 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 da linha de comandos são instalados numa pasta do Visual Studio específica da versão 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:

• Linha de Comandos do Programador. Define o ambiente para usar ferramentas x86 de 32 bits para construir código x86 de 32 bits.
• Linha de Comandos das Ferramentas Nativas x86. Define o ambiente para usar ferramentas x86 de 32 bits para construir código x86 de 32 bits.
• Linha de Comandos das Ferramentas Nativas do x64. Define o ambiente para usar ferramentas x64 de 64 bits para construir código x64 de 64 bits.
• Linha de Comandos das Ferramentas Cruzadas x86_x64. Define o ambiente para usar ferramentas x86 de 32 bits para construir código x64 de 64 bits.
• x64_x86 Linha de Comando Cross Tools. Define o ambiente para usar ferramentas x64 de 64 bits para construir código x86 de 32 bits.

A pasta de menu Start e os nomes dos atalhos variam consoante a versão instalada do Visual Studio. Por exemplo, o atalho de prompt para programadores para Visual Studio 2022 chama-se Developer Command Prompt para VS 2022 em Start>Programs>Visual Studio 2022>Visual Studio Tools.

Observação

Várias ferramentas ou opções de linha de comandos requerem privilégios de Administrador. Se tiver problemas de permissão ao usá-los, recomendamos que abra a janela do Prompt de Comando do programador usando a opção Executar como Administrador . Clique com o botão direito para abrir o menu de atalho da janela do Prompt de Comandos, depois escolha Mais>Executar como administrador.

Para abrir uma janela da Linha de Comandos de programador

1. No ambiente de trabalho, abra o menu Windows Start. No Windows 11, escolha 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, como Visual Studio 2022 ou Visual Studio para a versão 2026 e posteriores.
2. Na pasta, escolha o Developer Command Prompt para a sua versão do Visual Studio. Este atalho inicia uma janela da Linha de Comandos para programadores que configura o ambiente para utilizar ferramentas x86 de 32 bits para compilar código x86 de 32 bits. Se preferir uma arquitetura de compilação não predefinida, escolha um dos prompts de comando nativos ou de ferramentas de compilação cruzada para especificar a arquitetura do sistema anfitrião e do 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 defeito, o diretório de trabalho atual num prompt de comandos de programador é a raiz da sua instalação do Visual Studio no diretório Program Files. Esta localização não é apropriada para o teu código e projetos. Altere o diretório de trabalho atual para outro local antes de criar um projeto. O IDE cria projetos no seu diretório de utilizador, normalmente em %USERPROFILE%\source\repos.

Locais dos arquivos de comando do desenvolvedor

Se preferires definir o ambiente de compilação numa janela de Prompt de Comando existente, podes usar um dos ficheiros de comando criados pelo instalador. Recomendamos que configure o ambiente numa nova janela da Linha de Comandos. Não recomendamos que você alterne ambientes posteriormente na mesma janela de comando.

A localização do ficheiro de comandos depende da versão do Visual Studio que instalou e das escolhas que fez durante a instalação. Para Visual Studio 2022, o local típico de instalação é C:\Program Files\Microsoft Visual Studio\2022\<edition>. Podem <edition> ser Community, Professional, Enterprise, BuildTools.

O ficheiro principal do prompt de comandos do programador, VsDevCmd.bat, está localizado no Common7\Tools diretório. Quando não especificas parâmetros, isso define o ambiente para usar as ferramentas nativas x86 para construir código x86 de 32 bits.

Mais arquivos de comando estão disponíveis para configurar arquiteturas de compilação específicas. Os ficheiros de comandos disponíveis dependem das cargas de trabalho do Visual Studio e das opções que instalaste. Em Visual Studio 2017 e Visual Studio 2019, encontra-se no diretó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 ficheiros de comandos:

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 anfitriã e destino, SDK do Windows e escolhas de plataforma. Para obter uma lista de opções suportadas, chame usando um /help parâmetro.

Atenção

O ficheiro vcvarsall.bat e outros ficheiros de comandos Visual Studio podem variar de computador para computador. Não substitua um ficheiro em falta ou danificado vcvarsall.bat usando um ficheiro de outro computador. Execute novamente o instalador do Visual Studio para substituir o ficheiro em falta.

O vcvarsall.bat arquivo também varia de versão para versão. Se a versão atual do Visual Studio estiver instalada num computador que também tenha uma versão anterior do Visual Studio, não execute vcvarsall.bat nem outro ficheiro de comandos Visual Studio de versões diferentes na mesma janela do Prompt de Comandos.

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. Utilize vcvarsall.bat para definir variáveis de ambiente para configurar a janela da Linha de Comandos para compilação nativa de 32 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 utiliza vcvarsall.bat sem argumentos, configura as variáveis de ambiente para utilizar o compilador nativo x86 atual para destinos do Ambiente de Trabalho do Windows de 32 bits. Adiciona argumentos para configurar o ambiente para usar qualquer uma das ferramentas nativas ou de compiladores cruzados. vcvarsall.bat Aparece uma mensagem de erro se especificar uma configuração que não está instalada, ou que 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 não especificares architecture, é usado o ambiente de construção padrão. Os seguintes argumentos são sustentados:

  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

  Este argumento opcional especifica 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, use um número completo Windows SDK, como 10.0.10240.0, ou especifique 8.1 para usar o SDK Windows 8.1.

• vcversion

  Opcionalmente, especifica o conjunto de ferramentas do compilador Visual Studio a utilizar. Por predefinição, o ambiente utiliza o conjunto de ferramentas do compilador do Visual Studio instalado mais recentemente. A tabela seguinte mostra valores de exemplo vcvars_ver :

  vcvars_ver={value}	Result	Exemplo VS 2026	Exemplo VS 2022	Exemplo VS 2019	Exemplo VS 2017
  "Preview"	Use o conjunto de ferramentas do compilador Visual Studio Preview.	Supported	Não suportado	Não suportado	Não suportado
  "14.0"	Use o conjunto de ferramentas compilador Visual Studio 2015.	Supported	Supported	Supported	Supported
  "14.xx"	Usa o conjunto de ferramentas mais recente instalado 14.xx.yyyyy .	"14.51"	"14.44"	"14.29"	"14.16"
  "14.xx.yyyyy"	Use um número de versão completo específico.	"14.51.36231"	"14.44.35207"	"14.29.30133"	"14.16.27034"

• spectre_mode

  Deixe esse parâmetro de fora para usar bibliotecas sem atenuações do Spectre. Especifique spectre para utilizar bibliotecas com atenuações para 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. Por exemplo, C:\Program Files\Microsoft Visual Studio\18\Professional se estiveres a usar Visual studio 2026. 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 2017 e seguintes, 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 este 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 uma linha de comandos de programador para ver qual o destino do comando utilizado. Por exemplo, o destino do atalho Developer Command Prompt for VS 2022 é semelhante a:

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

Os arquivos em lote específicos da arquitetura definem o parâmetro architecture e chamam o vcvarsall.bat. Podes passar as mesmas opções para estes ficheiros batch à medida que passas para vcvarsall.bat, ou podes simplesmente ligar vcvarsall.bat diretamente. Para especificar parâmetros para o seu próprio atalho de comando, adicione-os ao final do comando entre aspas duplas. Para usar um conjunto de ferramentas de compilador anterior, especifique o número da versão.

Só podes direcionar o ARM64 a partir do Visual Studio 2026 porque o direcionamento do ARM32 foi removido nessa altura.

Aqui está um atalho para compilar código ARM64 para UWP numa plataforma de 64 bits, usando o mais recente SDK do Windows. O direcionamento para ARM64 é apresentado no Visual Studio 2026 e em versões posteriores. A definição de ARM32 como destino é apresentada para versões anteriores.

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

Ajusta o caminho para refletir o diretório de instalação do Visual Studio. O vcvarsall.bat ficheiro contém mais informações 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 open-source multiplataforma 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.

Observação

A partir do Visual Studio 2019 versão 16.5, o MSBuild e o DEVENV deixam de usar o ambiente de linha de comandos para controlar o conjunto de ferramentas e bibliotecas utilizados.

Ver também

• Passo a passo: Compilando um programa C++ nativo na linha de comando
• Passo a passo: Compilar um programa C na linha de comando
• Passo a passo: Compilando um programa C++/CLI na linha de comando
• Passo a passo: Compilando um programa C++/CX na linha de comando
• Projetos e construção de sistemas
• /MD, /MT, /LD (Usar biblioteca em tempo de execução)
• Opções do compilador C/C++
• opções do vinculador MSVC
• Ferramentas de compilação MSVC adicionais