So beheben Sie den dyld-Fehler mit libicui18n.62.dylib nach der Node-Installation über Brew auf dem Mac

Online Python-Trainer für Anfänger

Lernen Sie Python einfach ohne theoretische Überlastung. Lösen Sie praktische Aufgaben mit automatischer Überprüfung und schreiben Sie Code direkt im Browser.

Kurs starten

Einleitung: Der bekannte Schmerz eines jeden Mac-Entwicklers

\n\n

Sie haben Node.js über Homebrew aktualisiert, Ihr geliebtes PHP-Skript gestartet – und plötzlich sehen Sie diese erschreckende Meldung:

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

Ruhe bewahren, nur Ruhe! Wenn Sie auf diese Seite gelangt sind, sind Sie weder der erste noch der letzte Entwickler, der auf diesen Fehler gestoßen ist. Auf Stack Overflow hat diese Frage tausende Aufrufe, und das zu Recht: Das Problem entsteht durch einen Versionskonflikt der Bibliothek ICU4C (International Components for Unicode for C) nach der Installation oder Aktualisierung von Node.js über Homebrew.

\n\n

In diesem Tutorial zeige ich Ihnen drei funktionierende Methoden, um den Fehler zu beheben, erkläre seine Ursache und gebe Ihnen nützliche Empfehlungen, damit Sie diese Meldung nie wieder sehen. Los geht's!

\n\n

Warum tritt der Fehler dyld: Library not loaded auf?

\n\n

Bevor wir mit der Fehlerbehebung beginnen, lassen Sie uns die Ursachen verstehen. Das hilft Ihnen, das Ökosystem von macOS und Homebrew besser zu verstehen.

\n\n

Was ist ICU4C und was hat PHP damit zu tun?

\n\n

ICU4C ist eine Bibliothek zur Unterstützung von Unicode, Internationalisierung und Lokalisierung. PHP verwendet sie für Funktionen wie mb_convert_encoding(), die intl-Erweiterung und andere. Homebrew installiert ICU4C als Abhängigkeit für viele Pakete, einschließlich PHP und Node.js.

\n\n

Die Ereigniskette, die zum Fehler führt

\n\n
    \n
  1. Sie installieren oder aktualisieren Node.js mit brew install node oder brew upgrade node.
  2. \n
  3. Node.js benötigt eine bestimmte Version von ICU4C (z. B. 62.x).
  4. \n
  5. Homebrew aktualisiert ICU4C auf eine neue Version (z. B. 63.x oder 64.x).
  6. \n
  7. Die alte Bibliothek libicui18n.62.dylib wird entfernt.
  8. \n
  9. PHP, das mit Version 62 kompiliert wurde, findet die benötigte Bibliothek nicht – und stürzt mit einem Fehler ab.
  10. \n
\n\n

Einfach gesagt: PHP ist "in der Vergangenheit" geblieben, während die Bibliotheken bereits "in der Zukunft" sind.

\n\n

Methode 1: Schnelle Lösung – Neuverlinkung von ICU4C (empfohlen für Anfänger)

\n\n

Dies ist die einfachste und schnellste Methode, die in 90% der Fälle das Problem löst.

\n\n

Schritt 1: Überprüfen Sie die aktuelle Version von ICU4C

\n\n

Öffnen Sie das Terminal und führen Sie aus:

\n\n
brew list --versions icu4c
\n\n

Sie sehen etwas wie icu4c 63.1 oder 64.2. Merken Sie sich die Version – sie wird nützlich sein.

\n\n

Schritt 2: Verlinken Sie ICU4C mit PHP neu

\n\n

Führen Sie den Befehl zur Neuverlinkung aus:

\n\n
brew link --force icu4c
\n\n

Wenn Sie eine Warnung sehen, dass die Versionen nicht übereinstimmen – keine Panik. Das ist normal. Starten Sie dann PHP neu:

\n\n
which php\nphp -v
\n\n

Wenn der Fehler verschwunden ist – super! Wenn nicht, fahren Sie mit der nächsten Methode fort.

\n\n

Schritt 3: Alternative – erzwungene Neuverlinkung

\n\n

Wenn der obige Befehl nicht funktioniert hat, versuchen Sie:

\n\n
brew reinstall icu4c\nbrew link --overwrite icu4c
\n\n

Dies installiert die Bibliothek neu und aktualisiert alle Verweise.

\n\n

Methode 2: Neuinstallation von PHP über Homebrew (für diejenigen, die Sauberkeit lieben)

\n\n

Wenn die Neuverlinkung nicht geholfen hat – dann ist Ihr PHP "fest verdrahtet" mit der alten ICU4C-Version. Die beste Lösung ist eine Neuinstallation von PHP.

\n\n

Schritt 1: Entfernen Sie die aktuelle PHP-Version

\n\n
brew uninstall php
\n\n

Wenn Sie mehrere PHP-Versionen haben (z. B. 7.4 und 8.0), entfernen Sie alle:

\n\n
brew uninstall php@7.4 php@8.0
\n\n

Schritt 2: Bereinigen Sie den Homebrew-Cache

\n\n
brew cleanup
\n\n

Schritt 3: Installieren Sie PHP neu

\n\n
brew install php
\n\n

Oder, wenn Sie eine bestimmte Version benötigen:

\n\n
brew install php@8.1
\n\n

Schritt 4: Überprüfen Sie die Funktionsfähigkeit

\n\n

Schreiben Sie ein einfaches PHP-Skript zum Testen:<

Blogs

Buchempfehlungen