Partilhar via

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

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

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

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

Pré-requisitos

Para concluir este passo a passo, tem de ter instalado o Visual Studio com a carga de trabalho opcional Desenvolvimento de Área de Trabalho com C++, ou as ferramentas de compilação de linha de comando para o Visual Studio.

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

O Build Tools for Visual Studio instala apenas os compiladores de linha de comando, ferramentas e bibliotecas necessárias para criar programas C e C++. É perfeito para construir laboratórios ou exercícios em sala de aula e instala-se relativamente rapidamente. Para instalar apenas as ferramentas de linha de comando, procure Ferramentas de compilação para Visual Studio na página Downloads do Visual Studio .

Antes de criar um programa C ou C++ na linha de comando, verifique se as ferramentas estão instaladas e você pode acessá-las a partir da linha de comando. Visual C++ tem requisitos complexos para o ambiente de linha de comando para localizar as ferramentas, cabeçalhos e bibliotecas que ele usa. Você não pode usar o Visual C++ em uma janela de prompt de comando simples sem fazer alguma preparação. Felizmente, o Visual C++ instala atalhos para você iniciar um prompt de comando do desenvolvedor que tenha o ambiente configurado para compilações de linha de comando. Infelizmente, os nomes dos atalhos do prompt de comando do desenvolvedor e onde eles estão localizados são diferentes em quase todas as versões do Visual C++ e em diferentes versões do Windows. Sua primeira tarefa passo a passo é encontrar o certo para usar.

Observação

Um atalho de prompt de comando do desenvolvedor define automaticamente os caminhos corretos para o compilador e as ferramentas, bem como para quaisquer cabeçalhos e bibliotecas necessários. Você deve definir esses valores de ambiente por si mesmo se usar uma janela de prompt de comando regular. Para obter mais informações, consulte Usar o conjunto de ferramentas MSVC a partir da linha de comando. Recomendamos que utilize um atalho da linha de comandos do desenvolvedor em vez de criar o seu próprio.

Abrir um prompt de comando do desenvolvedor

  1. Se você tiver instalado o Visual Studio 2017 ou posterior no Windows 10 ou posterior, abra o menu Iniciar e escolha Todos os aplicativos. Role para baixo e abra a pasta Visual Studio (não o aplicativo Visual Studio). Escolha Linha de Comandos do Desenvolvedor para VS para abrir a janela da linha de comandos.

    Se você tiver instalado o Microsoft Visual C++ Build Tools 2015 no Windows 10 ou posterior, abra o menu Iniciar e escolha Todos os aplicativos. Role para baixo e abra a pasta Visual C++ Build Tools . Escolha Visual C++ 2015 x86 Native Tools Command Prompt para abrir a janela do prompt de comando.

    Você também pode usar a função de pesquisa do Windows para pesquisar por "prompt de comando do desenvolvedor" e escolher um que corresponda à sua versão instalada do Visual Studio. Utilize o atalho para abrir a janela do prompt de comando.

  2. Em seguida, verifique se o prompt de comando do desenvolvedor do Visual C++ está configurado corretamente. Na janela do prompt de comando, digite cl e verifique se a saída tem esta aparência:

    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 Visual C++ e de quaisquer atualizações instaladas. Se a saída acima for semelhante à que você vê, então você está pronto para criar programas C ou C++ na linha de comando.

    Observação

    Se você receber um erro como "'cl' não é reconhecido como um comando interno ou externo, programa operável ou arquivo em lotes", erro C1034 ou erro LNK1104 quando você executa o cl comando, então você não está usando um prompt de comando do desenvolvedor ou algo está errado com sua instalação do Visual C++. Você deve corrigir esse problema antes de poder continuar.

    Se você não conseguir encontrar o atalho do prompt de comando do desenvolvedor, ou se você receber uma mensagem de erro quando você insere cl, então sua instalação do Visual C++ pode ter um problema. Tente reinstalar o componente Visual C++ no Visual Studio ou reinstale as ferramentas de compilação do Microsoft Visual C++. Não vá para a próxima seção até que o cl comando funcione. Para obter mais informações sobre como instalar e solucionar problemas do Visual C++, consulte Instalar o Visual Studio.

    Observação

    Dependendo da versão do Windows no computador e da configuração de segurança do sistema, talvez seja necessário clicar com o botão direito do mouse para abrir o menu de atalho do atalho do prompt de comando do desenvolvedor e, em seguida, escolher Executar como administrador para criar e executar com êxito o programa criado seguindo este passo a passo.

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

  1. Na janela do prompt de comando do desenvolvedor, digite md c:\hello para criar um diretório e, em seguida, digite cd c:\hello para alterar para esse diretório. Este diretório é onde o arquivo de origem e o programa compilado são criados.

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

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

  3. No Bloco de Notas, insira as seguintes linhas de código:

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

    Este código é um programa simples que irá escrever uma linha de texto na tela e, em seguida, sair. Para minimizar erros, copie este código e cole-o no bloco de notas.

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

    Parabéns, você criou um arquivo de origem C++, hello.cpp, que está pronto para compilar.

  5. Volte para a janela do prompt de comando do desenvolvedor. Entre dir no prompt de comando para listar o conteúdo do diretório c:\hello. Você deve ver o arquivo de origem hello.cpp na listagem de diretórios, que se parece com:

    c:\hello>dir
 Volume in drive C has no label.
 Volume Serial Number is CC62-6545

 Directory of c:\hello

