ادغام شاخه‌ها و حل تعارض در گیت

ادغام شاخه‌ها لحظه‌ی باشکوهی است که تلاش‌های جداگانه‌ی اعضای یک تیم به یک نتیجه واحد و نهایی تبدیل می‌شود. در دنیای حرفه‌ای، کدنویسی تنها نیمی از مسیر است و نیمه‌ی دیگر، توانایی ترکیب هوشمندانه‌ی این کدها با دستاوردهای دیگران است.

اما گاهی در این مسیر، با چالش‌هایی به نام «تعارض» یا Conflict روبرو می‌شوید که در نگاه اول ممکن است نگران‌کننده به نظر برسد. در این درس، فرآیند اصولی ادغام شاخه‌ها را می‌آموزید و یاد می‌گیرید که چگونه در مواجهه با تداخل‌های کدی، خونسردی خود را حفظ کرده و مانند یک متخصص، سلامت پروژه را تضمین کنید.

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

درک مفهوم و فلسفه ادغام (Merging)

ادغام یا Merge در گیت، فرآیندی است که طی آن دو یا چند تاریخچه توسعه مستقل را به یکدیگر متصل می‌کنید. در واقع ادغام زمانی اتفاق می‌افتد که می‌خواهید دستاوردها و تغییرات ایجاد شده در یک شاخه فرعی را به شاخه دیگری (معمولاً شاخه اصلی) منتقل کنید تا نتایج کار شما با بقیه پروژه یکپارچه شود.

پیوند تاریخچه‌های توسعه

هر عملیات ادغام، پلی میان مسیرهای زمانی مختلف پروژه برقرار می‌کند. تصور کنید پروژه شما مانند یک جاده اصلی است که در یک نقطه، خروجی‌های مختلفی (شاخه‌ها) از آن جدا شده‌اند؛ ادغام دقیقا همان نقطه‌ای است که این مسیرهای جداگانه دوباره به جاده اصلی بازمی‌گردند و به هم می‌پیوندند.

• کامیت‌های چندوالدینی: در گیت، بیشتر کامیت‌ها تنها یک والد (والد مستقیم قبلی) دارند، اما وقتی دو شاخه را ادغام می‌کنید، یک «کامیت ادغام» (Merge Commit) ایجاد می‌شود که دارای بیش از یک والد است. این نوع کامیت نشان‌دهنده لحظه تلاقی دو خط زمانی مستقل در تاریخچه پروژه شماست.
• حفظ یکپارچگی: ادغام به شما اطمینان می‌دهد که تمام تغییرات، باگ‌فیکس‌ها و ویژگی‌های جدید بدون از دست رفتن تاریخچه هر کدام، در یک نسخه واحد جمع‌آوری می‌شوند.

انتقال ویژگی‌ها به شاخه اصلی

هدف نهایی از شاخه‌سازی، انتقال کدهای آزمایش شده و سالم به ویترین اصلی پروژه (Main/Master) است. پس از اینکه در یک محیط امن (Sandbox) ویژگی جدیدی را توسعه دادید و از صحت عملکرد آن مطمئن شدید، باید آن را با بدنه اصلی نرم‌افزار ترکیب کنید.

• نهایی‌سازی پروژه: با ادغام شاخه ویژگی (Feature Branch) در شاخه اصلی، نسخه Main به‌روزرسانی شده و آماده انتشار یا استفاده کاربران نهایی می‌شود.
• پاک‌سازی پس از ادغام: طبق استانداردهای حرفه‌ای، پس از اینکه یک شاخه با موفقیت در شاخه اصلی ادغام شد، دیگر نیازی به آن نیست و باید برای خلوت ماندن محیط کار، آن شاخه را حذف کنید.

سناریوی ادغام یک ویژگی جدید

فرض کنید روی شاخه‌ای به نام feat-login کار کرده‌اید و اکنون می‌خواهید این قابلیت را به کدهای اصلی پروژه اضافه کنید. این مراحل را دنبال کنید:

۱. ابتدا به شاخه مقصد (که می‌خواهید تغییرات به آن وارد شود) بروید:

git switch main

