كيف تتراجع عن الأخطاء في Git: دليل شامل لاستعادة مشروعك البرمجي

أوه لا! لقد قمت للتو بدمج ملفاتك عن طريق الخطأ في الفرع الرئيسي master branch بدلاً من فرع التطوير staging branch. ماذا الآن؟

يكاد يكون كل مطور يستخدم Git قد ارتكب خطأً في مرحلة ما. سواء كان ذلك دمج الملفات الخاطئة، حذف فرع غير مقصود، أو ما هو أسوأ، فإن معرفة كيفية التراجع عن هذه الأخطاء باستخدام Git أمر بالغ الأهمية. لحسن الحظ، Git أداة قوية توفر مجموعة واسعة من الآليات لتصحيح المسار واستعادة مشروعك إلى حالته الصحيحة. في هذا الدليل الشامل، سنستكشف الطرق المختلفة التي يمكنك من خلالها التراجع عن الأخطاء في Git، بدءاً من الحالات البسيطة وصولاً إلى السيناريوهات الأكثر تعقيداً.

Git كشبكة أمان: فهم أساسيات التراجع

يُعد Git أكثر من مجرد نظام للتحكم في الإصدارات؛ إنه شبكة أمان لمشروعك. يتيح لك تتبع كل تغيير، مما يعني أنك نادراً ما تفقد العمل بشكل دائم. القدرة على التراجع عن الأخطاء هي إحدى أقوى ميزات Git، وتمنح المطورين الثقة لتجربة وتعديل التعليمات البرمجية دون خوف من إفساد المشروع بشكل لا رجعة فيه.

التراجع عن التغييرات المحلية: استعادة ملفاتك

قبل أن يتم الالتزام بالتغييرات (commit) في سجل Git، تكون هذه التغييرات محلية ويمكن التراجع عنها بسهولة. إليك كيفية التعامل مع التغييرات التي لم يتم الالتزام بها بعد:

التخلص من جميع التغييرات المحلية في ملف واحد

إذا قمت بإجراء تغييرات في ملف معين وقررت أنك لا تريد الاحتفاظ بها، يمكنك التخلص من جميع التغييرات المحلية في هذا الملف. ستعود حالة الملف إلى آخر التزام commit.

git checkout -- <file>

استعادة الملفات المحذوفة

هل حذفت ملفاً عن طريق الخطأ وتحتاج إلى استعادته من آخر التزام؟ Git يجعل هذا ممكناً.

git checkout HEAD -- <file>

التراجع عن أجزاء أو أسطر محددة

في بعض الأحيان، قد تحتاج فقط إلى التراجع عن جزء معين من التغييرات داخل ملف، وليس الملف بأكمله. يمكن لـ Git مساعدتك في ذلك بشكل تفاعلي.

git add -p

ثم استخدم خيارات التراجع التفاعلية. أو يمكنك استخدام أدوات مثل git restore --patch <file> (لإصدارات Git الحديثة).

التخلص من جميع التغييرات المحلية دفعة واحدة

إذا كنت ترغب في التخلص من جميع التغييرات غير الملتزم بها في مستودعك (repository) بالكامل، يمكنك القيام بذلك بحذر.

git reset --hard HEAD

تحذير: هذا الأمر سيتخلص من جميع التغييرات المحلية غير الملتزم بها بشكل دائم.

إدارة التزاماتك (Commits): تصحيح سجل المشروع

بمجرد أن يتم الالتزام بالتغييرات (committed)، تصبح جزءاً من سجل مشروعك. لكن Git يوفر أيضاً طرقاً لتعديل هذا السجل إذا لزم الأمر.

تصحيح آخر التزام (Commit)

إذا ارتكبت خطأً في آخر التزام (مثل رسالة commit خاطئة أو نسيان ملف)، يمكنك تعديله.

git commit --amend

هذا الأمر سيفتح محرر النص لتعديل رسالة الالتزام، أو يمكنك إضافة تغييرات جديدة إلى الالتزام الحالي قبل حفظه.

مفهوم “إعادة كتابة التاريخ” في Git

يشير مصطلح “إعادة كتابة التاريخ” (rewriting history) في Git إلى تغيير سجل الالتزامات (commit history) بعد أن تم إنشاؤه. يمكن أن يكون هذا مفيداً لتنظيف السجل قبل الدفع (push) إلى مستودع مشترك، ولكنه قد يكون خطيراً إذا تم استخدامه على فروع عامة (public branches) لأنها تغير معرفات الالتزامات (commit IDs).

التراجع عن التزام وسيط (Reverting a Commit)

إذا كنت ترغب في التراجع عن تأثير التزام معين دون إزالة الالتزام نفسه من السجل، يمكنك استخدام git revert. هذا ينشئ التزاماً جديداً يعكس التغييرات التي أدخلها الالتزام الأصلي.

git revert <commit-hash>

هذا الخيار آمن للاستخدام على الفروع المشتركة.

العودة إلى إصدار قديم (Resetting to an Old Revision)

يمكن لـ git reset نقل مؤشر HEAD إلى التزام أقدم، مما يؤدي بشكل فعال إلى التراجع عن الالتزامات اللاحقة. هناك ثلاثة أوضاع رئيسية لـ reset:

• git reset --soft <commit-hash>: ينقل HEAD فقط، مع الاحتفاظ بالتغييرات في منطقة التجهيز (staging area).
• git reset --mixed <commit-hash> (الوضع الافتراضي): ينقل HEAD ويقوم بإلغاء تجهيز التغييرات (unstaging changes)، لكن يحتفظ بها في دليل العمل (working directory).
• git reset --hard <commit-hash>: ينقل HEAD ويتخلص من جميع التغييرات في دليل العمل ومنطقة التجهيز. تحذير: هذا سيدمر العمل غير المحفوظ.

