يعني الخطأ zsh: command not found – brew في macOS أن صدفة Zsh (الصدفة الافتراضية منذ macOS Catalina) لا تستطيع العثور على الأمر brew…
4views
يعني الخطأ zsh: command not found - brew في macOS أن صدفة Zsh (الصدفة الافتراضية منذ macOS Catalina) لا تستطيع العثور على الأمر brew، وذلك عادةً لأن تثبيت Homebrew لم يُحدّث متغيّر البيئة PATH في الصدفة لديك بشكل صحيح.
لماذا يحدث هذا
مشكلة في PATH: يُثبَّت Homebrew في /usr/local/bin (لمعالج Intel) أو /opt/homebrew/bin (لمعالج Apple Silicon)، لكن Zsh لن تجده ما لم يكن هذا المسار ضمن PATH.
تثبيت غير مكتمل: إذا لم يكتمل سكربت التثبيت أو تخطّيت إضافة PATH، فلن تتعرّف Zsh على brew.
تبديل الصدفة: إذا غيّرت الصدفة مؤخرًا (مثلًا من Bash إلى Zsh)، فقد لا تُنقل الإعدادات القديمة.
إليك كيفية إصلاحها خطوة بخطوة في الفيديو والنص التالي:–
خطوات إصلاح “Zsh: command not found – brew”
1. تحقّق من تثبيت Homebrew
أولًا، تأكّد من أن Homebrew مثبّت فعلًا:
افتح Terminal ونفّذ: ls -l /usr/local/bin/brew # For Intel Macs
أو لأجهزة Apple Silicon: ls -l /opt/homebrew/bin/brew
إذا أعاد مسار ملف (مثل رابط رمزي symlink)، فإن Homebrew مثبّت لكنه ليس ضمن PATH. وإذا قال “No such file or directory”، فإن Homebrew غير مثبّت — انتقل إلى الخطوة 5 لتثبيته.
2. تحقّق من PATH في الصدفة
نفّذ: echo $PATH
ابحث عن /usr/local/bin (لمعالج Intel) أو /opt/homebrew/bin (لمعالج Apple Silicon) في المخرجات. إذا كان مفقودًا، فإن Zsh لا تعرف مكان brew.
3. أضِف Homebrew إلى PATH
حدّد بنية معالج جهاز Mac:
نفّذ uname -m:
x86_64 = معالج Intel
arm64 = معالج Apple Silicon
افتح ملف إعداد Zsh: nano ~/.zshrc
أضِف السطر المناسب في الأسفل:
لأجهزة Intel: export PATH="/usr/local/bin:$PATH"
لأجهزة Apple Silicon: export PATH="/opt/homebrew/bin:$PATH"
احفظ الملف (Control + X ثم Y ثم Enter).
4. طبّق التغييرات
أعد تحميل إعداد Zsh: source ~/.zshrc
تحقّق من أن brew يعمل: brew --version
إذا أظهر إصدارًا (مثل “Homebrew 4.x.x”)، فقد تم حلّ المشكلة.
5. أعد تثبيت Homebrew (إذا لم يكن مثبّتًا أو كان معطوبًا)
إذا أظهرت الخطوة 1 أن Homebrew غير مثبّت، أو إذا كان لا يزال لا يعمل:
ثبّت Homebrew من جديد: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
اتّبع التعليمات الظاهرة على الشاشة (مثل إدخال كلمة مرور المسؤول).
بعد التثبيت، يُفترض أن يقترح تلقائيًا إضافة أمر PATH إلى ~/.zshrc. وإن لم يفعل، فأضِفه يدويًا كما في الخطوة 3.
6. اختبر واستكشف المشكلات
نفّذ: brew doctor
يفحص هذا الأمر المشكلات. وإذا حذّر من مشكلات في الأذونات أو PATH، فاتّبع نصيحته (مثل sudo chown $(whoami):admin /usr/local/Cellar لأجهزة Intel).
إذا ظلّ brew لا يعمل، فتحقّق من الأذونات: ls -ld /usr/local/bin # Intel ls -ld /opt/homebrew/bin # Apple Silicon
تأكّد من أن مستخدمك يملك صلاحية الوصول (مثل drwxr-xr-x مع اسم مستخدمك). أصلِحها بـ: sudo chown -R $(whoami):admin /usr/local/bin # Intel sudo chown -R $(whoami):admin /opt/homebrew/bin # Apple Silicon
