Git: تعيين فرع upstream
آخر تحديث
إن upstream الخاص بفرع ما هو الفرع البعيد الذي يتتبّعه. بمجرد تعيينه، يعرف الأمران البسيطان git push و git pull إلى أين يُرسِلان الكوميتات ومن أين يجلبانها دون أن تُسمّي المستودع البعيد والفرع في كل مرة. عادةً ما تعيّنه في أول push باستخدام -u، أو لاحقًا باستخدام git branch --set-upstream-to.
جرّب هذه الأوامر في ساحة الطرفية - صدفة حقيقية داخل متصفحك، دون الحاجة إلى تثبيت أي شيء.
الصيغة
| Command | What it does |
|---|---|
git push -u origin feature | يقوم بالـ push ويعيّن upstream في خطوة واحدة |
git branch --set-upstream-to=origin/feature | يعيّن upstream للفرع الحالي |
git branch -u origin/feature feature | يعيّن upstream لفرع مُسمّى |
git branch -vv | يعرض كل فرع و upstream الخاص به |
الحالات الشائعة
| Goal | Command |
|---|---|
| تعيين upstream عند أول push | git push -u origin feature |
| تعيين upstream لفرع موجود مسبقًا | git branch --set-upstream-to=origin/feature |
| التحقق من upstream المُعيَّن | git branch -vv |
الأسئلة الشائعة حول git set upstream
ماذا يفعل تعيين فرع upstream؟
يربط فرعك المحلي بفرع بعيد محدّد. بعد ذلك، يعرف الأمران
git push و git pull على ذلك الفرع أي مستودع بعيد وأي فرع يستخدمان، فيمكنك تشغيلهما دون وسائط. كما يُظهر Git مدى تقدّمك أو تأخّرك عن upstream في git status.كيف أعيّن فرع upstream؟
أسهل طريقة هي عند أول push: يقوم
git push -u origin <branch> بالـ push وتعيين upstream في آنٍ واحد. أما بالنسبة لفرع موجود بالفعل على المستودع البعيد، فاستخدم git branch --set-upstream-to=origin/<branch> وأنت على ذلك الفرع.كيف أرى upstream الخاص بفرع ما؟
شغّل
git branch -vv. يسرد فروعك المحلية، كلٌّ منها مُشار إليه مع upstream الخاص به (مثل [origin/feature]) وما إذا كان متقدّمًا أو متأخّرًا. الفروع التي ليس لها upstream لا تُظهر شيئًا بين الأقواس المربّعة.لماذا يطلب مني git push تعيين upstream؟
لأن الفرع الحالي ليس له upstream مُهيّأ، لذا لا يعرف Git إلى أين يقوم بالـ push. شغّل
git push -u origin <branch> مرة واحدة لتعيينه؛ ولن تحتاج عمليات الـ push اللاحقة إلا إلى git push.هل يمكنني التدرّب على هذا عبر الإنترنت؟
نعم. افتح ساحة الطرفية لتشغيل هذه الأوامر في صدفة حقيقية داخل متصفحك - دون الحاجة إلى تثبيت أي شيء. كما تغطّي دورة Git التفاعلية المجانية من Coddy التعامل مع المستودعات البعيدة خطوة بخطوة.