Passo a passo: compilando um programa C++ nativo na linha de comando

O Visual Studio inclui um compilador do C e C++ para linha de comando. Você pode usá-lo para criar tudo, desde aplicativos de console básicos até aplicativos da Plataforma Universal do Windows, aplicativos da área de trabalho, drivers de dispositivo e componentes do .NET.

Neste passo a passo, você cria um programa básico do C++ no estilo "Olá, Mundo" usando um editor de texto e, em seguida, o compila na linha de comando. Caso queira experimentar o IDE do Visual Studio em vez de usar a linha de comando, confira Passo a passo: trabalhar com projetos e soluções (C++) ou Como usar o IDE do Visual Studio para desenvolvimento da área de trabalho em C++.

Neste passo a passo, você pode usar seu próprio programa C++ em vez de digitar o usado aqui. Ou você pode usar um exemplo de código C++ de outro artigo.

Pré-requisitos

Para concluir este passo a passo, você deve ter o Visual Studio e a carga de trabalho opcional Desenvolvimento para desktop com C++ ou as ferramentas de compilação de linha de comando do Visual Studio.

O Visual Studio é um IDE (ambiente de desenvolvimento integrado). Ele dá suporte a um editor completo, gerenciadores de recursos, depuradores e compiladores para muitas linguagens e plataformas. As versões disponíveis incluem a edição Visual Studio Community gratuita e todas dão suporte ao desenvolvimento em C e C++. Para saber mais sobre como baixar e instalar o Visual Studio, confira Instalar o suporte ao C++ no Visual Studio.

As Ferramentas de Build para Visual Studio instalam apenas os compiladores de linha de comando, as ferramentas e as bibliotecas necessárias para criar programas em C e C++. Elas são perfeitas para criar exercícios de laboratórios ou de sala de aula e são instaladas relativamente rápido. Para instalar apenas as ferramentas de linha de comando, procure Build Tools for Visual Studio em Visual Studio Downloads.

Para criar um programa em C ou C++ na linha de comando, verifique se as ferramentas estão instaladas e se você consegue acessá-las na linha de comando. O Microsoft C++ (MSVC) tem requisitos complexos para que o ambiente de linha de comando encontre as ferramentas, cabeçalhos e bibliotecas que ele usa.

Você não pode usar o Microsoft C++ em um prompt de comando comum sem fazer alguns preparativos. O Microsoft C++ instala atalhos para que você possa abrir um prompt de comando do desenvolvedor com o ambiente configurado para compilações pela linha de comando. Infelizmente, os nomes dos atalhos de prompt de comando do desenvolvedor e onde eles estão localizados são diferentes em quase todas as versões do Visual Studio e em diferentes versões do Windows. Sua primeira tarefa no tutorial é encontrar o elemento certo para usar.

Abra um prompt de comando para desenvolvedor

1. Se você tiver Visual Studio 2017 ou posterior no Windows 10 ou posterior, abra o menu Start e escolha Todos aplicativos. Role para baixo e abra a pasta do Visual Studio (não o aplicativo do Visual Studio). Escolha Prompt de Comando do Desenvolvedor para VS para abrir a janela do prompt de comando.

   Se você tiver o Microsoft Visual Studio Build Tools 2015 no Windows 10 ou mais recente, abra o menu Start e escolha Todos os aplicativos. Role para baixo e abra a pasta Ferramentas de Build do Visual Studio . Escolha o Prompt de Comando das Ferramentas Nativas x86 para abrir a janela de comando.

   Você também pode usar a função de pesquisa do Windows para procurar pelo prompt de comando do desenvolvedor e escolher aquele que corresponda à versão do Visual Studio instalada. Use o atalho para abrir a janela do prompt de comando.

2. Verifique se o prompt de comando do desenvolvedor do C++ está configurado corretamente. Na janela do prompt de comando, insira cl e verifique se a saída é semelhante a esta:

   C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise>cl
   Microsoft (R) C/C++ Optimizing Compiler Version 19.10.25017 for x86
   Copyright (C) Microsoft Corporation.  All rights reserved.
   
   usage: cl [ option... ] filename... [ /link linkoption... ]
   

Pode haver diferenças no diretório atual ou nos números de versão. Esses valores dependem da versão do MSVC e de todas as atualizações instaladas. Se a saída for semelhante ao que você vê, você estará pronto para criar programas C ou C++ na linha de comando.

