لا يتم تجميع Rust على Windows؟ حل مشكلة linker link.exe

مقدمة: أول برنامج "Hello, world!" بلغة Rust لا يعمل

لقد قمت للتو بتثبيت Rust، وفتحت الطرفية، وكتبت أول كود لك بهذه اللغة الأنيقة والآمنة، وأدخلت cargo run — وفجأة حصلت على سطر أحمر محير:

error: linker `link.exe` not found\n  |\n  = note: The system cannot find the file specified. (os error 2)\n

هل هذا مألوف؟ لا داعي للذعر! لقد واجهت واحدة من أكثر المشاكل شيوعًا بين المبتدئين الذين ينتقلون إلى Rust على Windows. هذا الخطأ ليس عيبًا في المترجم ولا لعنة. إنه مجرد سوء فهم بين صديقك الجديد Rust ونظام التشغيل. آلاف المطورين مروا بهذا على Stack Overflow، واليوم سنحلل هذا الموقف مرة واحدة وإلى الأبد. مرحبًا بك في عالم البرمجة النظامية على Windows — هنا تحتاج إلى أكثر قليلاً من مجرد تثبيت اللغة.

لماذا لا يرى Rust ملف link.exe؟ فهم جذر المشكلة

لفهم سبب ظهور خطأ linker link.exe not found، يجب أن ننظر تحت غطاء عملية التجميع. عندما تكتب rustc main.rs أو cargo build، يقوم Rust بتجميع الكود الخاص بك إلى ملفات كائن. لكن الأمر لا ينتهي هنا. للحصول على ملف قابل للتنفيذ (.exe)، يجب ربط (link) هذه الملفات معًا. هذا العمل يقوم به برنامج خاص — الرابط.

على Windows، الرابط الافتراضي هو link.exe من مجموعة أدوات Microsoft Visual C++ (MSVC). Rust، كونه لغة "تتآلف" مع المترجم النظامي، يختار افتراضيًا سلسلة أدوات MSVC (إذا لم تحدد خلاف ذلك أثناء التثبيت). المشكلة هي أن هذا الرابط ليس جزءًا من Windows. يتم توفيره مع Visual Studio أو حزمة منفصلة Build Tools for Visual Studio.

النقطة الأساسية: لا يمكن لـ Rust العثور على link.exe لأنه ببساطة غير مثبت على جهاز الكمبيوتر الخاص بك، أو لم يتم إضافته إلى متغير البيئة النظامي PATH.

قائمة مراجعة سريعة: ما الذي قد يكون خطأ؟

\n
• لقد قمت بتثبيت Rust عبر rustup-init.exe وضغطت على "Enter" في كل مكان. هذا طبيعي، لكن المثبت لا يقوم بتثبيت Visual Studio.
\n
• لديك Visual Studio Code أو IDE آخر مثبت، ولكن ليس Visual Studio. هذان ليسا نفس الشيء.
\n
• لقد اخترت سلسلة أدوات GNU أثناء التثبيت. إذا كان الأمر كذلك، فأنت بحاجة إلى GCC (عبر MinGW مثلًا) وليس MSVC. لكن اليوم نتحدث عن MSVC القياسي.
\n

الحل رقم 1: تثبيت Visual Studio Build Tools (الطريقة الموصى بها)

هذه هي الطريقة الأكثر صحة و"أصلية" لنظام Windows. تقدم Microsoft حزمة مجانية تتضمن فقط المترجم والرابط — بدون IDE الضخم.

\n
1. قم بتنزيل المثبت: انتقل إلى الموقع الرسمي لـ Microsoft وقم بتنزيل Build Tools for Visual Studio 2022. ابحث عن "Visual Studio 2022 Build Tools".
\n
2. قم بتشغيل التثبيت: قم بتشغيل الملف الذي تم تنزيله vs_BuildTools.exe.
\n
3. اختر المكونات: في المثبت، اختر علامة التبويب "أعباء العمل" (Workloads). حدد المربع الخاص بـ "تطوير تطبيقات سطح المكتب باستخدام C++" (Desktop development with C++).
\n
4. التثبيت: اضغط على زر "تثبيت" في الزاوية اليمنى السفلية. قد تستغرق العملية من 10 إلى 20 دقيقة، حيث يتم تنزيل حوالي 2-3 جيجابايت من البيانات.
\n
5. إعادة التشغيل (اختياري): بعد اكتمال التثبيت، أعد تشغيل الكمبيوتر لتحديث متغيرات البيئة.
\n

بعد ذلك، افتح طرفية جديدة وحاول مرة أخرى تجميع مشروعك:

cargo new hello_world