Git add -p: विशिष्ट पंक्तियों को चरणबद्ध करें और केंद्रित प्रतिबद्धताएँ बनाएं

फ़ाइल के केवल एक भाग को प्रतिबद्ध करने के लिए, अपने इच्छित परिवर्तनों को `git add -p -- path/to/file` के साथ चरणबद्ध करें, `git diff --cached` के साथ उनकी समीक्षा करें, फिर प्रतिबद्ध करें। शेष संपादन आपकी कार्यशील फ़ाइलों में रहते हैं। GitTree में, फ़ाइल डिफ खोलें, बदली हुई पंक्तियों का चयन करें और उसी प्रकार की केंद्रित प्रतिबद्धता तैयार करने के लिए Stage Lines चुनें।

मान लीजिए कि आपने चेकआउट सत्यापन बग ठीक कर दिया है, फिर उसी घटक को पुनर्गठित करना शुरू कर दिया है। एक समीक्षक को अधूरे रिफैक्टर को पढ़े बिना बग फिक्स को समझने में सक्षम होना चाहिए। यह मार्गदर्शिका उन परिवर्तनों को इतिहास बनने से पहले ही अलग कर देती है। एनिमेटेड उदाहरण GitTree का उपयोग करता है, जो क्लाइंट हम macOS, Windows और Linux के लिए बनाते हैं। आंशिक स्टेजिंग निःशुल्क योजना से संबंधित है; वर्तमान आधिकारिक बिल्ड के लिए साइन-इन की आवश्यकता होती है।

वर्किंग ट्री, स्टेजिंग एरिया और कमिटमेंट: क्या बचाया जाता है?

स्टेजिंग एक चयन कदम है, न कि कोई प्रतिबद्धता और न ही कोई धक्का। एक फ़ाइल को आंशिक रूप से चरणबद्ध किया जा सकता है: सूचकांक एक संस्करण रखता है जबकि आपका संपादक सभी संपादन दिखाता है। यदि आप स्टेजिंग के बाद दोबारा संपादन करते हैं, तो स्टेज्ड संस्करण चुपचाप अपडेट नहीं होता है। प्रतिबद्ध होने से पहले इसकी दोबारा समीक्षा करें. विज़ुअल कमिट ग्राफ़ कमिट मौजूद होने के बाद इतिहास का निरीक्षण करने में मदद करता है।

एक फ़ाइल पर git add -p का उपयोग कैसे करें

git status से शुरू करें और पहले से ही चरणबद्ध किसी भी चीज़ का निरीक्षण करें। पैच मोड मौजूदा इंडेक्स में चयनित परिवर्तन जोड़ता है; यह पहले के चयनों को नहीं हटाता है. इस उदाहरण में, src/checkout.ts को अपनी ट्रैक की गई टेक्स्ट फ़ाइल से बदलें, फिर केवल सत्यापन फिक्स को स्वीकार करें जब Git प्रत्येक ब्लॉक के बारे में पूछे।

git status
git diff --cached
git diff -- src/checkout.ts
git add -p -- src/checkout.ts
git diff --cached
git diff -- src/checkout.ts
git commit -m "fix: validate checkout input"

चरणबद्ध अंतर की समीक्षा करने और इच्छित परिवर्तन का परीक्षण करने के बाद ही अंतिम प्रतिबद्धता चलाएँ। git diff --cached दिखाता है कि कमिट क्या रिकॉर्ड करेगा; सादा git diff दिखाता है कि क्या अप्रतिबद्ध रहेगा। इस वर्कफ़्लो के लिए git commit -a का उपयोग न करें या git commit को फ़ाइल पथ न दें: वे फ़ॉर्म आपके द्वारा अभी-अभी तैयार किए गए आंशिक चयन को बायपास कर सकते हैं।

जब फिक्स और रिफैक्टर एक साथ करीब हों तो एक हंक को विभाजित करें

हंक संदर्भ के साथ पास की बदली हुई रेखाओं का एक ब्लॉक है। पैच मोड फिक्स और रिफैक्टर को एक साथ समूहित कर सकता है। Git को ब्लॉक विभाजित करने के लिए कहने के लिए s का उपयोग करें। यदि संपादनों को स्वचालित रूप से अलग नहीं किया जा सकता है, तो e एक पैच संपादक खोलता है, या एक विज़ुअल लाइन चयनकर्ता आपको इच्छित परिवर्धन और निष्कासन चुनने में मदद कर सकता है।

