كيفية استعادة Homebrew بعد أن يمسحها تحديث macOS Tahoe 26 (إصلاح Relocated Items – دليل 2026)

25views

macOS Tahoe 26 (بما في ذلك الإصدارات 26.0، 26.0.1، 26.1، و26.2) أدخل تغييرات في نظام الملفات، الأمان (Gatekeeper)، واكتشاف الإصدارات. بالنسبة للكثير من المستخدمين – خاصة المطورين والمستخدمين المتقدمين – تتسبب هذه التحديثات في تعطل Homebrew (مدير الحزم الشهير لنظام macOS) أو يبدو “ممسوحًا”.

الأعراض الشائعة تشمل:

• أمر brew غير موجود أو يتوقف.
• مجلد /opt/homebrew (Apple Silicon) أو /usr/local (Intel) مفقود أو منقول.
• أخطاء مثل: unknown or unsupported macOS version: “26.0” في brew config أو brew doctor.
• نقل التطبيقات/الحزم إلى مجلد Relocated Items (غالبًا في /Users/Shared/Relocated Items أو مسارات مشابهة مثل Library/Shared/Security/Moved Items).
• فشل عمليات Homebrew بعد تحديثات جزئية (مثل 26.0 → 26.0.1).

يحدث ذلك بسبب إعادة تعيين الأمان الشديدة، تغييرات firmlink، أو عدم تطابق سلسلة الإصدار، مما يجعل macOS يعامل ملفات Homebrew كـ”غير متوافقة” أو “غير موثوقة”، فيقوم بنقلها أو حذفها أثناء التحديث. المشكلة أكثر شيوعًا على أجهزة Intel وفي الإصدارات المبكرة من Tahoe، لكنها مستمرة في بعض الحالات حتى في 26.2.

الخبر الجيد: في معظم الحالات، يمكن استعادة Homebrew بسرعة دون إعادة تثبيت macOS كاملة. هذا الدليل يرشدك خطوة بخطوة للتشخيص، الاستعادة من Relocated Items، وإعادة التثبيت الآمن – تم اختباره على Tahoe 26.x في أوائل 2026.

تحذير مهم: قم بعمل نسخ احتياطي للبيانات المهمة أولاً (Time Machine أو قرص خارجي). إذا لم تكن مرتاحًا مع Terminal، توقف وابحث عن مساعدة من دعم Apple أو منتديات.

---

المتطلبات قبل البدء

1. عمل نسخ احتياطي:
   • شغل Time Machine.
   • انسخ أي بيانات مهمة للحزم المثبتة عبر Homebrew (مثل قواعد البيانات أو الإعدادات في ~/Library أو /opt/homebrew).
2. التحقق من النظام:
   • تأكد من أنك على macOS Tahoe 26.x (About This Mac).
   • لديك صلاحيات مدير (admin).
   • اتصال إنترنت مستقر (لإعادة التثبيت).
   • أدوات سطر الأوامر لـ Xcode مثبتة (شغل xcode-select –install إذا لزم).
3. الأدوات المطلوبة:
   • Terminal (التطبيقات > الأدوات > Terminal).
   • اختياري: Finder لفحص المجلدات.

---

الخطوات التفصيلية لاستعادة Homebrew

الخطوة ١: التحقق من مجلد Relocated Items

غالباً ما ينقل macOS الملفات “المشبوهة” إلى Relocated Items أثناء التحديثات.

• افتح Finder → اذهب → اذهب إلى مجلد… (Command + Shift + G).
• أدخل: /Users/Shared/Relocated Items (أو ابحث في Spotlight عن “Relocated Items”).
• مسارات بديلة: ~/Library/Shared/Security/Moved Items أو /Library/Shared/Security/Moved Items.
• ابحث داخلها عن مجلدات مثل:
  • Applications
  • ملفات متعلقة بـ Homebrew (بقايا /opt/homebrew أو /usr/local)
  • ملفات إعداد (.plist، .dylib، إلخ)
• إذا وجدت:
  • انسخ أي شيء مفيد (مثل إعدادات مخصصة) إلى مكان آمن (سطح المكتب أو Documents).
  • لا تعيد نقل كل شيء تلقائيًا – الكثير منها قديم أو غير آمن.
  • بعد النسخ، يمكنك حذف مجلد Relocated Items (عادة آمن؛ Apple يضع اختصارًا على سطح المكتب).

إذا لم يوجد شيء، تابع – Homebrew تم مسحه أو تعطله بسبب عدم توافق الإصدار.

الخطوة ٢: تشخيص الحالة الحالية

افتح Terminal وشغل الأوامر التالية واحدًا تلو الآخر:

Bash

brew --version   # إذا "command not found"، فهو ممسوح/معطل
which brew       # يجب أن يظهر /opt/homebrew/bin/brew (Apple Silicon) أو /usr/local/bin/brew (Intel)
brew doctor      # لاحظ الأخطاء (تجاهل التحذيرات البسيطة)
brew config      # ابحث عن خطأ إصدار macOS

خطأ شائع: unknown or unsupported macOS version: “26.0” – يعني أن Homebrew لا يتعرف على Tahoe بعد (يُصلح بالتحديث).

الخطوة ٣: الإصلاح السريع – جرب تحديث Homebrew أولاً

يحل هذا مشكلة اكتشاف الإصدار لدى الكثيرين:

