طريقة إعادة تسمية فرع في Git محليًا وعلى المستودع البعيد

لإعادة تسمية الفرع الذي تقف عليه، نفّذ `git branch -m new-name`. ولإعادة تسمية فرع آخر، نفّذ git branch -m old-name new-name. إن كان الفرع على مستودع بعيد، فادفع الاسم الجديد باستخدام git push -u origin new-name، ثم احذف القديم باستخدام git push origin --delete old-name.

كيف أعيد تسمية فرع Git محلي؟

# the branch you are on
git branch -m feature/search-box

# any other branch
git branch -m feature/search feature/search-box

لا تتغير الإيداعات، وينقل Git سجل reflog الخاص بالفرع معه. يرفض -m استبدال فرع يحمل الاسم الجديد بالفعل. أما -M فيفرض ذلك، فلا تستخدمه إلا إذا كنت تريد التخلص من الفرع الآخر.

كيف أعيد تسمية فرع بعيد؟

لا يملك Git إعادة تسمية بعيدة. تنشر الاسم الجديد ثم تزيل القديم، بهذا الترتيب:

1. أعد تسمية الفرع المحلي: git branch -m old-name new-name
2. ادفعه واضبط الفرع البعيد: git push -u origin new-name
3. احذف الاسم القديم: git push origin --delete old-name

إن تخطيت -u فسيظل الفرع يتتبع الاسم البعيد القديم. يمكنك إصلاح ذلك لاحقًا باستخدام git branch -u origin/new-name. يشرح درس المستودعات البعيدة والتتبع ما يفعله التتبع.

ماذا يجب أن يفعل زملائي؟

ما زالت نسخهم تستخدم الاسم القديم. ينفّذ كل منهم هذا مرة واحدة:

git fetch origin --prune
git branch -m old-name new-name
git branch -u origin/new-name new-name

كيف أعيد تسمية الفرع الافتراضي؟

استخدم إعدادات منصتك لا الأوامر أعلاه، لأن الفرع الافتراضي إعداد على الخادم أيضًا، وتشير إليه طلبات السحب المفتوحة. بعد إعادة التسمية، يحدّث الجميع نسخهم كما هو موضح، ويحدّثون أيضًا الفرع الافتراضي للمستودع البعيد:

git remote set-head origin -a

لماذا تفشل إعادة التسمية بتغيير حالة الأحرف فقط؟

تعامل أنظمة ملفات كثيرة Feature وfeature كاسم واحد، ويخزّن Git الفروع عادة في صورة ملفات. مرّ عبر اسم مؤقت:

git branch -m Feature feature-tmp
git branch -m feature-tmp feature

يتضمن دليل إعادة تسمية الفروع وحذفها التفاصيل، ويغطي مقال طريقة حذف فرع تنظيف الاسم القديم.