El compilador g++: instalación, comandos y flags

Por qué esta página va primero

Todas las páginas de esta sección muestran, junto a cada ejemplo, un comando como este:

g++ -std=c++17 -Wall -o programa programa.cpp

Antes de escribir tu primer .cpp, conviene entender qué es ese comando, cómo conseguirlo en tu computadora, y qué significa cada parte — para no tener que volver a preguntártelo cada vez que aparezca.

Qué es g++

g++ es el compilador de C++ del proyecto GCC (GNU Compiler Collection). Un compilador traduce el código fuente que escribes (texto, en un archivo .cpp) a un programa ejecutable que tu sistema operativo puede correr directamente. g++ no es el único compilador de C++ que existe — las alternativas más comunes son Clang (clang++, usado por defecto en macOS) y MSVC (el compilador de Microsoft, integrado en Visual Studio en Windows) — pero los tres entienden el mismo lenguaje C++ estándar y esta documentación usa g++ como referencia porque sus comandos son casi idénticos en las tres plataformas.

Instalación según tu sistema operativo

Linux

La mayoría de las distribuciones lo traen instalado o a un paso de estarlo:

sudo apt update && sudo apt install build-essential

# Fedora
sudo dnf install gcc-c++

# Arch Linux
sudo pacman -S gcc

build-essential (Debian/Ubuntu) instala g++ junto con otras herramientas de compilación básicas que vas a necesitar tarde o temprano (como make).

macOS

La forma más simple es instalar las Command Line Tools de Xcode, que incluyen clang++ registrado también bajo el nombre g++ (en macOS, g++ es en realidad un alias de Clang):

xcode-select --install

Windows

En Windows hay dos caminos razonables:

1. MSYS2 (recomendado): instala un entorno con g++ real de GCC. Después de instalar MSYS2, desde su terminal:

   bashbashCopiar

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

   y agrega la carpeta ucrt64/bin de MSYS2 al PATH del sistema para poder usar g++ desde cualquier terminal (cmd, PowerShell).

2. WSL (Windows Subsystem for Linux): instala una distribución Linux real dentro de Windows (wsl --install desde PowerShell como administrador) y, adentro, sigues los pasos de instalación de Linux de arriba. Es la opción más parecida a cómo compila la mayoría de tutoriales y proyectos open source.

Verificar que quedó instalado

En cualquier sistema, una vez instalado:

g++ --version

Si ves una respuesta con un número de versión (por ejemplo g++ (GCC) 13.2.0 o similar), quedó instalado correctamente. Si en cambio el sistema dice que no reconoce el comando, revisa el paso de instalación para tu sistema — en Windows, casi siempre es un tema del PATH que no incluye la carpeta donde quedó g++.

Anatomía del comando de compilación

Retomando el comando del principio:

g++ -std=c++17 -Wall -o programa programa.cpp

El orden de los flags no suele importar, pero el archivo fuente y el nombre de salida sí van donde corresponde. Una vez compilado, se ejecuta con ./programa (Linux/macOS) o programa.exe / .\programa.exe (Windows).

-std: elegir el estándar de C++

C++ tiene varias versiones estandarizadas (viste la tabla completa en ¿Qué es C++?), y el compilador necesita que le digas cuál usar con -std=c++AA, donde AA son las dos últimas cifras del año del estándar:

-Wall y -Wextra: advertencias

-Wall (“todas las advertencias [comunes]”, el nombre es un poco engañoso: no son literalmente todas) le pide al compilador que te avise de patrones sospechosos que compilan igual, pero que casi siempre son errores del programador: una variable que declaraste y nunca usaste, una comparación que siempre da el mismo resultado, un if con un ; de más que lo deja vacío.

g++ -std=c++17 -Wall -Wextra -o programa programa.cpp

-Wextra suma advertencias adicionales que -Wall no incluye por default. La combinación -Wall -Wextra es la que vas a ver recomendada en casi cualquier proyecto serio de C++.

-g y -O: depuración vs. optimización

Estos dos flags representan un mismo compromiso desde ángulos opuestos:

• -g incluye información de depuración (nombres de variables, líneas del código fuente) en el ejecutable, para que un depurador como gdb pueda mostrarte exactamente dónde y por qué falló algo.
• -O (de optimization) le pide al compilador que reorganice el código generado para que corra más rápido o pese menos, a costa de que ya no se parezca tanto al código fuente original (lo cual complica depurarlo).

g++ -std=c++17 -Wall -g -O0 -o programa programa.cpp

# Para la versión que vas a distribuir
g++ -std=c++17 -Wall -O2 -o programa programa.cpp

Otros flags que vas a encontrar en esta documentación

Ya usaste (o vas a usar pronto) estos otros flags en ejemplos concretos:

• -I ruta — agrega ruta a la lista de carpetas donde el compilador busca archivos de #include. Lo viste al compilar Dear ImGui, donde el código fuente de la librería vive en una carpeta aparte.
• -l nombre — enlaza contra una biblioteca ya compilada (por ejemplo -lglfw para GLFW). También en el ejemplo de ImGui.
• -fsanitize=address,undefined — activa los sanitizers, herramientas que detectan en tiempo de ejecución errores de memoria como los punteros colgantes. Los vas a ver en detalle en la página de Punteros.
• -c — compila un archivo .cpp a un archivo objeto (.o) sin enlazarlo todavía a un ejecutable. Sirve para compilar cada archivo de un proyecto grande por separado y enlazarlos juntos después, algo que en la práctica maneja un sistema de build (como CMake) en vez de escribirse a mano — la misma idea que ya se mencionó al hablar de compilar ImGui.

Siguiente paso

Con el compilador instalado y el comando básico entendido, ya puedes seguir el resto de esta documentación al pie de la letra: cada bloque de código viene acompañado de su propio comando de compilación, listo para copiar. Continúa con ¿Qué es C++?.