فصل 3 عملیات‌های گیت درس 9 از 16

آموزش گیت - عملیات Pull

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

دستور git pull مطمئن می‌شود که نسخه محلی ما همیشه با تغییرات ایجادشده در مخزن ریموت به‌روز است و جدیدترین موارد اضافه‌شده از مخزن ریموت را شامل می‌شود.

با همگام نگه‌داشتن نسخه‌های محلی و ریموت، می‌توانیم از اختلاف‌های احتمالی در تاریخچه نسخه‌های پروژه خود جلوگیری کنیم.

چه کاری انجام می‌دهد؟

Fetch − آخرین تغییرات را از مخزن ریموت دریافت می‌کند.

Merge − آخرین تغییرات را در شاخه فعلی ادغام می‌کند.

مرور کلی

  • به‌روزرسانی‌های یک مخزن ریموت از طریق دستور Git pull در شاخه فعلی ادغام می‌شوند.

  • به‌طور پیش‌فرض، اگر شاخه فعلی از شاخه ریموت عقب‌تر باشد، آن را به‌صورت fast-forward جلو می‌برد تا با ریموت هم‌راستا شود.

  • اگر شاخه فعلی و ریموت از هم جدا شده باشند، برای همگام‌سازی و آشتی دادن آن‌ها لازم است گزینه‌هایی مانند --rebase یا --no-rebase را مشخص کنید (یا pull.rebase را پیکربندی کنید).

  • برای دریافت تغییرات ریموت، git pull ابتدا git fetch را با پارامترهای داده شده اجرا می‌کند.

  • به‌طور پیش‌فرض، git pull سپس بسته به پیکربندی یا پرچم‌ها، git rebase یا git merge را برای حل اختلاف بین شاخه‌ها انجام می‌دهد.

نحو نگارش

git pull [<remote>] [<branch>]

<remote> نام مخزن ریموت است.

<branch> نام شاخه محلی است.

نحوه استفاده

از دستور git pull می‌توان به روش‌های زیر استفاده کرد:

pull پایه

تغییرات از شاخه ریموت ردیابی‌شده را می‌توان دریافت و در شاخه فعلی ادغام کرد.

git pull

pull از ریموت و شاخه مشخص

تغییرات از شاخه main در ریموت origin را می‌توان دریافت و در شاخه فعلی ادغام کرد.

git pull origin main

تعارض‌ها در برابر ادغام Fast-forward

در صورتی که شاخه شما از شاخه ریموت جلوتر باشد، می‌توان یک ادغام fast-forward انجام داد، اما ممکن است تعارض‌هایی وجود داشته باشد که نیاز به حل دستی دارند.

Rebase به‌جای merge

با استفاده از pull همراه با rebase می‌توانید تغییرات خود را روی تغییرات ریموت اعمال کنید. این کار تاریخچه را تمیزتر نگه می‌دارد.

git pull --rebase

گزینه‌ها

دستور git pull گزینه‌های زیر را دارد:

--ff-only

تغییرات فقط به‌صورت fast-forward جلو برده می‌شوند. در صورتی که نیاز به ادغام باشد، عملیات pull لغو می‌شود تا از ایجاد commitهای ادغامی جلوگیری شود.

git pull --ff-only

--no-ff

حتی زمانی که امکان fast-forward وجود داشته باشد، ایجاد یک commit ادغامی را اجباری می‌کند.

git pull --force

--rebase

دستور git pull --rebase تغییرات محلی را روی تغییرات دریافت‌شده اعمال می‌کند. این کار به حفظ تاریخچه commitها به‌صورت خطی‌تر و تمیزتر کمک می‌کند.

git pull --rebase

--no-rebase

انجام ادغام را تضمین می‌کند و از rebase کردن جلوگیری می‌کند.

git pull --no-rebase

--quiet or -q

  • از دستور git reset معمولاً برای مدیریت شاخه ردیابی ریموت استفاده می‌شود که می‌تواند با تغییرات شاخه فعلی ما بازنویسی شود.

git pull --quiet

--verbose

  • دستور git pull --verbose جزئیات اطلاعات تغییرات دریافت‌شده و ادغام‌شده را نمایش می‌دهد.

git pull --verbose

--autostash

  • دستور git pull --autostash تغییرات محلی را پیش از اجرای git pull به‌طور خودکار stash می‌کند و پس از پایان pull، تغییرات را اعمال می‌کند.

git pull --autostash

--no-edit

  • دستور git pull --no-edit در صورت وقوع ادغام، ویرایشگر پیام commit را برای commit ادغامی رد می‌کند.

git pull --no-edit

--all

برای دریافت تغییرات از تمام مخازن ریموت متصل به مخزن محلی ما، از دستور git pull --all استفاده می‌شود.

git pull -- all

برای دریافت تغییرات از تمام مخازن ریموت متصل به مخزن محلی ما، از دستور git pull --all استفاده می‌شود.

  • این گزینه هنگام مدیریت چندین ریموت مفید است؛ برای مثال هنگام همکاری در مخازن مختلف یا کار با یک مخزن forkشده، سودمند است.

  • این دستور مطمئن می‌شود که تمام تغییرات ریموت در مخزن محلی ما منعکس شوند و به همگام‌سازی و همکاری کمک می‌کند.

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

--strategy=<strategy>

دستور git pull --strategy=<strategy> استراتژی ادغام قابل استفاده را مشخص می‌کند. چند مورد از استراتژی‌های رایج:

  • recursive − استراتژی پیش‌فرض آن است که یک فرایند سه‌طرفه است.

  • ours − نسخه شما از محتوا را نگه می‌دارد.

  • theirs − از نسخه ریموت محتوا استفاده می‌کند.

git pull --strategy=recursive

استفاده از چند گزینه هم‌زمان

از دستور git pull همچنین می‌توان با چند گزینه به‌صورت هم‌زمان در یک دستور واحد استفاده کرد.

git pull --rebase --autostash --verbose

دستور بالا هر سه عملیات را در یک دستور واحد انجام می‌دهد؛ یعنی دریافت تغییرات همراه با rebase، ذخیره موقت (stash) تغییرات commitنشده، و ارائه خروجی تفصیلی از تغییرات.

این یک روش مناسب است که پیش از اجرای git pull مطمئن شوید دایرکتوری کاری شما تمیز است. این موضوع را می‌توان با دستور git status بررسی کرد.

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