۲. دستور ادغام را برای فراخوانی کدهای شاخه فرعی اجرا کنید:

git merge feat-login

نتیجه عملی: گیت تمام کامیت‌های شاخه feat-login را بررسی کرده و آن‌ها را با شاخه main ترکیب می‌کند. اگر تداخلی وجود نداشته باشد، شاخه اصلی شما اکنون شامل کدهای بخش ورود (Login) نیز هست و آماده است تا به سرور ارسال شود.

دقت کنید: همیشه پیش از ادغام، وضعیت فایل‌های خود را با git status بررسی کنید تا مطمئن شوید محیط کاری شما تمیز (Clean) است و تغییرات ذخیره نشده‌ای ندارید که باعث ایجاد اختلال در فرآیند ادغام شود.

مدیریت تعارض‌ها (Conflicts)؛ از شناسایی تا حل تداخل

تعارض یا کانفلیکت زمانی رخ می‌دهد که گیت نتواند به صورت خودکار دو مسیر مختلف از تاریخچه پروژه را با هم ترکیب کند. برخلاف تصور بسیاری از تازه‌کارها، بروز تعارض نشان‌دهنده یک خطا یا فاجعه نیست؛ بلکه یک وضعیت کاملاً طبیعی در پروژه‌های تیمی است که گیت در آن از شما می‌خواهد به عنوان یک انسان هوشمند، بهترین نسخه کد را انتخاب کنید.

تعارض چیست؟

تعارض کدی زمانی اتفاق می‌افتد که دو یا چند برنامه‌نویس، خطوط یکسانی از یک فایل را تغییر دهند. گیت در اکثر مواقع بسیار هوشمند عمل می‌کند و تغییرات را به صورت خودکار ادغام می‌کند، اما اگر در دو شاخه مختلف، دقیقاً روی سطر شماره ۱۰ یک فایل دو قطعه کد متفاوت نوشته شده باشد، گیت نمی‌داند کدام یک نسخه درست و نهایی است.

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

ردیابی و شناسایی فایل‌های بحرانی

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

استفاده از دستور وضعیت: با اجرای دستور git status می‌توانید لیست تمام فایل‌هایی که دچار تعارض شده‌اند را در بخش "Unmerged paths" مشاهده کنید.

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

• <<<<<<< HEAD: کدهای موجود در شاخه فعلی شما.
• =======: خط جداکننده دو نسخه متفاوت.
• >>>>>>> branch_name: کدهای موجود در شاخه‌ای که قصد ادغام آن را دارید.

حل دستی تعارضات

ویرایش فایل و انتخاب کد نهایی، وظیفه شما برای نهایی‌سازی ادغام است. پس از پیدا کردن فایل‌های بحرانی، باید آن‌ها را در ویرایشگر متن (مانند VS Code) باز کرده و تصمیم بگیرید که کدام بخش از کد باقی بماند. شما می‌توانید کدهای خودتان را نگه دارید، کدهای هم‌تیمی‌تان را بپذیرید یا ترکیبی از هر دو را بسازید.

سناریوی حل تعارض 

فرض کنید در فایل app.js تعارضی رخ داده است. وقتی فایل را باز می‌کنید، با چنین ساختاری روبرو می‌شوید:

<<<<<<< HEAD
console.log("سلام از شاخه اصلی");
=======
console.log("سلام از شاخه ویژگی جدید");
>>>>>>> feat-new-message

مراحل حل تعارض:

۱. تصمیم‌گیری و ویرایش: نشانگرهای <<<<<<< ، ======= و >>>>>>> را کاملاً پاک کنید و تنها نسخه نهایی کد را باقی بگذارید. مثلاً اگر می‌خواهید هر دو پیام نمایش داده شوند، فایل را به این شکل اصلاح کنید:

console.log("سلام از شاخه اصلی");
console.log("سلام از شاخه ویژگی جدید");

۲. آماده‌سازی فایل اصلاح شده: پس از ذخیره فایل، آن را به محیط استیج اضافه کنید تا گیت بفهمد تعارض حل شده است:

git add app.js