प्रतिस्थापन के लिए, हटाई गई लाइन और उसके प्रतिस्थापन दोनों को एक तार्किक परिवर्तन के रूप में मानें। केवल आधे का चयन करने से वह कोड उत्पन्न हो सकता है जिसे आपने अपने संपादक में कभी नहीं देखा होगा। उन्नत पैच संपादन विकल्प है; यदि आप चरणबद्ध परिणाम की व्याख्या नहीं कर सकते हैं, तो इसे अस्थिर करें और एक स्पष्ट सीमा चुनें। केंद्रित प्रतिबद्धताओं को अपने दम पर काम करने की ज़रूरत है, न कि केवल छोटी होने की।

डाउनलोड करें GitTree मिश्रित अंतर की समीक्षा करने और दृष्टिगत रूप से केंद्रित प्रतिबद्धताएं बनाने के लिए। आप इसे टर्मिनल के साथ-साथ मौजूदा रिपॉजिटरी पर उपयोग कर सकते हैं; दोनों एक ही Git स्टेजिंग क्षेत्र पढ़ते हैं।

आपके संपादनों को त्यागे बिना परिवर्तनों को अस्थिर करें

git restore --staged -- src/checkout.ts
# Or choose which staged blocks to remove:
git restore --staged -p -- src/checkout.ts

ये विकल्प आदेश हैं. --staged के साथ, पुनर्स्थापना आपकी कार्यशील फ़ाइल के बजाय अनुक्रमणिका में परिवर्तन लाती है। कमिट वाले रिपॉजिटरी के लिए, यह आम तौर पर चरणबद्ध सामग्री को HEAD की ओर रीसेट करता है। --staged के बिना, पुनर्स्थापना कार्यशील संपादनों को अधिलेखित कर सकती है, इसलिए अंतर स्पष्ट रखें। GitTree में अनस्टेज चुनें, डिस्कार्ड नहीं, जब आप केवल यह बदलना चाहते हैं कि अगली प्रतिबद्धता में क्या शामिल है।

एक फ़ाइल दो बार क्यों दिखाई देती है, या एक पंक्ति का मंचन क्यों नहीं किया जा सकता है?

स्टेज्ड फाइलों और अनस्टेज्ड फाइलों दोनों के तहत एक फ़ाइल का मतलब आमतौर पर आंशिक स्टेजिंग या बाद में संपादन होता है, न कि डुप्लिकेट फ़ाइल। पैच मोड द्वारा अपनी सामग्री पेश करने से पहले एक नई, ट्रैक न की गई टेक्स्ट फ़ाइल को git add -N -- path/to/new-file की आवश्यकता हो सकती है। बाइनरी फ़ाइलों में कोई सामान्य टेक्स्ट हंक नहीं होता; GitTree संपूर्ण-फ़ाइल संचालन के रूप में नाम बदलने, एलएफएस पॉइंटर्स और सबमॉड्यूल परिवर्तनों को भी चरणबद्ध करता है। यदि रिक्त स्थान छिपा हुआ है, तो केवल रिक्त स्थान वाले परिवर्तनों को चुनने से पहले इसे दिखाएँ।

यदि कोई संपादक या फ़ॉर्मेटर आपके द्वारा फ़ाइल का अंतर खोलने के बाद उसे बदलता है, तो GitTree पुरानी लाइन चयन को अस्वीकार कर सकता है। अंतर को ताज़ा करें और फिर से चुनें। केवल छोटी पंक्ति संख्या तक पहुंचने के लिए कसकर युग्मित परिवर्तनों को विभाजित करने से बचें। किसी कार्य में रुकावट के लिए, अधूरे काम को छिपाएँ; पहले से प्रतिबद्ध मिश्रित इतिहास के लिए, इंटरैक्टिव रीबेस गाइड की समीक्षा करें।

आप जो कमिट तैयार कर रहे हैं उसका परीक्षण करें, न कि केवल संपादक की फाइलों का

आपका सामान्य परीक्षण आदेश कार्यशील फ़ाइलों के विरुद्ध चलता है, जिसमें अभी भी अस्थिर संपादन शामिल हैं। वहां परीक्षण पास करने से यह साबित नहीं होता कि आंशिक प्रतिबद्धता पूरी हो गई है। एक महत्वपूर्ण विभाजन के लिए, पहले स्थानीय कमिट बनाएं, फिर एक अलग क्लीन चेकआउट या वर्कट्री में उस प्रतिबद्ध स्नैपशॉट का निरीक्षण और परीक्षण करें। यदि शाखा साझा करने से पहले यह विफल हो जाती है तो लापता निर्भरता जोड़ें। वर्कट्री गाइड बताता है कि कैसे अलग-अलग फ़ोल्डर्स उन संस्करणों को अलग रखने में मदद करते हैं।