کمٹ اور پش

فائلیں اسٹیج کریں، کمٹ میسج ہاتھ سے لکھیں یا AI ایجنٹ سے لکھوائیں، اور چند کلکس میں اپنے ریموٹ پر پش کریں۔

جب آپ diff کا جائزہ لے چکے ہوں اور AI ایجنٹ کی کی گئی تبدیلیوں سے مطمئن ہوں، تو اب کمٹ اور پش کرنے کا وقت ہے۔ یہ گائیڈ اسٹیجنگ سے لے کر ریموٹ ریپوزٹری پر پش کرنے تک کا پورا ورک فلو بیان کرتی ہے۔

تبدیلیاں اسٹیج کریں

اسٹیجنگ آپ کو یہ منتخب کرنے دیتی ہے کہ اس کمٹ میں ٹھیک کون سی تبدیلیاں جائیں گی۔ مثال کے طور پر، آپ فیچر کا کوڈ اور کنفیگ کی تبدیلی الگ الگ کمٹ کرنا چاہ سکتے ہیں۔

Git پینل میں، ہر تبدیل شدہ فائل Unstaged Changes سیکشن میں نظر آتی ہے:

  • کسی فائل کو انفرادی طور پر اسٹیج کرنے کے لیے اس کے ساتھ موجود چیک باکس کو چیک کریں
  • تمام تبدیل شدہ فائلوں کو ایک ساتھ اسٹیج کرنے کے لیے Stage All پر کلک کریں
  • کسی فائل کو انسٹیج کرنے کے لیے چیک باکس ان چیک کریں — وہ واپس Unstaged میں چلی جاتی ہے

اسٹیج کی گئی فائلیں سائیڈ بار کے اوپر Staged Changes سیکشن میں چلی جاتی ہیں۔ کمٹ میں صرف اسٹیج کی گئی فائلیں شامل ہوں گی۔

آپ پوری فائل کے بجائے انفرادی hunks (فائل کے حصے) بھی اسٹیج کر سکتے ہیں۔ diff ویو میں، کسی hunk پر ماؤس لے جائیں اور ظاہر ہونے والے + بٹن پر کلک کریں تاکہ صرف وہی حصہ اسٹیج ہو۔ یہ اس وقت مفید ہے جب کسی فائل میں دو غیر متعلق تبدیلیاں ہوں اور آپ ابھی صرف ایک کو کمٹ کرنا چاہتے ہوں۔

تبدیلیاں فولڈر ٹری کے طور پر دیکھیں

ایجنٹس چوڑی اور کم گہری diffs بناتے ہیں — چار ڈائریکٹریز اور اٹھارہ فائلوں کو چھونے والی تبدیلی معمول کی بات ہے۔ فلیٹ فہرست اسے اٹھارہ تقریباً ایک جیسے پاتھز کی قطاروں میں بدل دیتی ہے۔

Filter باکس کے ساتھ موجود ایک ٹوگل Changes کی فہرست کو فلیٹ فہرست اور VS Code طرز کے فولڈر ٹری کے درمیان بدلتا ہے، اور آپ کا انتخاب اگلی بار ڈائیلاگ کھولنے پر بھی برقرار رہتا ہے۔

فولڈر ٹری موڈ میں Git Changes ڈائیلاگ، 18 تبدیل شدہ فائلیں scripts، src/main/database/adapters اور renderer/components کے تحت، ہر ڈائریکٹری کی قطار پر فی فولڈر اسٹیجنگ چیک باکس کے ساتھ

  • فولڈر کا چیک باکس اس کے نیچے موجود ہر چیز کو ایک کلک میں اسٹیج یا انسٹیج کر دیتا ہے، یعنی حصے کے لحاظ سے جائزہ لینا اور حصے کے لحاظ سے اسٹیج کرنا ایک ہی عمل ہے۔
  • فولڈر پر ڈیش کا مطلب ہے کہ وہ جزوی طور پر اسٹیج ہے۔ جزوی اسٹیجنگ غلطی سے ہو جانا آسان ہے اور فلیٹ فہرست میں تقریباً نظر نہیں آتی؛ تین حالتوں والا چیک باکس اسے ڈائریکٹری کی سطح پر ظاہر کر دیتا ہے۔
  • Collapse all / expand all ایسی تبدیلیوں کو سنبھالتے ہیں جو کئی ڈائریکٹریز پر پھیلی ہوں۔

فلیٹ فہرست جوں کی توں ہے اور ہر قطار پر مکمل پاتھ دکھاتی ہے، اس صورت میں جب تبدیلیاں اتنی کم ہوں کہ گروپنگ صرف ایک اضافی کلک ہو۔

کمٹ میسج لکھیں

فائلیں اسٹیج ہونے کے بعد، Git پینل کے نیچے ٹیکسٹ فیلڈ میں اپنا کمٹ میسج لکھیں۔