إعادة ملف إلى إصدار قديم

إذا كنت بحاجة إلى استعادة ملف واحد فقط إلى حالته في التزام سابق، يمكنك القيام بذلك دون التأثير على بقية مشروعك.

git checkout <commit-hash> -- <file>

أو باستخدام git restore --source <commit-hash> <file> (لإصدارات Git الحديثة).

استكشاف سجل Git: قوة Reflog

Reflog هو سجل مرجعي لجميع التغييرات التي طرأت على مؤشر HEAD في مستودعك المحلي. إنه منقذك عندما تعتقد أنك فقدت التزامات أو فروعاً.

سجل المراجع (The Reflog): منقذك السري

حتى لو قمت بحذف التزامات أو فروع باستخدام git reset --hard، فإن Reflog يحتفظ بسجل لهذه الإجراءات، مما يتيح لك استعادة ما فقدته. يمكنك رؤية سجل Reflog باستخدام:

git reflog

استعادة التزامات محذوفة

إذا قمت عن طريق الخطأ بحذف التزام باستخدام git reset --hard، يمكنك العثور عليه في Reflog واستعادته.

git cherry-pick <commit-hash-from-reflog>

أو يمكنك إعادة تعيين (reset) فرعك إلى ذلك الالتزام.

استعادة الفروع المحذوفة

تماماً مثل الالتزامات، يمكن استعادة الفروع المحذوفة باستخدام Reflog. ابحث عن الالتزام الأخير للفرع المحذوف في Reflog ثم أنشئ فرعاً جديداً يشير إليه.

git branch <new-branch-name> <commit-hash-from-reflog>

إعادة كتابة التاريخ بذكاء: استخدام Interactive Rebase

Interactive Rebase هي أداة قوية تسمح لك بتعديل سجل الالتزامات بطرق معقدة، مثل دمج التزامات، أو إعادة ترتيبها، أو حذفها، أو تعديل رسائلها.

نقل التزام إلى فرع جديد

يمكنك نقل التزام واحد أو أكثر إلى فرع جديد باستخدام git cherry-pick.

git cherry-pick <commit-hash>

هذا ينسخ الالتزام إلى الفرع الحالي.

نقل التزام إلى فرع مختلف

لتحريك التزام فعلياً من فرع إلى آخر (مع إزالته من الفرع الأصلي)، يتطلب الأمر مزيجاً من cherry-pick و git reset أو git rebase.

مقدمة إلى Interactive Rebase: إمكانياته

Interactive Rebase (git rebase -i) يفتح محرر نص يعرض قائمة بالالتزامات التي سيتم إعادة ترتيبها أو تعديلها. يمكنك استخدام أوامر مثل pick، reword، edit، squash، fixup، drop لتعديل السجل.

git rebase -i HEAD~<number-of-commits>

كيف يعمل Interactive Rebase بشكل عام

عند بدء Interactive Rebase، يقوم Git بإعادة تطبيق الالتزامات واحداً تلو الآخر بناءً على التعليمات التي قدمتها. إنه يسمح لك بالتحكم الدقيق في كيفية بناء سجل مشروعك.

تعديل رسائل التزام قديمة

باستخدام reword في Interactive Rebase، يمكنك بسهولة تعديل رسالة أي التزام قديم.
في ملف rebase التفاعلي، استبدل pick بـ reword بجانب الالتزام الذي تريد تعديله.

حذف التزامات

يمكنك حذف التزامات غير مرغوب فيها من السجل باستخدام drop في Interactive Rebase.
في ملف rebase التفاعلي، استبدل pick بـ drop أو احذف السطر بالكامل للالتزام الذي تريد حذفه.

دمج التزامات متعددة في التزام واحد (Squashing)

Squashing يسمح لك بدمج عدة التزامات صغيرة ومتعاقبة في التزام واحد أكبر وأكثر وضوحاً. هذا مفيد لتنظيف سجل الفروع قبل الدمج.
استخدم squash أو fixup في ملف rebase التفاعلي.

إضافة تغييرات إلى التزام قديم

إذا نسيت تضمين تغييرات في التزام قديم، يمكنك استخدام edit في Interactive Rebase لإيقاف عملية rebase عند هذا الالتزام، وإجراء التغييرات، ثم تعديل الالتزام.

تقسيم أو تعديل التزام قديم

باستخدام edit في Interactive Rebase، يمكنك أيضاً تقسيم التزام واحد إلى عدة التزامات، أو تعديل محتوياته بشكل جذري.

الخلاصة التقنية

يُظهر هذا الاستكشاف الشامل لقدرات Git في التراجع عن الأخطاء أنه أداة لا غنى عنها لأي مطور. من التراجعات البسيطة للتغييرات المحلية إلى التعديلات المعقدة لسجل الالتزامات باستخدام Interactive Rebase، يوفر Git مرونة لا مثيل لها. إن فهم هذه الأدوات لا يقتصر فقط على إصلاح الأخطاء، بل يتعلق أيضاً بتمكينك من العمل بثقة، وتجربة أفكار جديدة، والحفاظ على سجل مشروع نظيف ومنظم. تذكر دائماً أن Git يحتفظ بسجل لكل شيء تقريباً، وأن معرفة كيفية استخدام Reflog يمكن أن تنقذك حتى من أصعب المواقف. استثمر وقتك في إتقان هذه التقنيات، وستجد أن إدارة مشروعك البرمجي أصبحت أكثر سلاسة وأماناً.