git cherry-pick دستور گیت برای کپی کردن یک یا چند کامیت مشخص از یک برنچ به برنچ دیگر است؛ بدون ادغام کل تاریخچه. خلاصه اجرا: به برنچ مقصد بروید و کامیت مورد نظر را اعمال کنید. مثلا: checkout به release و سپس cherry-pick شناسه کامیت. با این کار همان تغییرات، به صورت یک کامیت جدید در مقصد ساخته می‌شود.

چه زمانی cherry-pick بهترین انتخاب است؟

  • بک‌پورت یا هات‌فیکس: یک اصلاح کوچک را از main به release پایدار منتقل کنید، بی‌آنکه همه تغییرات اخیر main را بیاورید.
  • برداشتن بخشی از یک PR بزرگ: فقط کامیت‌های آماده و مستقل را به برنچ دیگری ببرید.
  • استخراج یک بهبود کوچک: مثل اصلاح تایپو یا تنظیمات CI که به چند برنچ نیاز است.
  • بازگردانی هدفمند: اگر کامیتی را در یک برنچ revert کرده‌اید و همان بازگردانی را در برنچ دیگر لازم دارید، می‌توانید همان revert را cherry-pick کنید.

پیش‌نیاز و آماده‌سازی مخزن

  • گیت نصب باشد و مخزن را کلون کرده باشید.
  • شاخص و ورکینگ‌تری تمیز باشد تا وسط کار با تداخل تغییرات ذخیره‌نشده روبرو نشوید:
    git status
    

    اگر تغییرات محلی دارید، ابتدا کامیت، استش یا دیسکارد کنید.

  • در صورت نیاز از ریموت آخرین تغییرات را بگیرید:
    git fetch origin
    

مراحل اجرا با یک مثال عملی

سناریو: یک باگ را در برنچ feature-xyz با کامیت دارای شناسه abc1234 اصلاح کرده‌اید. می‌خواهید همان اصلاح را به برنچ release/1.2 هم ببرید.

  1. به برنچ مقصد بروید:
    git checkout release/1.2
    
  2. کامیت را اعمال کنید:
    git cherry-pick abc1234
    

    اگر کانفلیکت نداشتید، یک کامیت جدید با همان تغییرات (و پیام مشابه) روی release/1.2 ساخته می‌شود.

  3. تایید نتیجه:
    git log --oneline -1
    git show
    
  4. پوش به ریموت:
    git push origin release/1.2
    

چند کامیت یا یک بازه را cherry-pick کنیم

  • چند شناسه جدا:
    git cherry-pick <hash1> <hash2> <hash3>
    
  • به ترتیب پشت سر هم (رنج):
    # همه کامیت‌های در B و خارج از A
    git cherry-pick A..B
    
    # اگر می‌خواهید A هم شامل شود:
    git cherry-pick A^..B   # یا A~1..B
    

    توجه: A..B یعنی «کامیت‌های قابل دستیابی از B که در A نیستند». اگر خود A را هم می‌خواهید، از A^..B استفاده کنید.

  • اعمال بدون ساختن کامیت (برای اسکوآش چند کامیت در یک کامیت):
    git cherry-pick -n <hash1> <hash2>
    # اکنون همه تغییرات staged است؛ در یک کامیت یکجا ثبت کنید:
    git commit -m "Backport: fix X and tweak Y"
    

مدیریت کانفلیکت در cherry-pick

اگر تداخل پیش آمد، گیت متوقف می‌شود تا شما حل کنید. روند کلی:

  1. فایل‌های در کانفلیکت را باز کنید و نشانه‌های <<<<<< و ======= و >>>>>> را برطرف کنید.
  2. بعد از حل هر فایل:
    git add <file>
    
  3. ادامه فرایند:
    git cherry-pick --continue
    
  4. اگر منصرف شدید:
    git cherry-pick --abort
    
  5. اگر می‌خواهید از کامیت مشکل‌دار صرف نظر کنید و سراغ بعدی بروید:
    git cherry-pick --skip
    

انتخاب استراتژی برای حل خودکار برخی تعارض‌ها ممکن است مفید باشد:

  • ترجیح تغییرات برنچ مقصد هنگام تعارض:
    git cherry-pick -X ours <hash>
    
  • ترجیح تغییرات کامیت ورودی (being picked):
    git cherry-pick -X theirs <hash>
    

هشدار: -X ours/theirs فقط در مواردی استفاده کنید که از پیامدهای رها کردن یک سمت تعارض مطمئنید.

