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

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

پچ در Git

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

تفاوت‌های بین دو نسخه از یک فایل در یک پچ قرار می‌گیرند و این امکان را به توسعه‌دهندگان می‌دهد که تغییرات را بین مخزن‌ها تبادل، پیشنهاد و پیاده‌سازی کنند.

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

فایل پچ Git

فایل پچ Git سندی است که تغییرات اعمال‌شده بر یک مخزن را ثبت می‌کند. این فایل شامل فهرستی از تفاوت‌ها یا همان diffs بین دو نسخه از یک فایل یا مجموعه‌ای از فایل‌های مرتبط است.

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

  • پچ‌های Git به‌ویژه برای به اشتراک‌گذاری به‌روزرسانی‌ها بدون نیاز به یک مخزن مرکزی مفید هستند.

  • همچنین ممکن است در انتقال تغییرات بین مخزن‌ها یا شاخه‌ها کاربرد داشته باشند.

  • پچ‌های Git ریشه در برنامه patch در Unix دارند که روزگاری در سیستم‌های قدیمی Unix برای پیگیری مغایرت‌های فایل‌ها استفاده می‌شد.

ساخت فایل‌های پچ Git

برای ساخت یک فایل پچ Git از دستور git format-patch استفاده کنید.

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

مسیر مقصد که پچ‌ها باید در آن ذخیره شوند و نام شاخه، موارد مورد نیاز این دستور هستند.

git format-patch <branch> <options>

اگر دستور git format-patch را روی شاخه فعلی و بدون مشخص کردن شاخه‌ای دیگر اجرا کنید، هیچ خروجی‌ای تولید نخواهد شد.

ساخت پچ Git برای یک کامیت خاص

به‌جای ساخت پچ برای همه تغییرات شاخه، از دستور git format-patch برای ساخت پچ یک کامیت تکی استفاده کنید.

برای ساخت پچ از آخرین کامیت، از دستور زیر استفاده کنید:

git format-patch HEAD~1

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

وقتی روی یک یا دو کامیت خاص تمرکز دارید و نه همه تفاوت‌های شاخه، می‌توان از پچ‌های Git به‌جای cherry-pick استفاده کرد.

برای ساخت فایل پچ برای یک کامیت خاص، از دستور git format-patch همراه با گزینه -1 و SHA کامیت استفاده کنید:

git format-patch -1 <commit_sha>

این دستور برای کامیت مشخص‌شده یک فایل .patch تولید می‌کند.

ساخت پچ Git از چند کامیت

برای ساخت پچ از چند کامیت، بازه کامیت‌ها را با استفاده از دستور git format-patch مشخص کنید.

برای مثال، برای ساخت پچ برای چهار کامیت آخر از دستور زیر استفاده کنید:

git format-patch HEAD~4

این دستور چهار فایل .patch\ تولید می‌کند؛ یکی برای هر یک از چهار کامیت قبلی.

ساخت پچ Git از یک بازه مشخص کامیت

برای تولید پچ از یک بازه معین از کامیت‌ها، از دستور git format-patch همراه با هش کامیت شروع و پایان استفاده کنید. برای مثال:

git format-patch <start-commit-hash> <end-commit-hash>

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

اعمال یک فایل پچ

در Git، یک فایل پچ را با استفاده از دستور git apply و نام فایل پچ اعمال کنید:

git apply <patch-file-name>

با این دستور، تغییرات فایل پچ روی پوشه کاری اعمال می‌شوند.

اعمال و کامیت کردن یک فایل پچ Git

مراحل اعمال یک فایل پچ Git و ثبت کامیت برای آن به شرح زیر است:

1. انتخاب شاخه مورد نظر:

مطمئن شوید که در شاخه‌ای قرار دارید که پچ باید روی آن اعمال شود:

git checkout <branch-name>

2. اعمال پچ:

با استفاده از دستور git am، فایل پچ را اعمال کنید و یک کامیت جدید با همان پیام و فراداده‌های کامیت اصلی بسازید:

git am <patch-file-name>

3. اعمال چند فایل پچ:

با استفاده از دستور git am می‌توانیم هنگام استفاده از پچ‌ها، چندین فایل پچ را یک‌جا اعمال کنیم.

دو روش اصلی برای این کار وجود دارد:

استفاده از Wildcard: برای اعمال همه فایل‌های پچ به‌صورت یک‌جا، اگر در یک پوشه باشند و پسوند یکسانی داشته باشند (مانند .patch)، می‌توانیم از wildcard استفاده کنیم:

git am *.patch

این دستور همه فایل‌های پچ موجود در پوشه فعلی را که پسوند .patch دارند اعمال می‌کند.

فهرست کردن فایل‌ها به‌صورت تکی: اگر بخواهیم فایل پچ خاصی را اعمال کنیم، هر فایل را جداگانه بنویسید:

git am patch1.patch patch2.patch patch3.patch

این دستور فایل‌های پچ ارائه‌شده را به ترتیب فهرست‌شده اعمال می‌کند.

هر دو روش تغییرات موجود در فایل‌های پچ را اعمال کرده و کامیت‌های متناظر را در شاخه فعلی ایجاد می‌کنند.

4. حل تعارض‌ها هنگام اعمال پچ:

اگر تغییرات موجود در یک پچ نتوانند به‌درستی با کد فعلی در شاخه یکپارچه شوند، ممکن است هنگام اعمال پچ با Git تعارض (conflict) رخ دهد. روش حل این نوع تعارض‌ها به این صورت است:

5. شناسایی تعارض‌ها:

اگر Git هنگام اعمال پچ با تعارض مواجه شود، به ما هشدار خواهد داد.

فایل‌هایی که باعث تعارض می‌شوند در پوشه کاری مشخص خواهند شد.

6. حل تعارض‌ها:

تعارض‌ها را در فایل‌های آسیب‌دیده به‌صورت دستی حل کنید.

برای رفع مغایرت‌های بین پچ و کد فعلی، فایل‌ها را باز کنید و تغییرات لازم را انجام دهید.

7. علامت‌گذاری تعارض‌ها به‌عنوان حل‌شده:

برای مرحله‌سازی (stage) فایل‌هایی که تعارض آن‌ها حل شده است، پس از رفع تعارض‌ها دستور زیر را اجرا کنید:

git add <file-with-conflicts>

8. ادامه فرایند اعمال پچ:

پس از مرحله‌سازی فایل‌های حل‌شده، فرایند اعمال پچ را با دستور زیر ادامه دهید:

git am --continue

با این دستور، به Git گفته می‌شود که به اعمال پچ‌های باقی‌مانده ادامه دهد.

9. لغو اعمال پچ:

اگر فرایند اعمال پچ بیش از حد دشوار شود یا تصمیم بگیرید پچ را اعمال نکنید، می‌توان از ابزار زیر برای توقف آن استفاده کرد:

git am --abort

این دستور اعمال پچ را متوقف می‌کند و هرگونه تغییر ایجادشده در طول این فرایند را بازمی‌گرداند و مخزن را به وضعیت پیش از شروع اعمال پچ برمی‌گرداند.

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