Git

Git في شريط اللوحة#

عندما تكون اللوحة داخل مستودع، يعرض شريطها العلوي الفرع الحالي، وعدد الإيداعات المتقدمة (↑) والمتأخرة (↓)، وعدد الملفات المتغيّرة. وبجوار ذلك:

اسم الفرع

يفتح قائمة الفروع: الفروع المحلية أولًا، ثم الفروع الموجودة على البعيد فقط. انقر على فرع (أو اضغط Enter) للتبديل إليه. اكتب اسمًا غير موجود واضغط Enter لإنشاء الفرع والتبديل إليه. الفروع المسحوبة في worktree آخر مميَّزة ولا يمكن اختيارها.

Diff

يفتح التغييرات غير المودَعة لمجلد هذه اللوحة دون فتح نافذة Git.

Worktree

ينشئ worktree لهذا المستودع. راجع الـ Worktrees.

Commit

يفتح حالة الملفات في نافذة Git مع التركيز على مربع الرسالة.

Fetch / Pull / Push

يُبرَز Pull عندما يكون هناك ما يمكن سحبه. إذا لم يكن هناك upstream، يسحب من الفرع الافتراضي للبعيد (مثل origin/main)؛ ويذكر التلميح المصدر. ويظهر Push عندما تكون لديك إيداعات لم تُدفع.

نافذة Git#

انقر Git في شريط الأدوات أو اضغط Cmd/Ctrl+E لفتح نافذة Git لمستودع الطرفية المركّز عليها. تعرض شارة شريط الأدوات عدد الملفات المتغيّرة. أغلقها بـ Esc أو بزر × أو بـ Cmd/Ctrl+E مرة أخرى. اسحب حوافها لتغيير حجمها، وانقر نقرًا مزدوجًا على مقبض لإعادته.

يتنقل الجانب الأيسر بين حالة الملفات والسجل وبحث والـ worktrees والـ issues وطلبات السحب، ويسرد الفروع (مجمّعة في مجلدات حسب /) والمستودعات البعيدة والوسوم. انقر على مرجع لعرض الإيداع الخاص به في السجل، وانقر نقرًا مزدوجًا على فرع لسحبه (checkout).

مراجعة التغييرات وإيداعها#

1. افتح نافذة Git. تبدأ على حالة الملفات، وتسرد كل ملف غير مودَع مع حالته وعدد أسطره.
2. انقر على ملف لرؤية الـ diff الخاص به مرقّم الأسطر. ألغِ تحديد الملفات التي لا تريدها في هذا الإيداع.
3. اكتب رسالة في رسالة الإيداع. حدّد الدفع بعد الإيداع للدفع فورًا.
4. اضغط Commit أو Cmd/Ctrl+Enter.

يفتح كل التغييرات diff شجرة العمل كاملًا في عارض أكبر. تلتف الأسطر الطويلة هناك، ويمكنك سحب حافة قائمة الملفات لتوسيعها.

تصفّح السجل#

يرسم السجل مخطط الإيداعات عبر كل الفروع والوسوم المحلية والبعيدة. حدّد إيداعًا لرؤية ملفاته والـ patch الخاص به في الأسفل. ويصفّي بحث حسب الرسالة أو المؤلف أو الـ hash.

انقر بزر الفأرة الأيمن على إيداع ← الرجوع إلى هذا الإيداع... لإعادة الفرع إليه. تخرج الإيداعات اللاحقة من السجل الحالي وتُتجاهل التغييرات غير المودَعة في الملفات المتتبَّعة (تبقى الملفات غير المتتبَّعة)، لذا يُطلب منك التأكيد أولًا.

Pull وPush وFetch وStash#

Pull

اختر الفرع البعيد الذي تريد سحبه إلى الفرع الحالي، دون تبديل الفروع.

Push

يدفع الفرع الحالي ويضبط الـ upstream الخاص به عند أول دفع.

Fetch

يجلب التحديثات من كل المستودعات البعيدة.

Stash

يخزّن التغييرات مؤقتًا، بما في ذلك الملفات غير المتتبَّعة (git stash push -u).

عندما يتعذّر تشغيل Git#

إذا منع جهازك git من العمل، يوضّح PATerminal السبب ويعرض الإصلاح في سطر واحد، مع اكتب في الطرفية لإدراجه (وتضغط أنت Enter) أو نسخ. وهو يتعرّف على: ترخيص Xcode غير مقبول، وغياب Command Line Tools، وعدم تثبيت Git، ومجلد يملكه مستخدم آخر («dubious ownership»)، وحدود المسارات الطويلة في Windows.