سوییچ‌های مفید و نکات حرفه‌ای

  • -e یا –edit: ویرایش پیام کامیت هنگام cherry-pick.
  • -x: افزودن خطی با «(cherry picked from commit …)» به انتهای پیام برای ردیابی منشأ.
    git cherry-pick -x <hash>
    
  • -s یا –signoff: افزودن امضای DCO به پیام کامیت.
  • -S: امضای GPG در صورت پیکربندی.
  • -m N: زمانی که می‌خواهید یک merge commit را cherry-pick کنید، باید مشخص کنید parent اصلی کدام است:
    git cherry-pick -m 1 <merge-hash>
    

    استفاده از -m بدون درک ساختار merge می‌تواند نتیجه غیرمنتظره بدهد؛ در صورت امکان به جای cherry-pick کردن merge، کامیت‌های ساده داخل آن را انتخاب کنید.

  • اگر تغییر شما به چند کامیت قبلی وابسته است، همه وابستگی‌ها را هم بیاورید؛ در غیر این صورت ممکن است پروژه نسازد یا تست‌ها بشکنند.

تایید اینکه cherry-pick درست اعمال شده است

  • آخرین کامیت‌ها را ببینید:
    git log --oneline -5
    
  • مقایسه تغییر تازه با والدش:
    git diff HEAD^..HEAD
    
  • اگر همان تغییر قبلا با patch مشابه در مقصد اعمال شده باشد، گیت معمولا آن را تشخیص می‌دهد. می‌توانید با مقایسه پچ‌ها یا استفاده از:
    # مقایسه تفاوت‌های مقصد با منبع (نمونه)
    git cherry -v origin/release/1.2 origin/main
    

    بررسی کنید کدام پچ‌ها هنوز وارد نشده‌اند.

تفاوت cherry-pick با Merge و Rebase در یک نگاه

cherry-pick فقط تغییرات یک یا چند کامیت مشخص را کپی می‌کند و یک کامیت جدید می‌سازد. merge تاریخچه دو برنچ را با هم ادغام می‌کند. rebase تاریخچه را بازنویسی می‌کند تا روی یک پایه جدید قرار گیرد. برای عمق بیشتر درباره انتخاب بین ادغام‌ها، این مطلب را ببینید: تفاوت Rebase و Merge.

هدفcherry-pickmergerebase
دامنه تغییرکامیت‌های انتخابیکل انشعاببازچینی تاریخچه یک انشعاب
اثر بر تاریخچهکامیت‌های جدید با محتوا معادلایجاد merge commit (معمولا)هش‌های جدید برای کامیت‌های جابجا شده

اشتباهات رایج و راه پیشگیری

  • cherry-pick کردن merge commit بدون -m: نتیجه ممکن است ناقص یا پر از تعارض باشد. بهتر است کامیت‌های معمولی داخل merge را انتخاب کنید.
  • برداشتن فقط بخشی از تغییر وابسته: اگر کامیت انتخابی به تغییرات قبلی تکیه دارد، آن‌ها را هم بیاورید یا در مقصد معادل‌سازی کنید.
  • تکرار بی‌مورد cherry-pick: وقتی بعدا برنچ منبع را merge می‌کنید، پچ‌های معادل معمولا دوباره اعمال نمی‌شوند؛ اما ممکن است تعارض‌های غیرضروری بسازند. قبل از cherry-pick بررسی کنید که ادغام کامل در آینده نزدیک برنامه‌ریزی نشده یا اثرش را می‌دانید.
  • کار روی ورکینگ‌تری کثیف: با git status مطمئن شوید چیزی نیمه‌کاره نیست.
  • استفاده از cherry-pick برای «بازگردانی» در همان برنچ: اگر قصد خنثی کردن یک کامیت در همان تاریخچه را دارید، git revert انتخاب درست‌تری است.

چک‌لیست کوتاه اجرا

  1. git fetch و git status
  2. git checkout برنچ مقصد
  3. شناسایی هش/رنج کامیت‌ها (با git log –oneline)
  4. git cherry-pick [گزینه‌ها] شناسه‌ها
  5. حل تعارض‌ها و –continue (در صورت نیاز)
  6. بازبینی با log/show/diff
  7. push به ریموت

ارتقای جریان کاری

برای کاهش ورود کدهای مشکل‌دار که بعدا مجبور به cherry-pick یا revert می‌شوند، بررسی خودکار قبل از کامیت کمک بزرگی است. راهنمای راه‌اندازی آن را در راه اندازی pre-commit hooks ببینید.

اگر به دنبال یافتن سریع کامیت خراب برای بازگردانی هدفمند هستید، آموزش Git Bisect روند کشف را بهینه می‌کند.

گام بعدی یادگیری

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

نتیجه نهایی: وقتی تنها به یک تغییر مشخص نیاز دارید، git cherry-pick سریع‌ترین و تمیزترین مسیر است. با شناخت وابستگی‌ها، مدیریت کانفلیکت و گزینه‌های کلیدی، آن را با اطمینان در چرخه کاری خود به کار بگیرید.