Etiquetas

C++ en macOS - Integrando VSCode, Homebrew y CMake

Sobre este artículo
     Tiempo estimado de instalación y configuración: 30 minutos
     Nivel: Básico
     Última actualización: 4 de agosto, 2026

1. Introducción

En este artículo, continuación de una serie anterior dedicada a MS Windows, explicaremos cómo configurar un entorno de trabajo para proyectos de C++ en macOS basado en:
  • Homebrew [1] como package manager, a través del cual podremos instalar bibliotecas no estándar de uso extendido en la comunidad de desarrolladores en C++ –tales como Boost [2], {fmt}lib [3], Range-v3 [4] y nlohmann-JSON [5]–, build systems como Ninja [6] y, opcionalmente, el compilador G++.
  • Visual Studio Code [7], un editor de código fuente multiplataforma desarrollado por Microsoft desde 2015 para los sistemas operativos Linux, MS Windows y macOS. Aunque los binarios oficiales se distribuyen bajo una licencia propietaria, el proyecto se basa en la versión de código abierto VS Code-OSS. Mediante una amplia variedad de extensiones, proporciona funcionalidades avanzadas propias de un IDE, siendo declarado el entorno de desarrollo más popular por cuarto año consecutivo en el Stack Overflow Developer Survey de 2025.
  • CMake [8], una herramienta de generación y gestión de sistemas de construcción ampliamente utilizada en el desarrollo profesional de software en C y C++, facilitando tareas relacionadas con la compilación, ejecución de pruebas, instalación y empaquetado de aplicaciones. A partir de ficheros de configuración denominados CMakeLists.txt, permite describir de forma portable la estructura de un proyecto y generar automáticamente los sistemas de construcción apropiados para distintas plataformas y herramientas.

2. Gestor de paquetes Homebrew

Los requerimientos mínimos para poder instalar este conocido gestor de paquetes son:
  • Apple Silicon CPU o 64-bit Intel CPU.
  • macOS Sonoma (14) o superior.
  • Bourne-again shell (bash).
  • Command Line Tools (CLT) para Xcode, conjunto de herramientas que incluye el compilador Clang [9]. Si no se dispone aún de ellas, pueden obtenerse desde una ventana de la Terminal ejecutando el comando xcode-select --install.
Para instalar Homebrew, ejecutaremos la instrucción siguiente desde la Terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Tal y como se explica en el portal oficial de Homebrew [1], el programa de instalación indicará las acciones a realizar paso a paso, pausando su ejecución cuando sea necesario para solicitar la confirmación del usuario.

En equipos mac Intel, Homebrew quedará ubicado en /usr/local/bin/. En equipos Apple Silicon, los ficheros de Homebrew serán almacenados en la carpeta /opt/homebrew/bin/. En este último caso, al finalizar la instalación de Homebrew, es posible que se nos solicite copiar, pegar y ejecutar dos comandos en la Terminal con el fin de incluir el package manager en el PATH (sustitúyase $USER por el nombre del usuario en cuestión):
Add Homebrew to your PATH in /Users/$USER/.zprofile:

    echo 'eval $(/opt/homebrew/bin/brew shellenv)' >> /Users/$USER/.zprofile
    eval $(/opt/homebrew/bin/brew shellenv)
A modo de nota informativa, indicar que Homebrew recopila estadísticas de instalación, errores de compilación y versión del sistema operativo a través de Google Analytics. Si no se desea participar en dicha analítica, es posible darse de baja con el comando brew analytics off (más información en [10]).

3. Cmake, bibliotecas de uso extendido y build system Ninja

Una vez finalizada la instalación de Homebrew, procederemos a instalar tanto el generador de build systems CMake como algunas de las bibliotecas de uso más extendido entre programadores de C++ (particularmente Boost, {fmt}lib, Range-v3 y nlohmann-JSON). Para ello, ejecutaremos las instrucciones siguientes desde la Terminal:
brew install cmake
brew install boost
brew install fmt
brew install range-v3
brew install nlohmann-json
El build system Ninja [10] puede instalarse ejecutando el comando  brew install ninja.

4. Compilador GCC

