Cómo corregir el error dyld con libicui18n.62.dylib después de instalar Node mediante Brew en Mac

Introducción: El dolor familiar de todo desarrollador en Mac

Actualizaste Node.js mediante Homebrew, ejecutaste tu script PHP favorito — y de repente ves este mensaje que hiela la sangre:

dyld: Library not loaded: /usr/local/opt/icu4c/lib/libicui18n.62.dylib\n  Referenced from: /usr/local/bin/php\n  Reason: image not found

¡Calma, solo calma! Si llegaste a esta página, significa que no eres el primero ni el último desarrollador en enfrentarse a este error. En Stack Overflow esta pregunta ha acumulado miles de visitas, y con razón: el problema surge debido a un conflicto de versiones de la biblioteca ICU4C (International Components for Unicode for C) después de instalar o actualizar Node.js mediante Homebrew.

En este tutorial te mostraré tres formas funcionales de corregir el error, explicaré su origen y te daré recomendaciones útiles para que nunca más veas este mensaje. ¡Allá vamos!

¿Por qué ocurre el error dyld: Library not loaded?

Antes de lanzarnos a corregirlo, analicemos las causas. Esto te ayudará a entender mejor el ecosistema de macOS y Homebrew.

¿Qué es ICU4C y qué tiene que ver con PHP?

ICU4C es una biblioteca para soporte de Unicode, internacionalización y localización. PHP la utiliza para funciones como mb_convert_encoding(), la extensión intl y otras. Homebrew instala ICU4C como dependencia para muchos paquetes, incluyendo PHP y Node.js.

Cadena de eventos que lleva al error

\n
1. Instalas o actualizas Node.js mediante brew install node o brew upgrade node.
\n
2. Node.js requiere una versión específica de ICU4C (por ejemplo, 62.x).
\n
3. Homebrew actualiza ICU4C a una nueva versión (por ejemplo, 63.x o 64.x).
\n
4. La biblioteca antigua libicui18n.62.dylib se elimina.
\n
5. PHP, que fue compilado con la versión 62, no puede encontrar la biblioteca necesaria — y falla con el error.
\n

En pocas palabras: PHP se quedó "en el pasado", mientras que las bibliotecas ya están "en el futuro".

Método 1: Solución rápida — reenlazar ICU4C (recomendado para principiantes)

Esta es la forma más simple y rápida, que en el 90% de los casos resuelve el problema.

Paso 1: Verifica la versión actual de ICU4C

Abre la Terminal y ejecuta:

brew list --versions icu4c

Verás algo como icu4c 63.1 o 64.2. Recuerda la versión — te será útil.

Paso 2: Reenlaza ICU4C con PHP

Ejecuta el comando para reenlazar:

brew link --force icu4c

Si ves una advertencia de que las versiones no coinciden — no te asustes. Es normal. Luego reinicia PHP:

which php\nphp -v

Si el error desapareció — ¡bien hecho! Si no — pasa al siguiente método.

Paso 3: Opción alternativa — reenlace forzado

Si el comando anterior no funcionó, prueba:

brew reinstall icu4c\nbrew link --overwrite icu4c

Esto reinstalará la biblioteca y actualizará todos los enlaces.

Método 2: Reinstalar PHP mediante Homebrew (para quienes prefieren la limpieza)

Si el reenlace no ayudó — significa que tu PHP está "compilado" para una versión antigua de ICU4C. La mejor solución es reinstalar PHP.

Paso 1: Elimina la versión actual de PHP

brew uninstall php

Si tienes varias versiones de PHP (por ejemplo, 7.4 y 8.0), elimínalas todas:

brew uninstall php@7.4 php@8.0

Paso 2: Limpia la caché de Homebrew

brew cleanup

Paso 3: Instala PHP nuevamente

brew install php

O, si necesitas una versión específica:

brew install php@8.1

Paso 4: Verifica el funcionamiento

Escribe un script PHP simple para comprobar:<