فصل 2 شاخه‌بندی در گیت درس 6 از 12

آموزش گیت - مدیریت شاخه‌ها

در فصل‌های قبلی یاد گرفتیم که چگونه شاخه‌ها را اضافه و حذف کنیم؛ این فصل به مدیریت شاخه‌ها می‌پردازد.

دستور git branch کاربردهایی فراتر از صرفاً اضافه و حذف کردن شاخه‌ها دارد.

اجرای git branch بدون آرگومان، همه شاخه‌های فعلی مخزن را زمانی که بدون هیچ آرگومانی فراخوانی شود، نمایش می‌دهد:

$ git branch
  auth-module
- master
  feature-x

شاخه‌ای که هم‌اکنون در حالت checkout قرار دارد (یعنی جایی که HEAD به آن اشاره می‌کند) با یک علامت ستاره (*) مشخص می‌شود.

کامیت‌های این وضعیت، شاخه چک‌اوت‌شده را به جلو می‌برند.

آخرین کامیت شاخه

از git branch -v برای دیدن جدیدترین کامیت هر شاخه استفاده کنید.

$ git branch -v
  auth-module  abcd123 Latest commit on auth-module
- master       7a1b2c3d Latest commit on master
  feature-x    e4f5g6h7 Latest commit on feature-x

فیلتر کردن شاخه‌ها

با دستور git branch می‌توانیم از آرگومان‌های --merged و --no-merged استفاده کنیم تا فهرست شاخه‌ها را بر اساس اینکه در شاخه فعلی ادغام شده‌اند یا نه، فیلتر کنیم.

برای مثال، می‌توانیم دستور زیر را اجرا کنیم تا بفهمیم کدام شاخه‌ها پیش‌تر در شاخه master که هم‌اکنون در آن هستیم، ادغام شده‌اند:

$ git branch --merged
  auth-module
- master
  • از git branch --merged استفاده کنید تا auth-module را پس از ادغام آن در شاخه اصلی (master)، در میان شاخه‌هایی که قبلاً ادغام شده‌اند ببینید.

  • با استفاده از git branch -d می‌توانیم شاخه‌هایی را که بدون نماد * (ستاره) فهرست شده‌اند، با خیال راحت حذف کنیم.

  • این نشان می‌دهد که تغییرات آن‌ها پیش‌تر در شاخه دیگری وارد شده است و تضمین می‌کند که با حذف شدنشان هیچ کاری از بین نمی‌رود.

از git branch --no-merged برای دیدن شاخه‌هایی استفاده کنید که هنوز کارهایی در آن‌ها وجود دارد که در شاخه فعلی ادغام نشده‌اند. به‌عنوان مثال:

$ git branch --no-merged
  feature-x

این دستور شاخه‌هایی با تغییرات ادغام‌نشده، مانند feature-x را نمایش می‌دهد. چنین شاخه‌ای را نمی‌توان با git branch -d حذف کرد زیرا خطایی مبنی بر اینکه شاخه به‌طور کامل ادغام نشده است ظاهر می‌شود.

$ git branch -d feature-x
error: The branch 'feature-x' is not fully merged.
If you are sure you want to delete it, run 'git branch -D feature-x'

از git branch -D feature-x برای حذف اجباری چنین شاخه‌ای استفاده کنید تا مطمئن شوید همه تغییرات برای همیشه از بین می‌روند.

تغییر نام یک شاخه

برای تغییر نام یک شاخه، مثلاً تغییر نام شاخه‌ای به نام fix-typos به typo-fixes در حالی که کل تاریخچه آن بدون تغییر بماند، از git branch --move استفاده کنید. این کار نام شاخه را به‌صورت محلی تغییر می‌دهد:

$ git branch --move fix-typos typo-fixes

Fix-typos در مخزن محلی ما اکنون typo-fixes نام دارد.

برای به‌روزرسانی مخزن ریموت، شاخه تغییرنام‌یافته را push کنید:

$ git push --set-upstream origin typo-fixes

نام شاخه جدید یعنی typo-fixes با این دستور در مخزن ریموت به‌روزرسانی می‌شود.

نام شاخه‌ها را هم به‌صورت محلی و هم در ریموت بررسی کنید:

$ git branch --all
- typo-fixes
  main
  remotes/origin/fix-typos
  remotes/origin/typo-fixes
  remotes/origin/main

شاخه‌ای که هم‌اکنون به‌صورت محلی روی آن کار می‌کنیم typo-fixes است که از مخزن ریموت نیز در دسترس است.

در ریموت، شاخه fix-typos هنوز با نام قبلی فهرست شده است. نام قبلی شاخه را از ریموت به شکل زیر حذف کنید:

  $ git push origin --delete fix-typos

با این دستور، نام شاخه قبلی یعنی fix-typos از مخزن ریموت حذف می‌شود و فقط typo-fixes باقی می‌ماند.

اکنون هم به‌صورت محلی و هم در مخزن ریموت، شاخه fix-typos با موفقیت به typo-fixes تغییر نام داده شده است.

تغییر نام شاخه master

از مراحل زیر برای به‌روزرسانی شاخه محلی master خود در مخزن ریموت و تغییر نام آن به feature-new استفاده کنید:

از git branch --move برای تغییر نام شاخه محلی استفاده کنید:

  $ git branch --move master feature-new

دستور بالا شاخه محلی master را به feature-new تغییر نام می‌دهد.

برای به‌روزرسانی مخزن ریموت، شاخه تغییرنام‌یافته را push کنید:

  $ git push --set-upstream origin feature-new

با شاخه جدید feature-new، مخزن ریموت به‌روزرسانی می‌شود.

از دستور زیر برای بررسی نام شاخه‌ها هم به‌صورت محلی و هم در ریموت استفاده کنید:

  $ git branch --all
- feature-new
  remotes/origin/HEAD -> origin/master
  remotes/origin/feature-new
  remotes/origin/master
  • شاخه محلی فعلی ما اکنون feature-new نام دارد و در مخزن ریموت نیز وجود دارد.

  • با این حال در ریموت، نام شاخه قبلی یعنی master همچنان وجود دارد.

  • پس از به‌روزرسانی آن در ریموت و تغییر نام شاخه محلی master ما به feature-new.

  • سایر همکاران هنوز مجازند از شاخه قبلی master استفاده کنند.

  • برای تکمیل این انتقال، کارهای دیگری نیز باید انجام دهیم. این کارها شامل ادغام و بستن درخواست‌های کششی (pull request) معطوف به شاخه قدیمی و همچنین ارتقای وابستگی‌ها، پیکربندی‌ها، اسکریپت‌ها، تنظیمات میزبان مخزن و ارجاع‌های مستندات است.

  • وقتی همه کارهای لازم انجام شد و مطمئن شدیم که شاخه feature-new دقیقاً مانند شاخه قبلی master کار می‌کند، می‌توانیم شاخه master را با خیال راحت حذف کنیم.

از دستور زیر برای حذف نام قبلی شاخه از ریموت استفاده کنید:

  $ git push origin --delete master

شاخه master مخزن ریموت حذف می‌شود و تنها feature-new باقی می‌ماند.

شاخه master اکنون هم در مخزن ریموت و هم به‌صورت محلی با موفقیت به feature-new تغییر نام داده شده است.

پیشرفت مطالعه: وضعیت خوانده‌شدن این درس فقط در همین مرورگر ذخیره می‌شود؛ بدون نیاز به حساب کاربری.