ایک اچھا کمٹ میسج آپ کی ہسٹری کو پڑھنے کے قابل بناتا ہے — آپ کے مستقبل کے لیے بھی اور پراجیکٹ پر کام کرنے والے ہر دوسرے شخص کے لیے بھی۔ چند مشورے:

  • امری صیغہ استعمال کریں — "Add login form" لکھیں، "Added login form" یا "Adding login form" نہیں
  • بتائیں کہ کیا بدلا اور کیوں — "Fix null check in user.ts" زیادہ کارآمد ہے بنسبت "fix bug" کے
  • پہلی لائن 72 حروف سے کم رکھیں — زیادہ تر git ٹولز فہرست ویوز میں لمبے میسجز کو کاٹ دیتے ہیں
  • ضرورت ہو تو باڈی شامل کریں — پہلی لائن کے بعد دو بار Enter دبائیں تاکہ نیچے تفصیلی وضاحت لکھ سکیں

واضح کمٹ میسجز کی مثالیں:

  • Add email validation to signup form
  • Fix crash when user list is empty
  • Update API base URL for production

ایجنٹ سے لکھوائیں

کمٹ سمری میں موجود sparkle بٹن آپ کا diff کسی انسٹال شدہ AI CLI کو دیتا ہے اور اس سے میسج مانگتا ہے۔

  • منتخب کریں کہ کون سا ایجنٹ لکھے، یا 1DevTool کو آپ کے انسٹال کردہ پہلے ایجنٹ کو استعمال کرنے دیں۔ Kimi Code دوسرے ایجنٹس کے ساتھ فہرست میں شامل ہے۔ بہت سے ایجنٹس انسٹال ہوں تو مینو ونڈو کے مطابق ہو جاتا ہے اور اسکرول ہوتا ہے۔
  • ایک اسٹائل منتخب کریں: Conventional، Plain، یا Gitmoji۔
  • اگر ابھی کچھ اسٹیج نہ ہو تو یہ ورکنگ ٹری کے diff پر چلا جاتا ہے — اس طرح آپ یہ طے کرنے سے پہلے ہی میسج حاصل کر سکتے ہیں کہ کیا اسٹیج کرنا ہے۔

نتیجہ میسج فیلڈ میں عام قابلِ ترمیم متن کے طور پر آتا ہے۔ یہ ایک مسودہ ہے، کمٹ نہیں۔

کمٹ کریں

میسج فیلڈ کے نیچے Commit بٹن پر کلک کریں۔ اسٹیج کی گئی تبدیلیاں آپ کی مقامی git ہسٹری میں نئے کمٹ کے طور پر محفوظ ہو جاتی ہیں، اور اسٹیج شدہ فائلوں کا سیکشن خالی ہو جاتا ہے۔

کمٹ اب آپ کی برانچ ہسٹری میں نظر آتا ہے۔ اگر آپ اسے واپس کرنا چاہیں تو ہسٹری ویو میں کمٹ پر رائٹ کلک کریں اور Undo Commit منتخب کریں — اس سے تبدیلیاں کھوئے بغیر واپس آپ کی unstaged فائلوں میں آ جاتی ہیں۔

ریموٹ پر پش کریں

کمٹ تبدیلیوں کو مقامی طور پر محفوظ کرتا ہے۔ انہیں GitHub، GitLab یا اپنے کسی دوسرے ریموٹ پر بھیجنے کے لیے:

  1. Git پینل کے ٹول بار میں Push بٹن (اوپر کے تیر کا آئیکن) پر کلک کریں
  2. اگر برانچ ریموٹ پر پہلے سے موجود ہے تو آپ کے کمٹس فوراً پش ہو جاتے ہیں
  3. اگر یہ نئی برانچ ہے جو ابھی ریموٹ پر موجود نہیں، تو Publish Branch پر کلک کریں — اس سے ریموٹ پر برانچ بن جاتی ہے اور آپ کے کمٹس پش ہو جاتے ہیں

اگر آپ سے credentials مانگے جائیں تو آپ انہیں درج کر سکتے ہیں یا SSH کلید کی تصدیق پر جا سکتے ہیں۔ اپنا GitHub اکاؤنٹ جوڑنے کا طریقہ جاننے کے لیے Git Accounts دیکھیں تاکہ credentials خودکار طور پر سنبھالے جائیں۔

نئی برانچ پش کرنا

تبدیلیاں پل کریں

ریموٹ سے تبدیلیاں لانے کے لیے (مثلاً اگر کسی ٹیم ممبر نے کچھ پش کیا ہو):

  1. ٹول بار میں Pull بٹن (نیچے کے تیر کا آئیکن) پر کلک کریں
  2. ریموٹ کی تبدیلیاں fetch ہو کر آپ کی مقامی برانچ میں merge ہو جاتی ہیں

اگر merge conflicts ہوں تو Git پینل متصادم فائلوں کو نمایاں کر دیتا ہے۔ ہر ایک کو کھول کر تنازع حل کریں، پھر حل کو اسٹیج اور کمٹ کریں۔

git شامل کرنے کا فوری بٹن

پش کرنے کے بعد، آپ کی تبدیلیاں ریموٹ پر موجود ہوتی ہیں اور آپ کی ٹیم کے لیے دستیاب یا پل ریکویسٹ کے لیے تیار ہوتی ہیں۔ Git پینل ظاہر کرتا ہے کہ آپ کی برانچ ریموٹ کے ساتھ اپ ٹو ڈیٹ ہے۔