Se você não conseguir encontrar o atalho do prompt de comando do desenvolvedor ou se receber uma mensagem de erro ao inserir cl, a instalação do MSVC poderá ter um problema. Tente reinstalar o componente MSVC no Visual Studio ou nas Ferramentas de Build do Visual Studio. Não avance para a próxima seção até que o comando cl funcione. Para obter mais informações sobre como instalar e solucionar problemas do MSVC, consulte Instalar o Visual Studio.

Criar um arquivo de origem C++ e compilá-lo na linha de comando

1. Na janela do prompt de comando do desenvolvedor, insira md C:\hello para criar um diretório e, em seguida, insira cd C:\hello para acessar esse diretório. Esse diretório é o local em que o arquivo de origem e o programa compilado são criados.

2. Insira notepad hello.cpp na janela do prompt de comando.

   Escolha Sim quando o Bloco de notas solicitar a criação de um arquivo. Esta etapa abre uma janela do Bloco de Notas em branco, pronta para você inserir seu código em um arquivo chamado hello.cpp.

3. No Bloco de Notas, insira o seguinte código:

   #include <iostream>
   using namespace std;
   int main()
   {
       cout << "Hello, world, from Microsoft C++!" << endl;
   }
   

   Esse código é um programa simples que grava uma linha de texto na tela e, em seguida, é encerrado. Para minimizar os erros, copie esse código e cole-o no Bloco de notas.

4. Salve seu trabalho! No Bloco de notas, no menu Arquivo, escolha Salvar.

   Parabéns! Você criou um arquivo de origem C++, hello.cppque está pronto para compilar.

5. Retorne para a janela de comandos do desenvolvedor. Insira dir no prompt de comando para listar o conteúdo do diretório C:\hello. Você deverá ver o arquivo de origem hello.cpp na listagem do diretório, que se parece com:

   C:\hello>dir
    Volume in drive C is Local Disk
    Volume Serial Number is AA11-BB22
   
    Directory of C:\hello
   
   04/28/2026  01:26 PM    <DIR>          .
   04/28/2026  01:26 PM    <DIR>          ..
   04/28/2026  01:27 PM               117 hello.cpp
                  1 File(s)            117 bytes
   

   As datas e outros detalhes serão diferentes em seu computador.

   Observação

   Se você não vir o arquivo do código-fonte, hello.cpp, verifique se o diretório de trabalho atual no prompt de comando é o diretório C:\hello que você criou. Verifique também se esse local é o diretório em que você salvou o arquivo de origem.

   Verifique se você salvou o código-fonte com uma .cpp extensão de nome de arquivo, não uma .txt extensão. Seu arquivo de origem é salvo no diretório atual como um arquivo .cpp automaticamente se você abrir o Bloco de notas no prompt de comando usando o comando notepad hello.cpp.

   O comportamento do Bloco de notas é diferente se você abri-lo de outra maneira: por padrão, o Bloco de notas acrescenta uma extensão .txt a novos arquivos quando você os salva. Ele também usa como padrão salvar arquivos em seu Documents diretório. Para salvar o arquivo com uma extensão .cpp no Bloco de notas, escolha Arquivo>Salvar Como. Na caixa de diálogo Salvar como , navegue até a pasta C:\hello no controle de exibição de árvore de diretório. Em seguida, use o menu suspenso Salvar como para selecionar Todos os Arquivos (*.*). Insira hello.cpp no controle de edição do Nome do arquivo e escolha Salvar para salvar o arquivo.

6. No prompt de comando do desenvolvedor, insira cl /EHsc hello.cpp para compilar seu programa.

   O compilador cl.exe gera um arquivo .obj que contém o código compilado e, em seguida, executa o vinculador para criar um programa executável chamado hello.exe. Esse nome é exibido nas linhas das informações de saída exibidas pelo compilador. A saída do compilador deverá ter uma aparência semelhante a esta:

   C:\hello>cl /EHsc hello.cpp
   Microsoft (R) C/C++ Optimizing Compiler Version 19.10.25017 for x86
   Copyright (C) Microsoft Corporation.  All rights reserved.
   
   hello.cpp
   Microsoft (R) Incremental Linker Version 14.10.25017.0
   Copyright (C) Microsoft Corporation.  All rights reserved.
   
   /out:hello.exe
   hello.obj
   

   Observação

   Se você receber um erro como "'cl' não for reconhecido como um comando interno ou externo, programa operável ou arquivo em lote", erro C1034 ou erro LNK1104, o prompt de comando do desenvolvedor não será configurado corretamente. Para obter informações sobre como corrigir esse problema, volte para a seção Abrir um prompt de comando do desenvolvedor.

   Se você receber um erro ou aviso diferente do compilador ou do vinculador, examine o código-fonte para corrigir erros e, em seguida, salve-o e execute o compilador novamente. Para obter informações sobre erros específicos, use a caixa de pesquisa para procurar o número do erro.

