Instalar C++: configure um compilador no Windows, macOS e Linux

O que você realmente precisa: um compilador

Na página anterior você viu que C++ é uma linguagem compilada — seu código-fonte é transformado em código de máquina nativo antes de rodar. Para fazer isso na sua própria máquina, você instala uma única coisa essencial: um compilador de C++. O compilador lê seus arquivos .cpp, aplica a biblioteca padrão de C++ e produz um executável que a sua CPU roda diretamente.

Você não precisa de uma IDE pesada para começar. Uma IDE é apenas um editor com ferramentas em volta do mesmo compilador que está por baixo. Muita gente escreve C++ com um editor de texto simples (ou VS Code) e invoca o compilador a partir de um terminal. Instale o compilador primeiro; coloque um editor por cima quando quiser.

Você também não precisa de nada disso só para acompanhar aqui — os blocos de editor destas páginas compilam e rodam na nuvem. Configure um compilador local quando quiser compilar e rodar C++ no seu próprio computador.

Escolha um compilador para o seu sistema operacional

Há três compiladores de C++ principais, todos gratuitos e modernos o suficiente para C++17 e C++20:

• GCC — o GNU Compiler Collection. Seu front end de C++ é o g++. É o padrão no Linux.
• Clang — o compilador do LLVM. Seu front end de C++ é o clang++. É o padrão no macOS.
• MSVC — o compilador da Microsoft (cl.exe), que vem com o Visual Studio. A escolha nativa no Windows.

Não pense demais nisso. Use o que for padrão na sua plataforma — a linguagem C++ é a mesma nos três, e todos os exemplos deste curso compilam em qualquer um deles. As diferenças só importam quando você chega a recursos avançados e específicos de cada fabricante.

Um detalhe de nomenclatura: gcc e g++ ambos fazem parte do GCC, mas para C++ sempre invoque o g++ (não o gcc). O g++ faz a ligação com a biblioteca padrão de C++ automaticamente; o gcc não, e você vai receber erros de ligação confusos.

Instale na sua plataforma

A mecânica difere um pouco em cada sistema operacional. Onde houver um gerenciador de pacotes, prefira-o — as atualizações viram um único comando.

Windows

O caminho mais simples é o conjunto de ferramentas GCC gratuito MinGW-w64 por meio do instalador do MSYS2. Depois de instalar o MSYS2, abra o terminal dele e execute:

pacman -S mingw-w64-ucrt-x86_64-gcc

Isso lhe dá o g++. Em seguida, adicione C:\msys64\ucrt64\bin ao seu PATH para que o g++ funcione em qualquer terminal. Como alternativa, instale o Visual Studio (a edição Community gratuita) com a carga de trabalho "Desenvolvimento para desktop com C++" para obter o compilador MSVC e uma IDE de uma só vez.

macOS

A Apple distribui o Clang por meio das Command Line Tools. Um único comando as instala:

xcode-select --install

Isso lhe dá o clang++. Se você preferir o GCC, instale-o com o Homebrew: brew install gcc.

Linux (Debian/Ubuntu)

sudo apt update
sudo apt install g++

No Fedora/RHEL é sudo dnf install gcc-c++. Esses são comandos de shell, não C++ — eles instalam o compilador em todo o sistema. Instalar o pacote build-essential no Ubuntu traz o g++ mais o make e outras ferramentas de build de uma só vez.

Verifique se deu certo

Esta é a etapa que as pessoas pulam e depois perdem uma hora por causa disso. Abra um terminal novo (para que ele pegue o PATH atualizado) e pergunte a versão ao compilador:

g++ --version

Você deve ver algo como:

g++ (Ubuntu 13.2.0-4ubuntu3) 13.2.0
Copyright (C) 2023 Free Software Foundation, Inc.

No macOS o equivalente é clang++ --version, e no Windows com MSVC é cl (executado a partir do "Developer Command Prompt"). Se aparecer command not found, o compilador não está instalado ou não está no seu PATH — volte à etapa de instalação da sua plataforma e reabra o terminal.

Mais uma verificação útil: confirme o padrão para o qual o compilador aponta por padrão. Um GCC ou Clang recente usa por padrão C++17 ou mais novo, que é o que estas páginas assumem. Você sempre pode forçar um padrão explicitamente com uma flag como -std=c++20, que a próxima página explica em detalhes.

Um teste rápido local

Assim que g++ --version reportar um número, sua máquina já consegue compilar C++. O mesmíssimo programa que você compilará localmente também roda aqui mesmo no navegador, então você pode conferir a saída antes mesmo de tocar em um terminal:

#include <iostream>

int main() {
    std::cout << "C++ is working!" << std::endl;
    std::cout << "Compiled to standard: " << __cplusplus << std::endl;
    return 0;
}

A macro __cplusplus é um número embutido que o compilador define para informar qual padrão da linguagem ele está usando (por exemplo, 201703 significa C++17). Todo programa de C++ começa a partir de int main(), e std::cout escreve no console. Na sua própria máquina você salvaria isso como main.cpp, compilaria e rodaria o executável resultante. Essa dança de dois passos — compilar e então rodar — é exatamente sobre o que trata a próxima página.

Uma observação sobre o PATH

A coisa que mais atrapalha instalações novas é o PATH — a lista de pastas onde o seu shell procura programas. Se g++ --version roda a partir de qualquer diretório, seu PATH inclui a pasta do compilador e está tudo certo. Se ele só funciona a partir do diretório de instalação, ou não funciona de jeito nenhum, a pasta bin do compilador ainda não está no seu PATH.

• No Windows, esse é o tropeço mais comum: depois de instalar o MinGW-w64, você precisa adicionar manualmente a pasta bin dele ao PATH e abrir um terminal novo.
• No macOS e no Linux, os gerenciadores de pacotes e as ferramentas do Xcode colocam o compilador no PATH por você, então isso raramente aparece.

Se mais tarde uma ferramenta de build ou um editor não encontrar seu compilador mesmo com g++ --version funcionando em um terminal, a causa quase sempre é um PATH que o aplicativo gráfico não herdou — reiniciar o aplicativo (ou a máquina) costuma resolver.

Próximo: compilar C++

Agora você tem um compilador funcional e o verificou pela linha de comando. A próxima página transforma isso em um fluxo de trabalho de verdade: escrever um arquivo .cpp, compilá-lo com o g++ (incluindo as flags -std e -o que controlam o padrão e o nome de saída) e rodar o executável que ele produz — além do que cada etapa realmente faz por baixo dos panos.