تعليق بناء Cargo: "Blocking waiting for file lock" — كيفية الإصلاح

مقدمة: عندما يتحول تجميع Rust إلى مهمة شاقة

قررت بناء Parity (أو أي مشروع Rust معقد آخر) من المصدر. تم تشغيل الأمر cargo build، والصمت يخيم على الطرفية، وبعد دقيقة ترى الرسالة المألوفة للكثيرين:

Blocking waiting for file lock on the registry index

يتجمد البناء تمامًا. Ctrl+C لا ينفع، إعادة تشغيل الطرفية أيضًا لا تنفع. هل هذا مألوف؟ هذه المشكلة هي واحدة من أكثر المشكلات شيوعًا على Stack Overflow (آلاف المشاهدات)، واليوم سنقوم بتحليلها بالتفصيل.

في هذه المقالة، سأشرح لكم، كمرشدكم في عالم Rust:
\n- لماذا يحدث هذا الخطأ؟
\n- كيف يمكن إصلاحه في 30 ثانية؟
\n- كيف نمنع حدوثه تمامًا؟
\n- وسنلقي نظرة خاطفة على ما وراء الكواليس في Cargo.

هيا بنا! 🚀

من أين يأتي "Blocking waiting for file lock on the registry index"؟

أولاً، دعنا نترجم هذا الخطأ من لغة Cargo إلى لغة البشر:

"أنا، Cargo، أريد تنزيل أو تحديث قائمة الحزم من السجل (registry)، لكنني لا أستطيع — ملف القفل مشغول بالفعل بواسطة عملية أخرى. أنتظر..."

في نظام Rust البيئي، يستخدم cargo أقفال الملفات (ملفات .lock) لمنع عمليتين من الكتابة في ذاكرة التخزين المؤقت للسجل (~/.cargo/registry) في نفس الوقت. هذا يحمي من تلف البيانات، لكن في بعض الأحيان "يعلق" القفل.

الأسباب الرئيسية للتجميد

\n
• إنهاء غير طبيعي لبناء سابق — أغلقت الطرفية، أو انطفأ الكمبيوتر، أو تعطل cargo build مع خطأ، لكن ملف القفل بقي.
\n
• نسختان من Cargo في نفس المشروع — قمت بتشغيل البناء في نافذتي طرفية في نفس الوقت.
\n
• بناء Parity من المصدر — هذا المشروع يسحب عددًا هائلاً من التبعيات (مئات الكريتات)، وقد يتعطل Cargo في مرحلة الفهرسة، خاصة على الأجهزة الضعيفة أو مع الإنترنت البطيء.
\n
• مشاكل في صلاحيات الوصول — نادرًا، لكن يحدث عندما يكون ~/.cargo مملوكًا لمستخدم آخر.
\n
• نظام ملفات لا يدعم الأقفال — على سبيل المثال، بعض المشاركات الشبكية أو WSL بدون إعدادات صحيحة.
\n

5 طرق للحل (من السريع إلى الموثوق)

🔧 الطريقة 1: قتل عملية Cargo (الأسرع)

إذا كنت متأكدًا من عدم وجود أي بناء آخر قيد التشغيل، فقط قم بإنهاء العملية التي تمسك القفل.

Linux/macOS:

pkill cargo\n# أو بشكل أقوى:\nkillall -9 cargo

Windows (PowerShell):

Get-Process cargo | Stop-Process -Force

بعد ذلك، قم بتشغيل cargo build مرة أخرى. في 80% من الحالات، هذا يكفي.

🔧 الطريقة 2: حذف ملف القفل يدويًا

إذا لم تنجح الطريقة الأولى، انتقل إلى دليل السجل واحذف ملف القفل.

المسار:

# Linux/macOS\nrm -f ~/.cargo/registry/.cache-lock\nrm -f ~/.cargo/registry/.package-cache\n\n# Windows (cmd)\ndel %USERPROFILE%\\.cargo\\registry\\.cache-lock\ndel %USERPROFILE%\\.cargo\\registry\\.package-cache

بعد ذلك، سيقوم Cargo بإنشاء ملف قفل جديد عند التشغيل التالي. مهم: تأكد من عدم وجود عمليات Cargo أخرى قيد التشغيل، وإلا فإنك تخاطر بإتلاف ذاكرة التخزين المؤقت.

🔧 الطريقة 3: Cargo clean — الخيار النووي

إذا لم ينفع شيء، قم بتنظيف كل ما تراكم. هذا سيحذف مجلد target ويعيد تعيين ذاكرة التخزين المؤقت للتبعيات للمشروع الحالي. البناء التالي سيكون أطول، لكنه سيكون نظيفًا.

cargo clean

بعد ذلك، حاول بناء المشروع مرة أخرى:

cargo build

هذه الطريقة مفيدة بشكل خاص إذا كنت تبني Parity أو مشروعًا آخر بشجرة تبعيات ضخمة.