3. ثبت کامیت ادغام: در نهایت با ثبت یک کامیت معمولی، فرآیند ادغام را به پایان برسانید:

 git commit -m "fix: resolve merge conflict in app.js"

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

ابزارها و استانداردهای نهایی‌سازی ادغام

نهایی‌سازی فرآیند ادغام، گامی حیاتی برای حفظ سلامت کدها و شفافیت تاریخچه پروژه است. پس از اینکه کدهای یک شاخه فرعی را با موفقیت در شاخه اصلی ترکیب کردید، باید از ابزارها و استانداردهای مشخصی استفاده کنید تا مطمئن شوید پروژه آماده گام‌های بعدی توسعه است.

کار با git mergetool

استفاده از ابزارهای گرافیکی فرآیند حل تعارض‌های پیچیده را بسیار ساده و بصری می‌کند. اگرچه حل تعارض‌ها به صورت دستی در ویرایشگر متن (مانند VS Code) روشی رایج است، اما گیت دستوری به نام git mergetool را در اختیار شما قرار می‌دهد تا از نرم‌افزارهای تخصصی برای مقایسه و ادغام کدها استفاده کنید. 

این ابزارها فایل متداخل را به سه بخش تقسیم می‌کنند: نسخه شما، نسخه هم‌تیمی‌تان و نسخه مشترک قبلی (Base). با استفاده از این روش، احتمال بروز خطای انسانی در زمان پاک‌سازی نشانگرهای تعارض به شدت کاهش می‌یابد و می‌توانید با سرعت بیشتری تداخل‌های حجیم را مدیریت کنید.

ثبت کامیت ادغام (Merge Commit)

کامیت ادغام به عنوان یک مهر تایید نهایی در تاریخچه پروژه ثبت می‌شود. برخلاف کامیت‌های معمولی که تنها یک «والد» (Parent) دارند، یک کامیت ادغام دارای دو یا چند والد است. این کامیت نشان‌دهنده لحظه‌ای است که دو مسیر زمانی مستقل در یک نقطه به هم پیوسته‌اند. 

ثبت این کامیت پس از حل تعارض‌ها الزامی است؛ زیرا به گیت و سایر اعضای تیم می‌فهماند که فرآیند ادغام با موفقیت به پایان رسیده و تداخل‌ها برطرف شده‌اند. این کار باعث می‌شود تاریخچه پروژه به صورت یک نمودار پیوسته و قابل ردیابی باقی بماند.

تسهیل همکاری هم‌زمان

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

تسلط بر ابزارهای نهایی‌سازی ادغام، محیطی امن به نام «شن‌بازی» (Sandbox) ایجاد می‌کند که در آن هر توسعه‌دهنده می‌تواند با جسارت تغییرات خود را ثبت کند، چرا که می‌داند گیت ابزارهای لازم برای پیوند دوباره این تغییرات را در اختیار تیم قرار می‌دهد.

نهایی‌سازی ادغام و ثبت کامیت

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

۱. استفاده از ابزار کمکی (در صورت نیاز):

برای باز کردن ابزار گرافیکی حل تعارض که قبلاً روی سیستم خود تنظیم کرده‌اید، بنویسید:

git mergetool

۲. تایید فایل‌های اصلاح شده:

فایل‌هایی را که تعارض آن‌ها حل شده است، به محیط استیج اضافه کنید:

git add .

۳. ثبت نهایی کامیت ادغام:

اکنون با یک پیام استاندارد، پایان عملیات ادغام را اعلام کنید:

git commit -m "merge: resolve conflicts and integrate feat-chat-system"

خروجی مورد انتظار: گیت پیامی مبنی بر ثبت موفقیت‌آمیز کامیت جدید نمایش می‌دهد. اکنون اگر دستور `git log --graph` را اجرا کنید، پیوند دو شاخه را به صورت بصری در تاریخچه مشاهده خواهید کرد.

نکته مهم: همیشه پس از اتمام ادغام و ثبت کامیت، برنامه خود را یک بار اجرا و تست کنید تا مطمئن شوید در حین حل دستی تعارضات، منطق برنامه (Logic) آسیب ندیده باشد.