خطأ "undefined" لدالة في Go: الأسباب والحلول | PythonLib

خطأ "Undefined" في Go: كيف تجعل الملفات تتعاون بسلاسة

تخيل أنك تكتب برنامجًا بلغة Go، وتقسم الكود إلى ملفات منطقية (مثل main.go و helper.go)، ثم تشغل go run main.go — وفجأة يظهر لك المترجم رسالة باردة: «undefined: MyFunction». هل يبدو هذا مألوفًا؟ هذا السؤال هو من أكثر الأسئلة شيوعًا على Stack Overflow (آلاف المشاهدات!)، واليوم سنحل هذه المشكلة نهائيًا.

لماذا Go، التي تشتهر ببساطتها، لا ترى دالة من ملف مجاور؟ الأمر ليس سحرًا، بل يتعلق بقواعد صارمة لتنظيم الكود. دعنا نستعرض جميع السيناريوهات — من الخطأ الكلاسيكي للمبتدئين إلى العمل الصحيح مع الوحدات.

السيناريو 1: الكلاسيكي — نسيان تحديد جميع الملفات عند التشغيل

الحالة الأكثر شيوعًا. تكتب:

// main.go\npackage main\n\nfunc main() {\n    printHello() // خطأ: undefined: printHello\n}\n

// helper.go\npackage main\n\nimport "fmt"\n\nfunc printHello() {\n    fmt.Println("مرحبًا!")\n}\n

وتشغل فقط go run main.go. Go لا ترى helper.go لأنك لم تحددها صراحةً. الحل الصحيح:

go run main.go helper.go\n// أو بشكل أبسط:\ngo run .\n

لماذا يحدث هذا؟ Go لا تفحص المجلد تلقائيًا — يجب عليك سرد جميع ملفات الحزمة. الأمر go run . يشغل المجلد الحالي بأكمله كحزمة واحدة.

السيناريو 2: حزم مختلفة — عدم الرؤية الافتراضية

فخ شائع آخر هو محاولة استدعاء دالة من حزمة أخرى دون استيراد وتصدير.

// main.go\npackage main\n\nfunc main() {\n    helper.DoSomething() // خطأ: undefined: helper\n}\n

// helper/helper.go\npackage helper\n\nfunc DoSomething() {\n    // ...\n}\n

هنا مشكلتان:

\n
• الملفات في حزم مختلفة (main و helper).
\n
• الدالة DoSomething غير مُصدّرة (تبدأ بحرف صغير).
\n

النسخة المصححة:

// main.go\npackage main\n\nimport "yourmodule/helper"\n\nfunc main() {\n    helper.DoSomething() // يعمل!\n}\n

// helper/helper.go\npackage helper\n\nfunc DoSomething() { // حرف كبير!\n    // ...\n}\n

تذكر: في Go، يتم تصدير الكيانات التي تبدأ بـ حرف كبير فقط. الحرف الصغير يعني أنها خاصة بالحزمة.

السيناريو 3: مشاكل مع الوحدات و GOPATH

إذا كنت تستخدم النمط القديم (GOPATH) أو قمت بتهيئة الوحدة بشكل غير صحيح، فقد لا تجد Go ملفاتك حتى في نفس المجلد.

تحقق من:

\n
1. هل يوجد ملف go.mod في جذر المشروع؟ إذا لم يكن موجودًا، أنشئه: go mod init اسم_الوحدة.
\n
2. هل تخزن المشروع داخل $GOPATH/src بدون وحدة؟ هذا وضع قديم قد يسبب ارتباكًا.
\n
3. تأكد من أن جميع الملفات في المجلد لها نفس package (باستثناء ملفات الاختبار التي تنتهي بـ _test).
\n

مثال على هيكل صحيح:

myproject/\n├── go.mod          # module myproject\n├── main.go         # package main\n└── helper.go       # package main\n

السيناريو 4: أسماء الملفات ذات الشرطات السفلية وملفات الاختبار

Go تتجاهل الملفات التي تبدأ بـ _ أو . (مثل _hidden.go). أما الملفات التي تنتهي بـ _test.go فتُجمّع فقط عند تشغيل الاختبارات (go test). إذا سمّيت ملف العمل عن طريق الخطأ helper_test.go — فلن تظهر دوالّه في الكود الرئيسي.

السيناريو 5: التبعيات الدائرية

أحيانًا، قد يكون خطأ "undefined" نتيجة لاستيراد دائري. على سبيل المثال، الحزمة A تستورد B، و B تستورد A. Go تمنع هذه الحلقات وقد تظهر أخطاء غريبة. الحل هو إعادة هيكلة الكود لكسر الدائرة.