شرح Git stash: احفظ تغييراتك وانتقل بين الفروع ثم استعد عملك

يحفظ Git stash التغييرات غير المسجّلة لتتمكن من العمل على مهمة أخرى ثم استعادتها. ابدأ بالأمر git stash push -m "WIP: checkout form"، ثم استخدم git stash apply للاحتفاظ بالنسخة المحفوظة بعد استعادتها، أو git stash pop لحذفها بعد نجاح الاستعادة. أضف -u إذا كان العمل يتضمن ملفات جديدة غير متتبعة.

سنستخدم مثالًا واضحًا: توقّف مؤقتًا عن تطوير نموذج إتمام الشراء، وأصلح مشكلة في فرع آخر، ثم عُد إلى النموذج. نعرض أيضًا الخطوات في GitTree، برنامج Git الذي نطوّره لأنظمة macOS وWindows وLinux. إدارة stash ضمن الخطة المجانية، وتتطلب الإصدارات الرسمية الحالية تسجيل الدخول.

متى تستخدم stash أو commit أو worktree؟

للمهام المتوازية الطويلة راجع دليل worktrees. يناسب stash الحفظ المؤقت، لكنه ليس نسخة احتياطية كافية وحده للعمل المهم. سمِّ كل عنصر باسم المهمة؛ يشير stash@{0} إلى أحدث عنصر ويتغير الترقيم مع تغيّر القائمة.

مثال كامل لحفظ التغييرات والانتقال إلى فرع آخر

افحص git status أولًا. يحفظ stash الافتراضي تعديلات الملفات المتتبعة، ومنها ما أضفته إلى staging، ولا يشمل الملفات الجديدة أو المتجاهَلة. لأن النموذج يتضمن ملفًا جديدًا سنستخدم -u. يفترض المثال وجود الفرعين feature/checkout وhotfix/payment؛ استبدلهما بأسماء فروعك.

git status
git stash push -u -m "WIP: checkout form"
git stash list
git status
git switch hotfix/payment

أنهِ الإصلاح واختبره وسجّله قبل العودة. راجع قائمة stash والفروق قبل الاستعادة؛ فقد تنشئ مهمة أخرى عنصرًا أحدث أثناء غيابك. وضع المحدِّد مثل "stash@{0}" بين علامتي اقتباس يمنع الصدفة من تفسير رموزه بشكل خاص.

git switch feature/checkout
git stash list
git stash show -p --include-untracked "stash@{0}"
git stash apply "stash@{0}"
git status

الفرق بين git stash apply وpop

للعمل المهم، استخدم apply أولًا ثم راجع التغييرات واختبرها، واحذف العنصر بعد تسجيل العمل المستعاد. قد تؤدي الاستعادة مرتين إلى تعارضات أو تكرار تغييرات، لذا افحص الملفات قبل المحاولة مجددًا. لا يرفع apply أو pop أي شيء إلى خادم.

حفظ الملفات الجديدة أو المحددة أو الموجودة في staging

git stash push -u -m "WIP: include new files"
git stash push -m "WIP: checkout only" -- src/checkout.ts
git stash push --staged -m "WIP: staged changes only"
git stash push --keep-index -m "WIP: keep staged work ready"

هذه بدائل مستقلة وليست سلسلة تنفّذها معًا. يحدد المسار بعد -- الملفات المطلوبة. يحفظ --staged التغييرات الموجودة في staging فقط، بينما يترك --keep-index التغييرات المُجهّزة في مكانها لتختبرها أو تسجّلها مع إبعاد التعديلات الأخرى. قد لا تدعم إصدارات Git القديمة الخيار --staged؛ افحص git --version ومساعدة إصدارك.

لتجربة هذه الخطوات على مستودعك، نزّل GitTree وسجّل الدخول وافتح مجلد المستودع. تظل stashes الموجودة عناصر Git عادية يمكنك رؤيتها من الطرفية أيضًا.

حل تعارضات git stash pop

قد يظهر تعارض إذا غيّر الفرع المستقبِل الأسطر نفسها. يحتفظ pop بالعنصر عند التعارض، لكن بعض التغييرات قد تكون طُبّقت بالفعل. لا تكرر pop؛ نفّذ git status وحل الملفات المتعارضة وأضف الحلول المطلوبة فقط إلى staging. يشرح دليل تعارضات الدمج العلامات والمحرر الثلاثي.

git status
git diff --name-only --diff-filter=U
# Edit and test each conflicted file, then stage its resolution:
git add -- src/checkout.ts
git diff --cached
git status

لا يوجد git stash --continue أو git stash --abort. بعد حل الملفات راجعها وسجّلها بالطريقة المعتادة. إذا أردت إلغاء المحاولة، احفظ العمل السابق للاستعادة وراجع كل مسار قبل تجاهل تغييرات؛ فقد يمحو hard reset تعديلات غير مرتبطة. إذا ابتعد الفرع كثيرًا، يستعيد git stash branch rescue/checkout "stash@{0}" العمل على فرع جديد عند نقطة البداية الأصلية ويحذف العنصر بعد النجاح.

احذف stash بعد التأكد من النتيجة

نفّذ git stash list مجددًا قبل git stash drop "stash@{0}" لأن ترتيب العناصر قد يتغير. يحذف git stash clear القائمة كلها. استعادة عنصر محذوف باستخدام Git وحده غير مضمونة وتعتمد على بقاء كائناته. يحتفظ Delete Stash في GitTree بالعنصر في لقطات الاستعادة ليعيده Undo؛ هذه خاصية في التطبيق ولا تضمن استعادة حذف نُفّذ من الطرفية. راجع أيضًا التراجع عن أخطاء Git.