ورقة Git مرجعية قابلة للبحث تغطي الإعداد وحلقة الالتزام اليومية والتفرع والمستودعات البعيدة والتاريخ والاسترداد، مع نسخ بنقرة واحدة لكل أمر.
تسعة وأربعون أمر Git تستحق الحفظ. صفِّ عبر أسماء الأوامر وأوصافها، ثم انسخ الذي تحتاجه. مجمعة حسب الإعداد وسير العمل اليومي والتفرع والمستودعات البعيدة والتاريخ وتراجع الأخطاء.
لا يوجد أمر يطابق هذا التصفية.
يمتلك Git أكثر من مئة أمر porcelain، لكن معظم المهندسين يستخدمون العشرين أو الثلاثين نفسها يوميًا ويلجؤون إلى الباقي بضع مرات في السنة. ورقة الغش ليست بديلاً عن فهم النموذج؛ بل توجد بحيث تبقى الأوامر التي تفهمها بالفعل على بُعد ضغطة واحدة بدلاً من بُعد تبويب متصفح وثلاث إجابات من Stack Overflow.
المرجع في هذه الصفحة مجمّع بالطريقة التي يحدث بها العمل فعلًا: إعداد مستودع، حلقة الالتزام التي تشغّلها عشرات المرات يوميًا، التفرع، التواصل مع مستودع بعيد، قراءة التاريخ، وإخراج نفسك من المشاكل. اكتب في مربع التصفية وستضيق القائمة عبر نص الأمر ووصفه معًا، لذا فإن البحث عن "stash" أو "force" أو "undo" يُظهر الصفوف ذات الصلة فورًا. كل صف يحتوي على زر نسخ، لأن إعادة كتابة أمر يحتوي على --force-with-lease هو بالضبط كيف تحدث الأخطاء المطبعية.
يكاد كل أمر Git يصبح منطقيًا عندما تحفظ ثلاثة أماكن في ذهنك. شجرة العمل هي الملفات الموجودة على القرص كما تراها في محررك. المؤشر — الذي يُسمى أيضًا منطقة الترحيل — هو اللقطة التي تجمعها للالتزام التالي. المستودع هو السلسلة الثابتة من الالتزامات المسجلة بالفعل. ينقل git add المحتوى من شجرة العمل إلى المؤشر، ويحوّل git commit المؤشر إلى التزام جديد، ويدفع git restore المحتوى في الاتجاه المعاكس.
الفروع هي الفكرة الثانية، وهي أبسط مما تبدو: الفرع مجرد مؤشر متحرك إلى التزام واحد، وHEAD مؤشر إلى الفرع الذي أنت عليه. إنشاء فرع لا يكلف شيئًا لأنه يكتب ملفًا واحدًا يحتوي على تجزئة من أربعين حرفًا. ولهذا السبب فإن git switch -c رخيص بما يكفي لاستخدامه في تجربة مدتها خمس دقائق.
الدمج وإعادة القاعدة يجمعان عمل فرعين؛ ويختلفان فيما يسجلانه. يحافظ الدمج على التاريخين معًا ويضيف التزامًا يربطهما، وهو أمر صريح لكنه ينتج رسمًا بيانيًا مضفرًا. أما إعادة القاعدة فتعيد كتابة التزاماتك بحيث تبدو وكأنها كُتبت فوق الفرع الآخر، وهو ما ينتج خطًا مستقيمًا نظيفًا لكنه يغيّر تجزئات الالتزام — وهذا بالضبط سبب عدم إعادة قاعدة التزامات سحبها آخرون بالفعل.
أكثر معلومة مفيدة عن Git هي أنه نادرًا ما يفقد العمل الملتزم. طالما تم التزام تغيير ما في وقت ما، سيُظهر لك git reflog التجزئة، وسيعيده git switch -c rescue <hash>. تغطي شبكة الأمان هذه عمليات إعادة القاعدة الفاشلة وreset --hard العرضي بعد الالتزام والفروع المحذوفة بحماس زائد.
العمليات الخطيرة هي التي تمس العمل غير الملتزم: git reset --hard وgit checkout -- على ملف معدل وgit clean -fd. لم تُسجل أي من تلك التغييرات أبدًا، فلا يوجد ما يشير إليه reflog. العادة الجديرة بالبناء هي الالتزام مبكرًا وبشكل متكرر على فرع مؤقت، أو تشغيل git stash push قبل أي تجربة. الالتزام الذي تسحقه لاحقًا لا يكلف شيئًا؛ أما فترة بعد الظهر من العمل غير الملتزم فلا تعود.
على الفروع المشتركة، فضّل git revert على إعادة كتابة التاريخ. فهو يسجل التزامًا جديدًا يعكس الالتزام القديم، لذا تبقى نسخة أي شخص آخر صالحة. احتفظ بـ --force-with-lease لفروع ميزاتك الخاصة، ولاحظ أنه أكثر أمانًا بشكل ملموس من --force العادي: فهو يرفض العمل إذا تحرك الفرع البعيد منذ آخر مرة جلبته، وهو بالضبط الحالة التي قد يدمر فيها الدفع القسري العادي التزامات زميل بصمت.