التوثيق

التحضير والتنفيذ

تغطي منطقة CHANGES في لوح Git حلقة التنفيذ اليومية: مراجعة التغييرات والتحضير والترك والكبس والتنفيذ برسالة.

التحضير وإلغاؤه

  • تُسرَد التغييرات غير المحضرة تحت CHANGES، وكل ملف موسوم بشارة حالة — M معدَّل، A مضاف، D محذوف، ? غير متتبَّع، ! تعارض (تحمل سطور الوحدات الفرعية وسم SUB إضافيًا);
  • يحوم المؤشر فوق سطر فيكشف أزرار إجراء داخلية: + يحضّر ملفًا غير محضَّر، و − يلغي تحضير محضَّر، و × على سطر غير محضَّر يتركه؛ ويقوم زرا Stage All Changes / Unstage All Changes في ترويسات الأقسام بالكل دفعة واحدة;
  • ينقر Ctrl بالملفات إلى تحديد متعدد وينقر Shift نطاقًا — فينطبق زر الإجراء عندها على كل ملف محدد;
  • النقر على اسم ملف يفتح diff له لمراجعة التغيير قبل القرار;
  • يقدم الزر الأيمن على ملف View File History و Stash This File و Copy Full Path / Copy Relative Path و Reveal in File Explorer واختصار cd ينقل الطرفية إلى مجلد الملف.
قسم STAGED CHANGES — ملفات محضرة بأزرار Unstage لكل سطر

التنفيذ

  1. حضّر ما يجب أن يدخل;
  2. اكتب رسالة في صندوق التنفيذ (Ctrl+Enter ينفذ) أو اضغط زر الذكاء لتوليدها (انظر مساعدة LLM);
  3. اضغط Commit.
صندوق التنفيذ — إدخال الرسالة مع زر التوليد بالذكاء

بعد التنفيذ، حوّم على ترويسة التاريخ — الشريط الحامل اسم الفرع فوق تاريخ التنفيذات — فتظهر أزرار Fetch و Pull و Push يمينه تدريجيًا. يرسل Push الفرع الحالي إلى منبعه فورًا؛ ولسيارات مثل Force with lease استخدم حوار الدفع لقائمة الفروع (انظر الدفع والسحب والمزيد).

الحوم فوق ترويسة التاريخ يكشف أزرار Fetch وPull وPush

الكبس (Stash)

  • زر الأرشفة في ترويسة CHANGES يفتح حوار Stash All Changes، حيث تصف رسالة اختيارية الكبسة;
  • يقدم الزر الأيمن على ملفات غير محضرة محددة Stash This File (أو Stash <n> Selected Files لتحديد متعدد) لكبس تلك المسارات فقط — باستثناء سطور الوحدات الفرعية;
  • تتجمع الكبائن تحت STASHES كمدخلات WIP on <branch>؛ وتوسيع واحدة يسرد ملفاتها الملتقطة، والنقر على ملف يعرض diffه;
  • يعرض الحوم فوق سطر كبسة Apply (استعادة مع إبقاء) و Pop (تطبيق وإزالة) و Drop (إزالة دون تطبيق) — يطلب Pop و Drop تأكيدًا أولًا، وتضيف قائمة الزر الأيمن View Diff;
  • يبقى قسم STASHES مخفيًا ما دامت قائمة الكبائن فارغة.
حوار Stash All Changes برسالته الاختيارية قسم STASHES — كبسة موسعة إلى ملفاتها مع أزرار Apply وPop وDrop Pop يطبق الكبسة ويزيلها من القائمة بعد تأكيد

الترك

‏Discard Changes على ملف غير محضَّر يلقي بكل تغييراته غير المنفذة — هناك حوار تأكيد، والفعل لا يمكن التراجع عنه.

يشمل التنفيذ المحتوى المحضَّر فقط؛ وتبقى التغييرات غير المحضرة في شجرة العمل.

← السابق

مساعدة LLM

Git

التالي →

أشجار العمل

Git