05/24/2016  05:36 PM    <DIR>          .
05/24/2016  05:36 PM    <DIR>          ..
05/24/2016  05:37 PM               115 hello.cpp
               1 File(s)            115 bytes
               2 Dir(s)  571,343,446,016 bytes free

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

    Observação

    Se não vires o arquivo de código-fonte, hello.cpp, verifica se o diretório de trabalho atual no teu prompt de comando é o diretório C:\hello que criaste. Certifique-se também de que este é o diretório onde você salvou o arquivo de origem. Certifique-se de que salvou o código-fonte com a extensão de ficheiro .cpp, e não a extensão .txt. Seu ficheiro de origem será automaticamente salvo no diretório atual como um ficheiro .cpp se você abrir o Bloco de Notas no prompt de comando utilizando 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 .txt extensão a novos arquivos quando você os salva. Ele também usa como padrão salvar arquivos no diretório Documentos . Para salvar seu arquivo com uma .cpp extensão no Bloco de Notas, escolha Arquivo>Salvar como. Na caixa de diálogo Guardar como, navegue até à sua C:\hello pasta no controlo de exibição de árvore de diretório. Em seguida, use o controle suspenso Salvar como tipo para selecionar Todos os arquivos (*.*). Digite hello.cpp o controle de edição Nome do arquivo e escolha Salvar para salvar o arquivo.

  6. No prompt de comando do desenvolvedor, digite 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 aparece nas linhas de informações de saída que o compilador exibe. A saída do compilador deve ser algo como:

    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 é reconhecido como um comando interno ou externo, programa operável ou arquivo em lotes", erro C1034 ou erro LNK1104, o prompt de comando do desenvolvedor não está configurado corretamente. Para obter informações sobre como corrigir esse problema, volte para a seção Abrir um prompt de comando do desenvolvedor .

    Observação

    Se você receber um erro ou aviso diferente do compilador ou do vinculador, revise seu código-fonte para corrigir quaisquer erros, 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, digite hello.

    O programa exibe este texto e sai:

    Hello, world, from Visual C++!

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

Próximos passos

Este exemplo "Hello, World" é tão simples quanto um programa C++ pode obter. 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 C++ em vez de digitar o código de exemplo mostrado. Essas etapas também permitem que você crie muitos programas de exemplo de código C++ que você encontra em outro lugar. Você pode colocar seu código-fonte e criar seus aplicativos em qualquer diretório gravável. Por predefinição, o Visual Studio IDE cria projetos na sua pasta de utilizador, numa subpasta source\repos. Versões mais antigas podem colocar projetos em uma pasta Documents\Visual Studio <version>\Projects .

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

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

A /EHsc opção de linha de comando instrui o compilador a habilitar o comportamento padrão de tratamento de exceções C++. Sem ele, exceções lançadas podem resultar em objetos não destruídos e vazamentos de recursos. Para obter mais informações, consulte /EH (Exception Handling Model).

Quando você fornece arquivos de origem adicionais, o compilador usa o primeiro arquivo de entrada para criar o nome do programa. Neste caso, ele produz 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

E para detetar 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 muito mais opções. Você pode aplicá-los para criar, otimizar, depurar e analisar seu código. Para obter uma lista rápida, digite cl /? no prompt de comando do desenvolvedor. Você também pode compilar e vincular separadamente e aplicar opções de vinculador em cenários de compilação mais complexos. Para obter mais informações sobre as opções e o uso do compilador e do vinculador, consulte Referência de construção 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, consulte Referência NMAKE, MSBuild e projetos CMake no Visual Studio.

As linguagens C e C++ são semelhantes, mas não iguais. O compilador MSVC usa uma regra simples para determinar qual linguagem usar quando compila seu código. Por padrão, o compilador MSVC trata arquivos que terminam como .c código-fonte C e arquivos que terminam como .cpp código-fonte 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 de compilador /TP .

O compilador MSVC inclui uma C Runtime Library (CRT) que está em conformidade com o padrão ISO C99, com pequenas exceções. O código portátil geralmente compila e executa conforme o esperado. Certas funções de biblioteca obsoletas e vários nomes de funções POSIX são preteridos pelo compilador MSVC. As funções são suportadas, mas os nomes preferidos foram alterados. Para obter mais informações, consulte Recursos de segurança no CRT e Aviso docompilador (nível 3) C4996.

Ver também

Referência da linguagem C++
Projetos e construção de sistemas
de opções do compilador MSVC