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

آموزش گیت - دنبال کردن شاخه‌ها

در Git، یک tracking branch یک شاخه محلی است که برای دنبال کردن وضعیت یک شاخه در مخزن ریموت (remote) تنظیم می‌شود. وقتی یک شاخه محلی یک شاخه ریموت را دنبال می‌کند، Git به شما اجازه می‌دهد این دو شاخه را به‌راحتی همگام‌سازی کنید.

از دستورهای ساده‌ای مثل git pull و git push استفاده کنید تا تغییرات را از شاخه ریموت بگیرید یا تغییرات خود را به آن بفرستید، بدون اینکه هر بار مجبور باشید شاخه ریموت را به‌طور صریح مشخص کنید.

وقتی یک شاخه در حال دنبال کردن یک شاخه ریموت باشد، Git همچنین به شما اطلاع می‌دهد که شاخه محلی‌تان از شاخه ریموت جلوتر (ahead) است یا عقب‌تر (behind). این کار مدیریت جریان تغییرات و حفظ یک کدبیس به‌روز را آسان‌تر می‌کند.

نحوه کارکرد دنبال کردن شاخه‌ها

وقتی برای اولین بار یک شاخه محلی را به یک مخزن ریموت push می‌کنید، Git به‌طور خودکار یک رابطه دنبال‌کردن بین شاخه محلی و شاخه ریموت برقرار می‌کند. شاخه ریموت اغلب با نام origin/branch-name شناخته می‌شود که در آن origin نام مستعار پیش‌فرض برای مخزن ریموت است.

برای مثال:

  • شما یک شاخه جدید به نام feature-branch در سیستم محلی خود ایجاد می‌کنید.

  • این شاخه را با استفاده از دستور git push origin feature-branch به مخزن ریموت push می‌کنید.

  • Git شاخه feature-branch را طوری تنظیم می‌کند که origin/feature-branch را دنبال کند.

از این نقطه به بعد، Git می‌داند که feature-branch در سیستم محلی متناظر با origin/feature-branch در مخزن ریموت است.

تنظیم یک Tracking Branch

ما می‌توانیم هنگام ساخت یک شاخه محلی جدید یا زمانی که می‌خواهیم بین یک شاخه محلی موجود و یک شاخه ریموت ارتباط برقرار کنیم، دنبال کردن شاخه را به‌طور صریح تنظیم کنیم. بیایید ببینیم در سناریوهای مختلف چگونه می‌توان یک tracking branch تنظیم کرد:

ساخت یک Tracking Branch جدید

هنگام ساخت یک شاخه جدید، می‌توانیم آن را طوری تنظیم کنیم که یک شاخه ریموت را دنبال کند؛ برای این کار از گزینه -u یا --set-upstream-to همراه با دستور git branch یا git checkout استفاده می‌کنیم.

git checkout -b feature-branch
git push -u origin feature-branch

در این مثال:

  • گزینه -b یک شاخه جدید به نام feature-branch می‌سازد.

  • گزینه -u همراه با git push، شاخه feature-branch را برای دنبال کردن origin/feature-branch تنظیم می‌کند.

  • از این نقطه به بعد، git pull و git push به‌طور خودکار تغییرات را بین شاخه‌های محلی و ریموت همگام می‌کنند.

دنبال کردن یک شاخه موجود

برای برقراری ارتباط دنبال‌کردن بین یک شاخه موجود و یک شاخه ریموت، می‌توانید از دستور زیر استفاده کنید:

 git branch --set-upstream-to=origin/feature-branch feature-branch

این کار رابطه دنبال‌کردن را بین شاخه محلی feature-branch و شاخه ریموت origin/feature-branch برقرار می‌کند. اکنون می‌توانیم بدون نیاز به مشخص کردن شاخه ریموت در هر بار، تغییرات را به‌راحتی pull و push کنیم.

کلون کردن یک مخزن و دنبال کردن شاخه‌ها

وقتی یک مخزن ریموت را با استفاده از git clone کلون می‌کنید، Git به‌طور خودکار دنبال کردن شاخه پیش‌فرض (معمولاً main یا master) را تنظیم می‌کند. برای مثال، پس از کلون کردن یک مخزن، شاخه محلی main به‌طور خودکار origin/main را دنبال خواهد کرد.

git clone https://github.com/user/repository.git

بررسی وضعیت دنبال کردن شاخه‌ها

ما می‌توانیم روابط دنبال‌کردن فعلی بین شاخه‌های محلی و ریموت را با استفاده از چند دستور Git مشاهده کنیم.

مشاهده همه شاخه‌ها و وضعیت دنبال کردن آن‌ها

برای اینکه ببینید کدام شاخه‌های محلی در حال دنبال کردن شاخه‌های ریموت هستند، همراه با وضعیت همگام‌سازی آن‌ها، از گزینه -vv با دستور git branch استفاده کنید:

git branch -vv

این دستور همه شاخه‌های محلی را فهرست می‌کند و نشان می‌دهد که هر کدام در حال دنبال کردن کدام شاخه ریموت هستند. همچنین مشخص می‌کند که شاخه از شاخه ریموت جلوتر است یا عقب‌تر. برای مثال، ممکن است خروجی‌ای شبیه به این ببینیم:

  * main  123abc [origin/main: behind 2] Latest commit message
  feature-branch 456def [origin/feature-branch: ahead 1] Another commit message

این خروجی به شما می‌گوید:

  • شاخه main دو کامیت از origin/main عقب‌تر است.

  • شاخه feature-branch یک کامیت از origin/feature-branch جلوتر است.

مشاهده وضعیت دنبال کردن یک شاخه خاص

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

git status

Git پیامی نمایش می‌دهد که نشان می‌دهد شاخه شما در حال دنبال کردن یک شاخه ریموت هست یا نه، و اینکه جلوتر، عقب‌تر یا به‌روز است.

همگام‌سازی با Tracking Branchها

وقتی یک شاخه در حال دنبال کردن یک شاخه ریموت باشد، Git همگام‌سازی تغییرات بین این دو را با دستورهای git pull و git push آسان می‌کند

عیب‌یابی مشکلات دنبال کردن شاخه‌ها

چند مشکل رایج وجود دارد که ممکن است هنگام کار با tracking branchها با آن‌ها مواجه شوید، اما حل آن‌ها معمولاً ساده است.

خطای: نبود اطلاعات دنبال کردن

اگر سعی کنیم git pull یا git push را روی شاخه‌ای اجرا کنیم که برای دنبال کردن یک شاخه ریموت تنظیم نشده است، ممکن است خطایی شبیه به این ببینیم:

fatal: The current branch feature-branch has no upstream branch.

برای رفع این مشکل، می‌توانیم شاخه بالادستی (upstream) را با استفاده از گزینه --set-upstream-to تنظیم کنیم:

git branch --set-upstream-to=origin/feature-branch

به‌طور جایگزین، می‌توانیم هنگام push کردن برای اولین بار، شاخه بالادستی را با استفاده از گزینه -u تنظیم کنیم:

git push -u origin feature-branch

وضعیت جلوتر/عقب‌تر بودن

اگر Git به ما بگوید که شاخه نسبت به شاخه ریموت «جلوتر» (ahead) یا «عقب‌تر» (behind) است، به این معناست که در یکی از شاخه‌ها کامیت‌هایی وجود دارد که در شاخه دیگر نیست. می‌توانیم این موضوع را با اجرای git pull برای دریافت و ادغام تغییرات از شاخه ریموت یا git push برای بارگذاری کامیت‌های محلی خود در شاخه ریموت برطرف کنیم.

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