Configurar macOS para desarrollo profesional no es instalar aplicaciones al azar. Es diseñar una base estable que soporte cualquier stack moderno sin fricción.
En este artículo vas a aprender exactamente cómo preparar macOS desde cero para trabajar de forma profesional usando Homebrew como núcleo del entorno.
He configurado múltiples equipos (Intel y Apple Silicon) y el patrón siempre es el mismo: cuando la base está mal construida, el entorno se rompe semanas después, no el primer día.
El problema es que muchos desarrolladores mezclan herramientas del sistema con instalaciones manuales y terminan con conflictos invisibles que aparecen en el peor momento.
Vamos a ver:
- Cómo instalar correctamente Homebrew.
- Cómo integrar Homebrew al sistema de forma limpia.
- Qué dependencias base necesitas realmente.
- El checklist final que utilizo en cada máquina nueva.
Al final tendrás un entorno profesional, replicable y preparado para cualquier stack.
Tabla de contenidos
Tabla de contenidos
Base limpia con Homebrew
En macOS, Homebrew es el corazón del entorno.
Si Homebrew no está correctamente instalado e integrado al PATH, todo lo demás será inconsistente.
1. Instalar Homebrew
Antes de instalar cualquier herramienta, Homebrew debe ser la primera.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Este comando descarga e instala Homebrew desde su fuente oficial. Te mostrará un resumen de lo que va a hacer y pedirá que presiones Enter para continuar (y tu contraseña de macOS, porque usa sudo para crear sus carpetas).
Si el equipo no tiene las Xcode Command Line Tools, el propio instalador de Homebrew las descarga e instala. Por eso este paso puede tardar varios minutos la primera vez.
2. Integrar Homebrew al shell
Al terminar, el instalador te muestra los “Next steps”. No los ignores: sin esto, la terminal no encontrará el comando brew.
echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"Qué hace cada línea:
- La primera agrega una línea en blanco a tu
~/.zprofile(solo por limpieza). - La segunda escribe en
~/.zprofilela instrucción que carga Homebrew en el PATH: se ejecutará sola en cada sesión nueva de terminal. - La tercera aplica esa instrucción a la sesión actual, para no tener que cerrar y abrir la terminal.
Estas líneas no retornan nada al ejecutarse. Silencio es éxito.
En Apple Silicon, Homebrew vive en /opt/homebrew; en Macs Intel, en /usr/local. Usa las rutas exactas que te muestre tu instalador: ya vienen ajustadas a tu equipo.
3. Verificar la instalación
brew --version
brew helpNunca asumas que algo quedó bien instalado. Verifica. Y brew help te da el mapa de los comandos que vas a usar a diario.
4. Actualizar fórmulas
brew updateTrabajar sobre definiciones actualizadas evita conflictos posteriores.
Hasta aquí lo básico.
Pero esto solo prepara el terreno.
La diferencia real está en lo que instalas encima.
El error estructural en macOS
macOS (con las Command Line Tools) trae versiones propias de varias herramientas:
- Git
- Curl
- Python 3
- LibreSSL (en lugar de OpenSSL)
El problema es que casi nunca son las versiones que tu stack necesita.
Y cuando mezclas:
- Binarios del sistema
- Versiones instaladas manualmente
- Paquetes de Homebrew
Empiezan los conflictos.
Ruby que no compila. Node que falla con OpenSSL. Extensiones nativas que no encuentran headers.
macOS no es un entorno de desarrollo listo. Es una base sobre la que tú construyes uno.
Por eso centralizo todo en Homebrew.
Una sola fuente de verdad. Un solo gestor. Una arquitectura coherente.
Y aquí es donde empieza lo importante.
Sistema profesional replicable
Este es el bloque base que instalo en cada equipo nuevo:
brew install \
git wget curl tree \
openssl readline libyaml libffi xz zlib \
sqlite3 libpq \
cmake pkg-config llvm \
imagemagick libxml2 libxslt libvips ffmpeg webp popplerMientras corre verás las fórmulas instalándose una a una, cada una con su ícono de cerveza: esa es la señal de que todo va bien.
Ahora el por qué.
- Git: Indispensable para cualquier proyecto serio. Nunca dependas del Git del sistema.
- OpenSSL / libffi / readline: Críticos para Ruby, Python y Node con módulos nativos.
- libpq: PostgreSQL. Backend serio lo necesita.
- cmake / llvm / pkg-config: Compilación avanzada. Muchos paquetes fallan silenciosamente sin estas dependencias.
- imagemagick / libvips / ffmpeg: Procesamiento multimedia. No siempre lo usarás directamente, pero muchas librerías modernas sí.
- El resto (wget, tree, xz, zlib, sqlite3, webp, poppler, libxml2/libxslt): librerías de soporte que los lenguajes reclaman al compilar. Mejor tenerlas antes de necesitarlas.
Xcode Command Line Tools
Son los compiladores de Apple que muchas fórmulas necesitan por debajo. Verifica que estén activas:
xcode-select -pSi responde con una ruta (como /Library/Developer/CommandLineTools), ya están instaladas: lo más probable, porque el instalador de Homebrew se encarga de ellas. Si no, instálalas a mano:
xcode-select --installY si te responde que ya están instaladas, mejor: verificaste en vez de asumir.
Flujo mental correcto
Tu entorno debería verse así:
flowchart TD
A[macOS limpio] --> B[Homebrew]
B --> C[Dependencias base]
C --> D[Gestores de versión]
D --> E[Stack del proyecto]
E --> F[Producto real]Si Homebrew es consistente, el resto fluye.
Checklist final
Antes de empezar cualquier proyecto nuevo:
- Homebrew instalado y funcionando.
- PATH correctamente configurado.
- Fórmulas actualizadas.
- Dependencias base instaladas.
- Xcode Command Line Tools activadas.
- Sin mezcla de binarios del sistema.
Si cumples esto, tu entorno no es improvisado.
Es profesional.
Conclusión
Con Homebrew como única fuente de verdad y las dependencias base instaladas, tu Mac está listo para cualquier stack que montemos en la serie: los gestores de versiones y lenguajes vienen en las próximas semanas.
¿Y si trabajas en Windows? El martes salió esta misma base para Ubuntu y WSL: Setup Ubuntu y WSL para desarrollo profesional.
La próxima semana sigo con la serie: Oh My Zsh para que tu terminal trabaje contigo, en Ubuntu/WSL y en macOS. Si no te lo quieres perder, suscríbete al newsletter en la portada del blog.