7. Para executar o programa hello.exe, no prompt de comando, insira hello.

   O programa exibe este texto e é fechado:

   Hello, world, from Microsoft C++!
   

   Parabéns! Você compilou e executou um programa C++ usando as ferramentas de linha de comando.

Próximas etapas

Este exemplo de "Olá, Mundo" é tão simples quanto um programa C++ pode ser. Os programas do mundo real geralmente têm arquivos de cabeçalho, mais arquivos de origem e link para bibliotecas.

Você pode usar as etapas neste passo a passo para criar seu próprio código em C++ em vez de digitar o código de exemplo mostrado. Essas etapas também permitem criar muitos programas de exemplo de código do C++ que você encontra em outros lugares. Você pode colocar seu código-fonte e criar seus aplicativos em qualquer diretório gravável. Por padrão, o Visual Studio IDE cria projetos em sua pasta de usuário, em uma subpasta source\repos. Versões mais antigas podem colocar projetos em uma pasta Documents\Visual Studio \{version}\Projects.

Para compilar um programa que tenha outros arquivos de código-fonte, insira todos eles na linha de comando, como:

cl /EHsc file1.cpp file2.cpp file3.cpp

A opção de linha de comando /EHsc instrui o compilador a habilitar o comportamento padrão de tratamento de exceções do C++. Sem isso, as exceções lançadas podem resultar em objetos não liberados e vazamentos de recursos. Para obter mais informações, consulte /EH (modelo de tratamento de exceção).

Quando você fornece outros arquivos de origem, o compilador usa o primeiro arquivo de entrada para criar o nome do programa. Nesse caso, ele gera um programa chamado file1.exe. Para alterar o nome para program1.exe, adicione uma opção de vinculador /out:

cl /EHsc file1.cpp file2.cpp file3.cpp /link /out:program1.exe

Para capturar mais erros de programação automaticamente, recomendamos que você compile usando a opção de nível de aviso /W3 ou /W4 :

cl /W4 /EHsc file1.cpp file2.cpp file3.cpp /link /out:program1.exe

O compilador, cl.exe, tem muitas outras opções. Você pode aplicá-las para compilar, otimizar, depurar e analisar seu código. Para ver uma lista rápida, insira cl /? no prompt de comando do desenvolvedor. Você também pode compilar e vincular separadamente e aplicar opções do vinculador em cenários de compilação mais complexos. Para obter mais informações sobre opções e uso do compilador e do vinculador, confira Referência de Build do C/C++.

Você pode usar NMAKE e makefiles, MSBuild e arquivos de projeto, ou CMake, para configurar e criar projetos mais complexos na linha de comando. Para obter mais informações sobre como usar essas ferramentas, confira Referência do NMAKE, MSBuild e Projetos do CMake no Visual Studio.

As linguagens C e C++ são semelhantes, mas não são as mesmas. O compilador do MSVC usa uma regra simples para determinar qual linguagem usar ao compilar seu código. Por padrão, o compilador do MSVC trata os arquivos que terminam em .c como código-fonte do C e os arquivos que terminam em .cpp, como código-fonte do C++. Para forçar o compilador a tratar todos os arquivos como C++, independente da extensão de nome de arquivo, use a opção do compilador /TP.

O compilador do MSVC inclui uma CRT (Biblioteca de Runtime do C) em conformidade com o padrão ISO C99, com pequenas exceções. O código portátil geralmente é compilado e executado conforme o esperado. Determinadas funções obsoletas da biblioteca e vários nomes de função POSIX estão preteridas pelo compilador do MSVC. As funções têm suporte, mas os nomes preferenciais foram alterados. Para obter mais informações, confira Recursos de segurança na CRT e Aviso do Compilador (nível 3) C4996.

Confira também

• Referência da linguagem C++
• Sistemas de build e projetos
• Opções do compilador MSVC