Go يشتكي من go.mod؟ لماذا يحدث هذا وكيف يعمل

مقدمة: الخوف المألوف لكل مبتدئ في Go

لقد بدأت للتو في تعلم Go. الإلهام يغمرك، تكتب أول Hello, World!، تشغل go run main.go — وبدلاً من التحية ترى جدارًا أحمر من النص. العبارة الرئيسية التي تجعل قلبك يبرد: "go: go.mod file not found in current directory or any parent directory; see 'go help modules'".

هل هذا مألوف؟ لا تقلق، لقد رأى هذا الخطأ كل من بدأ العمل مع Go بعد الإصدار 1.11. هذا ليس خطأ في المترجم ولا لعنة من الآلهة القديمة. هذه هي آلية نظام الوحدات في Go الصارمة ولكن العادلة. اليوم لن نعرض فقط كيفية إصلاحه (على الرغم من أننا سنفعل ذلك). سننظر "تحت الغطاء": سنفهم لماذا يطلب Go ملف go.mod، وكيف يبحث عنه، وماذا يحدث إذا لم يكن الملف موجودًا.

بحلول نهاية المقال، لن تتخلص من الخطأ فحسب، بل ستفهم أيضًا فلسفة إدارة التبعيات في Go. هيا بنا!

ما هو go.mod ولماذا يحتاجه Go؟

تخيل أن go.mod هو جواز سفر مشروعك. في هذا الملف، يخزن Go ثلاثة أشياء رئيسية:

\n
• اسم الوحدة (على سبيل المثال، example.com/myproject) — معرف فريد.
\n
• إصدار Go الذي كُتب به المشروع.
\n
• قائمة التبعيات — الحزم الخارجية التي تستخدمها وإصداراتها الدقيقة.
\n

قبل ظهور الوحدات (في إصدارات Go < 1.11) كان الأمر مختلفًا. كان يجب تخزين الكود بدقة داخل مجلد $GOPATH/src. كان هذا غير مريح: لم يكن بإمكانك ببساطة استنساخ مستودع في أي مجلد وتشغيله. حل نظام الوحدات (Go modules) هذه المشكلة، مما جعل المشاريع قابلة للنقل ومعزولة.

الآن ينظر Go إلى go.mod كحدود للمشروع. إذا لم يكن الملف موجودًا، يعتبر Go أنك تعمل خارج المشروع ويرفض تنفيذ الكود. هذا هو جذر خطأنا.

كيف يبحث Go عن go.mod: خوارزمية "من الأسفل إلى الأعلى"

عندما تكتب go run main.go، يبدأ Go في البحث عن go.mod وفقًا للخوارزمية التالية:

\n
1. ابدأ من الدليل الحالي. إذا كان في المجلد الذي يحتوي على main.go ملف go.mod — رائع، نعمل.
\n
2. إذا لم يكن موجودًا — اصعد مستوى واحدًا للأعلى (إلى المجلد الأصلي). تحقق مرة أخرى.
\n
3. كرر الخطوة 2 حتى تصل إلى جذر نظام الملفات (/ على Linux/Mac أو C:\\ على Windows).
\n
4. إذا وصلت إلى الجذر ولم تجد go.mod — أخرج الخطأ "go.mod file not found in current directory or any parent directory".
\n

تسمى هذه الخوارزمية "walk up the directory tree". تسمح لك بتشغيل الكود من أي مجلد متداخل داخل المشروع. على سبيل المثال، إذا كان مشروعك موجودًا في /home/user/myapp/، ودخلت إلى /home/user/myapp/cmd/ وشغلت go build، سيجد Go ملف go.mod في /home/user/myapp/.

مثال عملي: إعادة إنتاج الخطأ

دعنا نحاكي الموقف. لننشئ ملفًا بسيطًا بدون وحدة:

// main.go\npackage main\n\nimport "fmt"\n\nfunc main() {\n    fmt.Println("مرحبًا من عالم بدون go.mod!")\n}

الآن لنجرب التشغيل:

$ go run main.go\ngo: go.mod file not found in current directory or any parent directory; see 'go help modules'

ها هو خطأنا. لقد مر Go بأمانة عبر جميع المجلدات من الحالي إلى الجذر، لكنه لم يجد go.mod. الحل واضح: يجب إنشاء هذا الملف.

كيفية إصلاح الخطأ بشكل صحيح

الطريقة 1: بداية سريعة مع go mod init

الطريقة الأكثر صحة هي تهيئة الوحدة:

$ go mod init example.com/myfirstapp\ngo: creating new go.mod: module example.com/myfir