Es también posible instalar el compilador GCC (actualmente, en su versión 16) mediante el siguiente comando:
brew install gcc
Una vez finalizada la instalación, acudiremos a la carpeta donde se encuentren los ejecutables gcc-16 y g++-16 (/opt/homebrew/bin/  en Apple Silicon,  /usr/local/bin/ en mac Intel) y crearemos los siguientes enlaces simbólicos:
ln -s gcc-16 gcc
ln -s g++-16 g++
De esta manera, al ejecutar gcc o g++, emplearemos realmente el compilador GCC en sustitución del compilador adoptado por defecto por el sistema (Clang).

Llegados a este punto, la ejecución en la Terminal de comandos como cmake --version o g++ --version nos permitirá comprobar que la instalación de las distintas herramientas haya concluido con éxito.
Homebrew instala GCC mediante ejecutables versionados (gcc-16 y g++-16) para evitar sustituir los comandos gcc y g++ proporcionados por macOS, que actúan como puntos de entrada al compilador Clang de Apple. Con el fin de simplificar los ejemplos presentados y mantener una experiencia homogénea con Linux y MS Windows, en esta guía crearemos enlaces simbólicos con los nombres tradicionales gcc y g++. Aunque esta configuración resulta especialmente conveniente en un entorno formativo, en proyectos profesionales es habitual invocar explícitamente los ejecutables versionados o seleccionar el compilador deseado mediante CMake.

5. Editor Visual Studio Code

Para la instalación del editor VS Code, procederemos en la forma siguiente:

[1] Descargaremos e instalaremos el software desde el siguiente enlace: https://code.visualstudio.com/

[2] Una vez instalado, ejecutaremos el editor. Pulsaremos la combinación de teclas Cmd+Shift+X para desplegar el menú lateral de extensiones del editor. Realizaremos la búsqueda "C++" y seleccionaremos la extensión "C/C++ IntelliSense, debugging, and code browsing" desarrollada por Microsoft (ver imagen inferior). Haremos clic sobre "Install" y después sobre "Reload" para hacer efectivos los cambios.


[3] Repetiremos el procedimiento anterior para instalar la extensión "CMake Tools", también desarrollada por Microsoft.


[4] Finalmente, abriremos el Command Palette del editor con la combinación de teclas Cmd+Shift+P y ejecutaremos el comando ">Preferences: Open User Settings (JSON)" (en castellano: ">Preferencias: Abrir configuración de usuario (JSON)"). Añadiremos entonces, separadas por comas, las siguientes líneas al fichero settings.json (véase la imagen inferior):
"cmake.configureOnOpen": true,
"cmake.generator": "Ninja"
La segunda línea, en particular, indica a CMake que gestione proyectos utilizando "Ninja" como herramienta subyacente de construcción (build tool).

6. Gestión de proyectos con CMake

El lector puede encontrar una explicación acerca de cómo crear un primer proyecto CMake de tipo 'Hello, world!' en VSCode en este post anterior (las adaptaciones necesarias a macOS relativas a la creación de un directorio folder y la selección del compilador Clang o GCC debieran resultar inmediatas).

Finalmente, la subsección "Ejemplo de uso" de este post proporciona un código main.cpp y un fichero de configuración CMakeLists.txt más complejos con los que poder poner a prueba la correcta instalación de algunas de las bibliotecas no-estándar señaladas anteriormente (concretamente, {fmt}lib y Range-v3).

Referencias bibliográficas

  1. Homebrew package manager - https://brew.sh/es/
  2. Boost C++ libraries - https://www.boost.org/
  3. {fmt}lib - https://github.com/fmtlib/fmt
  4. Range-v3 - https://github.com/ericniebler/range-v3
  5. JSON for Modern C++ - https://github.com/nlohmann/json
  6. Ninja build system - https://ninja-build.org/
  7. Visual Studio Code - https://code.visualstudio.com/
  8. CMake - https://cmake.org/
  9. Clang: a C language family frontend for LLVM - https://clang.llvm.org/
  10. Homebrew - Anonymous Aggregate User Behaviour Analytics - https://github.com/Homebrew/brew/blob/master/docs/Analytics.md
Etiquetas: