كيف تتمكن من استرجاع الالتزامات المفقودة باستخدام git reflog؟

Question

Accepted Answer

**git reflog** يسجل كل مكان كان فيه HEAD الخاص بفرعك — كل التزام وتبديل فرع وإعادة تعيين وإعادة ترتيب قاعدة، إلخ. إنها شبكة أمان **لاستعادة الالتزامات "المفقودة"** (بعد إعادة تعيين سيئة أو إعادة ترتيب قاعدة فاشلة أو حذف فرع) التي تبدو أنها اختفت لكنها لا تزال قابلة للاستعادة.

## ما هو reflog

```text
The REFLOG logs every movement of HEAD (and branch tips) in YOUR local repo:
  → every commit, checkout, reset, rebase, merge, etc. is recorded with a reference
  → it's LOCAL and includes commits not reachable from any branch (the "lost" ones)
→ Even if you reset/rebase away commits, reflog remembers where they were.
```

## استعادة العمل المفقود

```bash
git reflog                     # show the history of HEAD movements
# example output:
#   abc123 HEAD@{0}: reset: moving to HEAD~3
#   def456 HEAD@{1}: commit: Important work    ← the "lost" commit!
#   ...

# recover: the lost commit is def456 — get it back
git checkout def456            # inspect it
git branch recovered def456    # create a branch at it (save it)
# or reset back to it:
git reset --hard def456        # restore HEAD to that commit
```

عندما يبدو أن الالتزامات مفقودة (بعد `reset --hard`، أو إعادة ترتيب قاعدة فاشلة، أو حذف فرع)، يوضح `git reflog` حيث كان HEAD، ويمكنك استعادة الالتزام من خلال الهاش الخاص به (بالاطلاع عليه، أو إنشاء فرع، أو إعادة التعيين إليه).

## سيناريوهات الاستعادة الشائعة

```text
✓ After git reset --hard (discarded commits) → find them in reflog, reset back
✓ After a bad rebase (rewrote/lost commits) → reflog has the pre-rebase state
✓ After deleting a branch → its last commit is in reflog → recreate the branch
✓ "Detached HEAD" commits that seem orphaned → reflog finds them
→ As long as commits existed locally, reflog usually can recover them (until GC, ~weeks).
```

## لماذا هذا مهم

فهم `git reflog` قيّم كـ**شبكة أمان لاستعادة العمل المفقود**، لذا فهو معرفة عملية مهمة يمكن أن تنقذك من أخطاء تبدو مدمرة.

عمليات Git التي تعيد كتابة السجل أو تنقل HEAD — `reset --hard`، وإعادة ترتيب قاعدة فاشلة، وحذف الفروع — يمكن أن تجعل الالتزامات **تبدو مفقودة**، وهذا مقلق ويبدو أنه غير قابل للعكس.

الرؤية الأساسية هي أن هذه الالتزامات عادة **لم تختفِ بالفعل**: `git reflog` يسجل كل حركة من حركات HEAD محلياً (كل التزام وتبديل فرع وإعادة تعيين وإعادة ترتيب قاعدة)، بما في ذلك الالتزامات غير القابلة للوصول من أي فرع، لذا يتذكر أين كانت الالتزامات "المفقودة".

هذا يجعل reflog **أداة استعادة قوية** — عندما يبدو أن العمل مفقود بعد إعادة تعيين سيئة، أو إعادة ترتيب قاعدة فاشلة، أو حذف فرع، يمكنك استخدام `git reflog` للعثور على هاش الالتزام واستعادته (بالاطلاع عليه، أو إنشاء فرع عنده، أو إعادة التعيين مرة أخرى إليه).

فهم **سيناريوهات الاستعادة الشائعة** (الاستعادة بعد `reset --hard`، إعادة الترتيب السيئة، حذف الفرع، والالتزامات المعزولة في حالة detached-HEAD) وأن الاستعادة تعمل طالما كانت الالتزامات موجودة محلياً (حتى تنظيف القمامة، عادة بعد أسابيع) هي معرفة عملية قيّمة.

هذه الشبكة الأمان مطمئنة ومفيدة حقاً — فهذا يعني أن العديد من حالات "فقدت عملي!" قابلة للاستعادة، مما يزيل الكثير من الخوف من عمليات Git التي تعيد كتابة السجل.

نظراً لأن الأخطاء التي تبدو وكأنها تفقد الالتزامات شائعة (خاصة عند التعلم أو استخدام أوامر قوية مثل reset و rebase)، ولأن reflog هي الأداة التي تستعيدها (غالباً ما تحول حالة الذعر إلى إصلاح سريع)، فإن فهم `git reflog` — ما الذي تسجله، وكيفية استعادة الالتزامات المفقودة، والسيناريوهات الشائعة للاستعادة — هو معرفة Git قيّمة وذات صلة عملية كشبكة أمان أساسية، أداة توفر الثقة لاستخدام ميزات Git القوية مع العلم بأن العمل المفقود يمكن استعادته عادة، ومعرفة مطمئنة حقاً لأي مطور.