استيراد الحزم المحلية في Go: دليل خطوة بخطوة مع كود

لماذا يثير استيراد الحزم المحلية في Go الكثير من الأسئلة؟

إذا كنت قد حاولت يومًا تنظيم كود Go في ملفات ومجلدات منفصلة، فمن المحتمل أنك واجهت خطأ مثل could not import "myproject/utils". هذه واحدة من أكثر المشكلات شيوعًا بين مطوري Go المبتدئين. على Stack Overflow، حصد سؤال "How to import local packages in go?" آلاف المشاهدات - وليس بدون سبب.

على عكس Python، حيث يكفي وضع ملف بجانب آخر وكتابة import mymodule، يتطلب Go هيكلًا واضحًا وإعدادًا صحيحًا للوحدات. ولكن بمجرد إتقان هذه الآلية، ستدرك مدى أناقتها. دعنا نفهمها مرة واحدة وإلى الأبد.

نظرية مختصرة: كيف يفهم Go الحزم

قبل كتابة الكود، تذكر ثلاثة مبادئ أساسية:

\n
• Go هي لغة ذات هيكل وحدات صارم. كل دليل هو حزمة واحدة (package).
\n
• اسم الحزمة ليس ملزمًا بأن يتطابق مع اسم المجلد، لكن يُوصى بشدة بذلك لتحسين readability.
\n
• استيراد الحزم المحلية منذ عام 2019 يتم عبر الوحدات (Go modules). انسَ GOPATH - استخدم go mod.
\n

الآن ننتقل إلى التطبيق العملي.

الخطوة 1: إنشاء مشروع مع وحدة

افتح terminal وأنشئ مجلدًا جديدًا لمشروعك:

mkdir go-local-imports\ncd go-local-imports\n

الآن، قم بتهيئة الوحدة. يمكن أن يكون اسم الوحدة أي شيء، لكن من المنطقي استخدام مسار فريد (مثل رابط المستودع):

go mod init github.com/your-username/go-local-imports\n

بعد هذا الأمر، سيظهر ملف go.mod في المجلد. هذا الملف سيدير التبعيات - المحلية والخارجية على حد سواء.

الخطوة 2: إنشاء حزمة محلية

لننشئ مجلد utils داخل المشروع. بداخله، ملف math.go:

mkdir utils\ncd utils\ntouch math.go\n

افتح utils/math.go واكتب:

package utils\n\n// Add ترجع مجموع عددين صحيحين\nfunc Add(a, b int) int {\n    return a + b\n}\n

لاحظ: الدالة Add مكتوبة بحرف كبير. في Go، هذا يعني أنها مُصدرة (عامة). إذا كتبت add - فستكون خاصة وغير متاحة من الحزم الأخرى.

الخطوة 3: استيراد واستخدام الحزمة المحلية

عد إلى المجلد الجذر للمشروع وأنشئ main.go:

cd ..\ntouch main.go\n

محتوى main.go:

package main\n\nimport (\n    "fmt"\n    "github.com/your-username/go-local-imports/utils"\n)\n\nfunc main() {\n    result := utils.Add(3, 5)\n    fmt.Println("المجموع:", result)\n}\n

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

go run main.go\n

يجب أن ترى:

المجموع: 8\n

كل شيء يعمل! ولكن إذا حصلت على خطأ - اقرأ القسم التالي.

الأخطاء النموذجية وحلولها

الخطأ 1: "package is not in GOROOT"

ترى شيئًا مثل:

package myproject/utils is not in GOROOT (/usr/local/go/src/myproject/utils)

السبب: تحاول استيراد حزمة بدون وحدة. Go يبحث عنها في المكتبة القياسية، وليس في مشروعك.

الحل: تأكد من وجود go.mod في جذر المشروع. إذا لم يكن موجودًا، نفذ go mod init اسم-الوحدة.

الخطأ 2: "undefined: utils.Add"

السبب: الدالة مكتوبة بحرف صغير (خاصة)، أو أنك استوردت الحزمة ولكنك لا تستخدم اسمها.

الحل: تحقق من أن جميع الدوال المطلوبة مُصدرة (بحرف كبير)، وأنك تشير إليها باستخدام اسم الحزمة.