Bash

# إذا كان brew يعمل جزئيًا
brew update
brew update-reset   # يعيد إلى الإصدار الأصلي إذا كان معدلًا/قديمًا
brew doctor

إذا نجح brew update وأصلح المشكلة → انتهيت! اختبر بـ brew install hello أو مشابه.

إذا كان brew غير موجود → انتقل إلى إعادة التثبيت.

الخطوة ٤: إعادة تثبيت Homebrew كاملة (موصى بها إذا ممسوح)

الطريقة الأكثر أمانًا وموثوقية في Tahoe 26.x هي إعادة تثبيت نظيفة.

1. إزالة أي بقايا متبقية (احذر!):
   • لـ Apple Silicon (معظم الأجهزة الحديثة):Bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"أو يدويًا:Bashsudo rm -rf /opt/homebrew
   • لـ Intel:Bashsudo rm -rf /usr/local/Homebrew
   تحذير: يحذف Homebrew بالكامل. احتفظ بنسخ احتياطي لأي شيء مخصص أولاً.
2. إعادة تثبيت Homebrew: شغل الأمر الرسمي (يعمل على Tahoe 26+ اعتبارًا من أوائل 2026):Bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   • اتبع التعليمات (قد يطلب كلمة المرور، يثبت أدوات Xcode إن لزم).
   • Apple Silicon: يثبت في /opt/homebrew.
   • Intel: يثبت في /usr/local.
3. إضافة إلى PATH (إذا لزم): بعد التثبيت، قد يظهر Terminal التعليمات. شغلها، مثل:Bashecho 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"أعد تشغيل Terminal.

الخطوة ٥: استعادة الحزم واختبار

• حدث كل شيء:Bashbrew update brew upgrade
• أعد تثبيت الحزم السابقة (إذا كان لديك قائمة):
  • استخدم Brewfile إذا صدرته: brew bundle install.
  • أو يدويًا: brew install git node python wget إلخ.
• شغل التشخيص:Bashbrew doctor brew config # يجب أن يظهر macOS 26.x الآن بشكل صحيح

الخطوة ٦: منع المشكلة في المستقبل

• حافظ على تحديث Homebrew: شغل brew update && brew upgrade أسبوعيًا.
• تجنب التحديثات الرئيسية/البيتا فورًا – انتظر 1-2 أسابيع لتصحيحات Homebrew.
• إذا كنت تستخدم firmlinks أو إعدادات مخصصة: أعد إنشاءها لـ /opt إذا تكرر النقل (متقدم؛ راجع مناقشات Reddit).
• تابع مناقشات GitHub الخاصة بـ Homebrew لتصحيحات خاصة بـ Tahoe.

---

حل المشاكل الشائعة

• تحذيرات brew doctor: تجاهل غير الحرجة؛ أصلح PATH أو الصلاحيات إذا لزم.
• خطأ الإصدار مستمر بعد إعادة التثبيت: أعد تعيين التحديث: brew update-reset.
• Relocated Items يظهر مرة أخرى: قد يكون خطأ في Gatekeeper/الأمان في Tahoe – أبلغ Apple Feedback.
• الأوامر بطيئة/متوقفة: أعد تشغيل الجهاز؛ تحقق من taps المتعارضة (brew untap غير المستخدمة).
• مشاكل خاصة بـ Intel: أكثر عرضة للنقل – أعد تثبيت نظيف لـ macOS إذا استمرت (آخر حل).

بدائل إذا استمرت المشكلة في Homebrew

• استخدم MacPorts أو pkgsrc كبديل لمدير الحزم.
• ثبت الأدوات عبر الملفات التنفيذية الرسمية أو متجر التطبيقات.
• للمطورين: اعتمد على الحاويات (Docker) أو asdf لإدارة الإصدارات.

عادة ما يستقر Homebrew سريعًا بعد التحديثات الجزئية – بحلول منتصف 2026، دعم Tahoe ممتاز.

---

أسئلة وأجوبة

س1: هل إعادة تثبيت Homebrew تحذف الحزم المثبتة؟ ج: نعم، لكن يمكن إعادة تثبيتها بسهولة عبر brew install أو Brewfile. البيانات في مجلدات المستخدم عادة تبقى.

س2: هل آمن حذف مجلد Relocated Items؟ ج: نعم، بعد نسخ أي شيء مفيد. غالبًا ما يكون إعدادات قديمة لا يستطيع macOS وضعها.

س3: لماذا يحدث هذا أكثر في Tahoe 26؟ ج: تغييرات الأمان، firmlinks، ومعالجة سلسلة الإصدار تجعل macOS يعامل الملفات غير التابعة لـ Apple بصرامة.

س4: هل يمكن منع ذلك في التحديثات المستقبلية؟ ج: شغل brew update قبل وبعد التحديثات؛ تجنب البيتا في البداية.

س5: ماذا لو فشلت إعادة التثبيت؟ ج: تحقق الإنترنت، شغل softwareupdate –install –all، أو ادخل Recovery وأصلح القرص.

س6: هل يؤثر هذا على Homebrew Casks (التطبيقات الرسومية)؟ ج: نعم – قد تحتاج إعادة تثبيت casks أيضًا (brew reinstall –cask appname).

للمساعدة الإضافية، شارك ناتج brew config!