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 /home/user/myapp/ में go.mod ढूँढ लेगा।

व्यावहारिक उदाहरण: त्रुटि को पुनः उत्पन्न करना

आइए स्थिति का अनुकरण करें। बिना मॉड्यूल के एक सरल फ़ाइल बनाएँ:

// 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