> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# التبديل بين المهام في Git: Stash أم Worktree؟
- URL: https://arabroot.io/articles/التبديل-بين-المهام-في-git-stash-ام-worktree/
- Published: 2026-11-03T12:33:11.000Z
- Updated: 2026-11-03T13:31:25.000Z
- Description: عندما يأتيك طلب عاجل وأنت في منتصف ميزة، تحفظ عملك جانباً بالأمر stash أو تفتح له مجلداً ثانياً بالأمر worktree، وهنا تتعلم الاثنين خطوة بخطوة ومتى تختار كل واحد.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, DevOps والتشغيل, DevOps وCI/CD, الاستضافة الذاتية

أنت في منتصف ميزة نقاط الولاء في متجر إلكتروني: دالة الاستبدال نصف مكتوبة وفيها TODO، وسطر جديد في README أضفته إلى التجهيز، وملف ملاحظات فيه أفكار لم ترتبها بعد. ثم تصلك رسالة: «الأسعار في الفواتير تظهر بكسور طويلة، والعملاء يشتكون، نحتاج إصلاحاً اليوم». والإصلاح يجب أن يبدأ من main كما هو على السيرفر، وليس من فرعك الذي فيه عمل لم يكتمل. فتنفذ `git switch main`، فيرفض Git ويقول إن تعديلاتك سوف تضيع. وهنا يفعل أغلب المبتدئين واحداً من ثلاثة: ينشئ Commit باسم «WIP» فيه كود لا يعمل، أو ينسخ المجلد كله إلى مكان آخر، أو يعدل في main وفي فرعه في المجلد نفسه فيختلط كل شيء.

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

- تجهيز المختبر: مستودع على سيرفر محلي، وفرع ميزة فيه عمل غير مكتمل بأنواعه الثلاثة.
- لماذا يرفض Git تبديل الفرع، ومتى يقبله.
- الأمر `git stash`: ماذا يحفظ وماذا يترك، والخيار `-u`، والقائمة، وpop وapply.
- التعارض عند pop، واسترجاع حفظ حذفته بالخطأ، وتحويل الحفظ إلى فرع.
- الأمر `git worktree` من الصفر: add وlist، وكيف يعمل من الداخل.
- قاعدة الفرع الواحد في مجلد واحد، ثم ثلاث حالات استخدام: إصلاح عاجل، ومراجعة طلب دمج، وتشغيل إصدارين معاً.
- remove وprune وlock، ثم مقارنة الطرق الأربع وجدول الموقف والأمر.

## تجهيز المختبر Lab Setup

نستخدم Container صغيراً من Alpine Linux فيه Git، ولا نحتاج أي شيء آخر، حتى السيرفر سوف يكون مستودعاً مجرداً Bare Repository في مجلد داخل ال Container نفسه، وهو يعمل كأنه Gitea أو GitHub من جهة أوامر الدفع والجلب:

```bash
docker run -it --rm --name gsp-lab alpine:3.24 sh
apk add --no-cache git
git config --global user.name "ArabRoot Team"
git config --global user.email "team@example.com"
git config --global init.defaultBranch main
```

ثم بنينا المستودع: على main ملف `cart.py` فيه رقم الإصدار `VERSION = "1.0.0"` ودالتا السعر والمجموع، وملف README، وملف `.gitignore` يتجاهل ملفات `*.log`، ووضعنا على هذا ال Commit الوسم v1.0.0 ودفعنا كل شيء. ثم فتحنا الفرع `feature/loyalty` وأضفنا فيه دالة حساب النقاط ودفعناه. وبعدها صنعنا العمل غير المكتمل بأنواعه: أضفنا دالة الاستبدال `redeem` إلى `cart.py` دون تجهيز، وأضفنا سطراً إلى README ونفذنا له `git add`، وأنشأنا ملفاً جديداً `notes.txt`، وملف `debug.log` الذي يتجاهله Git. وكل أوامر البناء في ملف المختبر مع المقال. هذه هي الحالة:

```bash
git status --short
```

والمخرج سوف يكون كما يلي:

```bash
M  README.md
 M cart.py
?? notes.txt
```

تذكر قراءة هذه الصيغة: لكل ملف عمودان، الأول لمنطقة التجهيز والثاني لملفات العمل. فالسطر `M README.md` يعني تعديلاً مجهزاً، و` M cart.py` تعديلاً غير مجهز، و`??` ملفاً جديداً لا يتتبعه Git. أما `debug.log` فلا يظهر أصلاً لأنه متجاهل. وهذه الأنواع الأربعة مهمة، لأن كل أداة في هذا المقال تتعامل معها بطريقة مختلفة.

## لماذا يرفض Git تبديل الفرع؟ Switch Blocked

نحاول الانتقال إلى main كما يفعل أي شخص:

```bash
git switch main
```

والمخرج سوف يكون كما يلي:

```bash
error: Your local changes to the following files would be overwritten by checkout:
	cart.py
Please commit your changes or stash them before you switch branches.
Aborting
```

الرسالة دقيقة: الملف `cart.py` مختلف بين الفرعين، فعند الانتقال يجب أن يكتب Git نسخة main فوق الملف، ولكن في الملف تعديلات لم تحفظ في أي Commit، فلو كتب فوقها لضاعت، لذلك رفض و`Aborting` يعني أنه لم يغير شيئاً. ولاحظ أنه لم يشتك من README، مع أنه معدل أيضاً. والسبب أن Git لا يرفض التبديل لمجرد وجود تعديلات، وإنما يرفضه فقط عندما يحتاج أن يكتب فوق ملف معدل، فإذا كان الملف المعدل متطابقاً بين الفرعين فإنه ينقل تعديلك معك إلى الفرع الآخر. وهذا السلوك نفسه مصدر خطأ شائع: تبدل الفرع بنجاح، فتظن أن عملك بقي في فرع الميزة، وهو في الحقيقة انتقل معك، فتلتزم به على main دون أن تنتبه. والرسالة نفسها تقترح حلين: Commit أو Stash، ونضيف إليهما ثالثاً هو Worktree.

## الحفظ المؤقت Stash: رف جانبي لتعديلاتك

الأمر [git stash](https://git-scm.com/docs/git-stash?ref=arabroot.io) يأخذ تعديلاتك غير الملتزم بها، ويحفظها في مكان خاص داخل المستودع، ثم يرجع ملفاتك إلى حالة آخر Commit، فيصبح المجلد نظيفاً وتستطيع أن تبدل الفرع. وما يحفظه يبقى في قائمة، والأحدث في أعلاها، ثم ترجعه متى شئت. وفي الداخل كل حفظ هو Commit خاص لا ينتمي إلى أي فرع، ولهذا لا يضيع بسهولة كما سوف نرى. والصورة التالية تبين الفكرة:

![ثلاث لوحات من اليمين: ملفات العمل على feature/loyalty وفيها README مجهز وcart.py معدل وnotes.txt جديد، ثم سهم push إلى قائمة الحفظ وفيها stash@{0} وstash@{1} وstash@{2} والأحدث في الأعلى، ثم المجلد نظيف تبدل فيه إلى main وتصلح وترجع، وتحتها أربعة أوامر: push وpop وapply وdrop](https://arabroot.io/content/images/2026/11/git-stash-worktree-01-stash-stack.webp)

الحفظ المؤقت قائمة على جهازك، والأحدث فيها هو stash@{0}

### أول محاولة: git stash دون خيارات

```bash
git stash
git status --short
```

والمخرج سوف يكون كما يلي:

```bash
Saved working directory and index state WIP on feature/loyalty: 5d67b93 Add loyalty points

?? notes.txt
```

في المخرج أعلاه لاحظ التالي:

- العبارة `working directory and index state` تعني أنه حفظ ملفات العمل ومنطقة التجهيز Index معاً، أي `cart.py` وREADME.
- الرسالة الافتراضية للحفظ هي «WIP on» ثم اسم الفرع وآخر Commit فيه، وهي رسالة لا تخبرك بشيء عن العمل نفسه، وسوف نرى بعد قليل لماذا يجب أن تكتب رسالتك.
- والمهم أن `notes.txt` ما زال في المجلد، فالأمر دون خيارات يحفظ الملفات التي يتتبعها Git فقط. فإذا بدلت الفرع الآن وأنشأت هناك Commit بالأمر `git add -A` فسوف يدخل ملف ملاحظاتك في إصلاح لا علاقة له به.

نرجع التعديلات ونرى ماذا رجع:

```bash
git stash pop
git status --short
```

والمخرج سوف يكون كما يلي، بعد مخرج `git status` الطويل الذي يطبعه pop بنفسه:

```bash
Dropped refs/stash@{0} (436d6398fded183be3cdeec4b7049ed2e842292a)

 M README.md
 M cart.py
?? notes.txt
```

رجعت التعديلات، وحذف الحفظ من القائمة، ورقمه 436d639 مطبوع في السطر، وسوف نحتاج هذه المعلومة لاحقاً. ولكن انظر جيداً إلى README: كان `M README.md` أي مجهزاً، وأصبح `M README.md` أي غير مجهز. وهذه نقطة لا ينتبه لها كثيرون: pop يرجع التعديلات إلى الملفات، ولكنه لا يرجع حالة التجهيز إلا إذا طلبت ذلك بالخيار `--index`. وقد جربنا ذلك في مستودع صغير منفصل فيه ملف مجهز:

```bash
git status --short --ignored
git stash push -q
git stash pop -q --index
git status --short --ignored
```

والمخرج سوف يكون كما يلي:

```bash
M  f.txt
!! debug.log

M  f.txt
!! debug.log
```

مع `--index` رجع `f.txt` مجهزاً كما كان. والخيار `--ignored` في `git status` يعرض الملفات المتجاهلة بالعلامة `!!`، ولاحظ أن `debug.log` لم يدخل الحفظ ولم يخرج منه، فبقي في مكانه.

### الصيغة الصحيحة: git stash push -u -m

الآن نحفظ بالطريقة التي ننصحك أن تعتادها: الخيار `-u` أي Include Untracked ليشمل الملفات الجديدة، والخيار `-m` لرسالة تصف العمل:

```bash
git stash push -u -m "loyalty: redeem in progress"
git status --short
git stash list
git stash show -p --include-untracked stash@{0} | head -24
```

والمخرج سوف يكون كما يلي:

```bash
Saved working directory and index state On feature/loyalty: loyalty: redeem in progress

stash@{0}: On feature/loyalty: loyalty: redeem in progress

diff --git a/README.md b/README.md
index a00621b..44a6e3e 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,2 @@
 # Shop
+Loyalty: 1 point per 10 SAR
diff --git a/cart.py b/cart.py
index 94c6c5d..e9189d9 100644
--- a/cart.py
+++ b/cart.py
@@ -8,3 +8,7 @@ def total(items):

 def points(total):
     return int(total // 10)
+
+def redeem(points):
+    # TODO: limit per order
+    return points * 0.5
diff --git a/notes.txt b/notes.txt
new file mode 100644
index 0000000..a3fcfde
--- /dev/null
+++ b/notes.txt
```

في المخرج أعلاه لاحظ التالي:

- `git status --short` لم يطبع شيئاً، أي أن المجلد نظيف تماماً، حتى `notes.txt` دخل الحفظ.
- `git stash list` يعرض القائمة، وكل حفظ له اسم بالصيغة `stash@{n}`، والرقم صفر هو الأحدث. والرسالة التي كتبناها هي ما يميز الحفظ عندما تكثر القائمة بعد أسبوع.
- `git stash show -p` يعرض محتوى الحفظ كفروقات Diff، ويحتاج `--include-untracked` حتى يعرض الملفات الجديدة أيضاً. وهذا الأمر مفيد قبل أن ترجع أي حفظ، فتعرف ماذا سوف يدخل ملفاتك.

والصورة التالية تلخص ما يحفظه كل شكل من أشكال الأمر، وقد تحققنا من الصفوف الأربعة في المختبر، فالخيار `-a` أي All يشمل حتى الملفات المتجاهلة، ورأينا `debug.log` و`f.txt` معاً في الحفظ عندما استخدمناه:

![جدول بأربعة صفوف وثلاثة أعمدة: ملف متتبع معدل يحفظه git stash وgit stash -u وgit stash -a، وتعديل مجهز تحفظه الثلاثة ويرجع غير مجهز إلا مع --index، وملف جديد لا يحفظه git stash ويحفظه -u و-a، وملف متجاهل يحفظه -a فقط، وتحت الجدول القاعدة العملية git stash push -u -m](https://arabroot.io/content/images/2026/11/git-stash-worktree-02-what-stash-saves.webp)

دون -u يبقى الملف الجديد في المجلد، ودون --index يرجع التعديل المجهز غير مجهز

### الإصلاح العاجل مع Stash Hotfix

المجلد نظيف، فننتقل إلى main، ونصلح المجموع حتى يتجاهل المنتجات التي كميتها صفر، وندفع، ثم نرجع ونسترجع عملنا:

```bash
git switch main
git commit -qam "Fix total for zero quantity"
git push -q origin main
git switch feature/loyalty
git stash pop
git status --short
```

والمخرج سوف يكون كما يلي، دون مخرج `git status` الطويل الذي يطبعه pop:

```bash
Switched to branch 'main'
Your branch is up to date with 'origin/main'.

Switched to branch 'feature/loyalty'
Your branch is up to date with 'origin/feature/loyalty'.

Dropped refs/stash@{0} (951b502c09d6481f7982ce20d0f16c81a4760292)

 M README.md
 M cart.py
?? notes.txt
```

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

### عندما يتعارض pop: Stash Conflict

الحفظ يطبق تعديلاتك على حالة الفرع وقت الاسترجاع، فإذا تغيرت الأسطر نفسها منذ أن حفظت فسوف يظهر تعارض. وهذا يحدث في الحياة الحقيقية عندما تحفظ، ثم يدفع زميلك إلى فرعك تعديلاً على الدالة نفسها فتسحبه، ثم تسترجع. في المختبر حفظنا دالة الاستبدال، ثم أنشأنا على الفرع Commit يضاعف النقاط ويضيف دالة `redeem` بقيمة أخرى، ثم استرجعنا:

```bash
git stash push -m "redeem v2"
git commit -qam "Double loyalty points and add redeem"
git stash pop
git status --short
git stash list
sed -n "/<<<<<<</,/>>>>>>>/p" cart.py
```

والمخرج سوف يكون كما يلي:

```bash
Saved working directory and index state On feature/loyalty: redeem v2

Auto-merging cart.py
CONFLICT (content): Merge conflict in cart.py
On branch feature/loyalty
Your branch is ahead of 'origin/feature/loyalty' by 1 commit.
  (use "git push" to publish your local commits)

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
	modified:   README.md

Unmerged paths:
  (use "git restore --staged <file>..." to unstage)
  (use "git add <file>..." to mark resolution)
	both modified:   cart.py

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	notes.txt

The stash entry is kept in case you need it again.

M  README.md
UU cart.py
?? notes.txt

stash@{0}: On feature/loyalty: redeem v2

<<<<<<< Updated upstream
    return int(total // 5)

def redeem(points):
    return points * 0.25
=======
    return int(total // 10)

def redeem(points):
    # TODO: limit per order
    return points * 0.5
>>>>>>> Stashed changes
```

هذا المخرج طويل، ولكن ثلاثة أسطر فيه هي الأهم:

- `CONFLICT (content): Merge conflict in cart.py`: طبق Git ما يستطيع، وتوقف في الملف الذي تغير فيه السطر نفسه، والرمز `UU` في `git status --short` يعني Unmerged أي تعارض لم يحل.
- `The stash entry is kept in case you need it again`: هذه هي الجملة التي تطمئنك، فpop في الوضع العادي يطبق ثم يحذف، أما عندما يتعارض فلا يحذف، والحفظ ما زال في القائمة كما يبين `git stash list`، فإذا أفسدت الحل تستطيع أن تبدأ من جديد.
- العلامات داخل الملف لها أسماء مختلفة عن الدمج: الكتلة الأولى «Updated upstream» وهي ما في الفرع الآن، والثانية حتى `>>>>>>> Stashed changes` هي ما حفظته. والأمر `sed` هنا يطبع الأسطر من أول علامة إلى آخر علامة فقط، ويبين أن الكتلتين تبدآن من سطر دالة النقاط، لأن الفرع غير القسمة على 10 إلى 5 والحفظ ما زال فيه 10، والسطران متجاوران مع دالة الاستبدال فاعتبرهما Git تعارضاً واحداً.

والحل كأي تعارض: تعدل الملف حتى يصبح كما تريد. وهنا قررنا أن نأخذ نسخة الحفظ كاملة، والخيار `--theirs` أثناء pop يعني نسخة الحفظ، ثم أخرجنا الملف من حالة التعارض دون أن نجهزه، لأنه ما زال عملاً غير مكتمل، ثم حذفنا الحفظ بأنفسنا:

```bash
git checkout --theirs cart.py
git restore --staged cart.py
git stash drop
git status --short
```

والمخرج سوف يكون كما يلي:

```bash
Updated 1 path from the index

Dropped refs/stash@{0} (60b6459863c2791d64700c893f5268a8f2319b41)

M  README.md
 M cart.py
?? notes.txt
```

رجعت الحالة إلى ما نعرفه: README مجهز، و`cart.py` معدل دون تجهيز، والملف الجديد في مكانه. والصورة التالية تلخص الخطوات:

![في الأعلى كتلة التعارض بين Updated upstream وStashed changes، وبجانبها الحالة UU cart.py والسطر stash@{0} وجملة The stash entry is kept in case you need it again، وفي الأسفل ثلاث خطوات: اختر نسخة بالأمر git checkout --theirs، ثم git restore --staged، ثم git stash drop](https://arabroot.io/content/images/2026/11/git-stash-worktree-03-pop-conflict.webp)

عند التعارض يبقى الحفظ في القائمة، وتحذفه أنت بعد أن تنتهي

ولكي تقلل هذا الموقف، استخدم `git stash apply` بدلاً من pop عندما تشك أن الفرع تغير كثيراً، فهو يطبق الحفظ ولا يحذفه أبداً، حتى عند النجاح، ثم تحذفه بالأمر drop عندما تتأكد أن كل شيء في مكانه.

### كيف يحفظ Stash من الداخل؟ Stash Internals

قلنا إن كل حفظ هو Commit، وهذه ليست استعارة، فلنطلب من Git أن يطبع الحفظ كما هو مخزن في المستودع، كما فعلنا مع Merge Commit في [Merge أم Rebase أم Squash](https://arabroot.io/articles/merge-%D8%A7%D9%85-rebase-%D8%A7%D9%85-squash-%D8%AF%D9%85%D8%AC-%D8%A7%D9%84%D9%81%D8%B1%D9%88%D8%B9-%D9%81%D9%8A-git/#three-way). حفظنا العمل غير المكتمل بالخيار `-u`، ثم نظرنا إليه:

```bash
git stash push -u -m "internals demo"
git cat-file -p stash@{0}
git log --oneline --graph -n 4 stash@{0}
```

والمخرج سوف يكون كما يلي:

```bash
Saved working directory and index state On feature/loyalty: internals demo

tree a072ae257cb26fc444b934ccd2fea59de6faaf42
parent 2411ee2e2201c8dbc59a26183a31c959bca47184
parent 2479f0e4467b45f4d009d92597243de5e51b74c6
parent 06a5f16d37c4b64935aa8b1b7738e206bd047474
author ArabRoot Team <team@example.com> 1793685660 +0300
committer ArabRoot Team <team@example.com> 1793685660 +0300

On feature/loyalty: internals demo

*-.   b4fca3e On feature/loyalty: internals demo
|\ \  
| | * 06a5f16 untracked files on feature/loyalty: 2411ee2 Double loyalty points and add redeem
| * 2479f0e index on feature/loyalty: 2411ee2 Double loyalty points and add redeem
|/  
* 2411ee2 Double loyalty points and add redeem
```

الحفظ Commit له ثلاثة آباء، وكل أب يحفظ جزءاً من حالتك: الأول 2411ee2 هو آخر Commit في الفرع وقت الحفظ، أي النقطة التي بدأت منها التعديلات. والثاني 2479f0e Commit خاص رسالته «index on» يحفظ منطقة التجهيز كما كانت، ولهذا يستطيع `pop --index` أن يرجع التجهيز. والثالث 06a5f16 رسالته «untracked files on» ويحفظ الملفات الجديدة، ولا يوجد إلا مع `-u` أو `-a`. أما الحفظ نفسه b4fca3e فيحفظ ملفات العمل. والرسم يبين هذا التركيب، والسطر الأول فيه `*-.` لأن للنقطة ثلاثة خطوط داخلة. ولماذا يهمك هذا؟ لأنه يفسر كل ما رأيناه: الحفظ لا يرتبط بفرع، فتسترجعه على أي فرع، وهو Commit عادي في المستودع، فلا يضيع عند drop وإنما يصبح معلقاً، والقائمة نفسها ليست إلا reflog لاسم واحد هو `refs/stash`، ولهذا تشبه أسماؤها `stash@{0}` أسماء reflog التي رأيناها في [التراجع عن الأخطاء في Git](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/).

### حفظ ملف واحد فقط: git stash push -- path

لا تحتاج دائماً أن تحفظ كل شيء. فإذا كان التعديل الذي يمنعك من التبديل في ملف واحد، وبقية التعديلات تريد أن تبقى أمامك، فاكتب اسم الملف بعد علامتي `--`:

```bash
git stash push -m "only cart" -- cart.py
git status --short
```

والمخرج سوف يكون كما يلي:

```bash
Saved working directory and index state On feature/loyalty: only cart

?? notes.txt
```

حفظ `cart.py` وحده، وبقي `notes.txt` في المجلد كما هو. والعلامتان `--` تخبران Git أن ما بعدهما مسارات ملفات وليس خيارات، وهي عادة جيدة في كل أمر يأخذ ملفات. وإذا أردت أن تختار أجزاء من ملف وليس الملف كله، فالخيار `-p` يعرض عليك كل جزء معدل ويسألك هل تحفظه، كما في `git add -p`.

### حذفت حفظاً بالخطأ؟ Recover a Dropped Stash

هذا خطأ حقيقي يقع فيه كثيرون: تنفذ `git stash drop` وأنت تظن أنك تحذف حفظاً قديماً لا تحتاجه، فتحذف الحفظ الذي فيه عمل اليوم. أو تنفذ `git stash clear` الذي يحذف القائمة كلها. جربناه بحفظ فيه فكرة «الشارات» ثم حذفناه:

```bash
git stash push -m "badge idea"
git stash drop
git stash list
```

والمخرج سوف يكون كما يلي:

```bash
Saved working directory and index state On feature/loyalty: badge idea

Dropped refs/stash@{0} (5b526703093e55b0ef72c933aa129463b0edd2ce)
```

القائمة فارغة. ولكن تذكر أن كل حفظ هو Commit في المستودع، والحذف أزال فقط الاسم الذي يشير إليه، تماماً كما رأينا مع الفروع في [شبكة الأمان reflog](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/#reflog). وأسرع طريق للاسترجاع موجود في الشاشة أمامك: الرقم الذي طبعه drop بين القوسين. وإذا أغلقت الشاشة، فالأمر `git fsck` يجد كل Commits المعلقة، ثم نعرضها برسائلها لنعرف أيها نريد:

```bash
git fsck --no-reflog | grep "dangling commit"
git log --oneline --no-walk $(git fsck --no-reflog | awk "/dangling commit/ {print \$3}")
git stash apply 5b52670
git diff --stat
```

والمخرج سوف يكون كما يلي، دون مخرج `git status` الذي يطبعه apply:

```bash
dangling commit 951b502c09d6481f7982ce20d0f16c81a4760292
dangling commit 436d6398fded183be3cdeec4b7049ed2e842292a
dangling commit 5b526703093e55b0ef72c933aa129463b0edd2ce
dangling commit 60b6459863c2791d64700c893f5268a8f2319b41

5b52670 On feature/loyalty: badge idea
60b6459 On feature/loyalty: redeem v2
951b502 On feature/loyalty: loyalty: redeem in progress
436d639 WIP on feature/loyalty: 5d67b93 Add loyalty points

 cart.py | 3 +++
 1 file changed, 3 insertions(+)
```

في المخرج أعلاه لاحظ التالي:

- وجد `git fsck` أربعة Commits معلقة، وهي كل الحفظات التي استرجعناها أو حذفناها في هذا المختبر، وأرقامها هي نفسها التي طبعها pop وdrop في الأقسام السابقة. والخيار `--no-reflog` يجعله يعتبر ما يشير إليه reflog فقط معلقاً أيضاً.
- الأمر الثاني يعرض هذه ال Commits برسائلها، و`--no-walk` يعني اعرض هذه ال Commits نفسها فقط ولا تمش إلى آبائها. وهنا تظهر قيمة الرسالة التي كتبتها بالخيار `-m`: «badge idea» واضحة، أما «WIP on feature/loyalty» فلا تعرف ما فيها إلا بعد أن تفتحها.
- `git stash apply` يقبل رقم أي Commit حفظ، فرجعت الدالة، و`git diff --stat` يؤكد أن ثلاثة أسطر رجعت إلى `cart.py`.

وهذه الشبكة لها حد زمني، فالكائنات المعلقة يحذفها `git gc` بعد مدة، فاسترجع ما تحتاجه فوراً.

### حفظ كبر وأصبح ميزة: git stash branch

أحياناً تحفظ فكرة صغيرة، ثم تجد بعد يومين أنها تستحق فرعاً خاصاً بها. والأمر `git stash branch` ينشئ فرعاً جديداً من ال Commit الذي حفظت عنده، ثم يطبق الحفظ عليه ويحذفه من القائمة:

```bash
git stash push -m "badge idea"
git stash branch feature/badges
git status --short
```

والمخرج سوف يكون كما يلي:

```bash
Saved working directory and index state On feature/loyalty: badge idea

Switched to a new branch 'feature/badges'
On branch feature/badges
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   cart.py

no changes added to commit (use "git add" and/or "git commit -a")
Dropped refs/stash@{0} (9572440cd0f4685a11fd01d4507021d76a204530)

 M cart.py
```

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

### حدود Stash Limits

الحفظ المؤقت ممتاز لمقاطعة قصيرة، ولكن له حدود تجعله اختياراً سيئاً للمقاطعات الطويلة. الأول أنه محلي، فلا يدفع إلى السيرفر، وإذا تعطل جهازك ضاع معه. والثاني أن القائمة سهلة النسيان، فبعد أسبوعين تجد خمسة حفظات لا تذكر ما فيها، وهذا ما حدث حتى في مختبرنا الصغير مع حفظ «WIP on feature/loyalty». والثالث أن حفظاً واحداً فقط يمكن أن يكون «مطبقاً» في المجلد في وقت واحد، فلا تستطيع أن ترى عملك والإصلاح معاً، ولا أن تشغل نسختين من البرنامج. وإذا كان الإصلاح العاجل يحتاج ساعات وليس دقائق، أو كان عليك أن تبني المشروع من جديد بعد كل تبديل، أو كانت الملفات كثيرة فيعيد محررك فهرستها كل مرة، فهنا يأتي دور الأداة الثانية.

## مجلدات العمل المتعددة Git Worktree

وقبل الأوامر، كلمة عن تاريخ هذه الأداة، لأنها تفسر لماذا لا يعرفها كثيرون: أضيف الأمر `git worktree` في Git 2.5 سنة 2015، كما أعلنت [مدونة GitHub](https://github.blog/open-source/git/git-2-5-including-multiple-worktrees-and-triangular-workflows/?ref=arabroot.io) وقتها، أي بعد أن اعتاد جيل كامل من المطورين على stash وعلى الاستنساخ الثاني، وأغلب الكتب والدورات التي كتبت قبل ذلك لا تذكره. وفي السنوات الأخيرة عاد الاهتمام به مع المحررات التي تفتح عدة مشاريع، ومع الأدوات التي تشغل أكثر من مهمة على المستودع نفسه في الوقت نفسه، لأن كل مهمة تحتاج مجلداً خاصاً بها دون أن تنسخ التاريخ.

الفكرة بسيطة: بدلاً من أن يكون للمستودع مجلد عمل واحد تبدل فيه الفروع، يعطيك [git worktree](https://git-scm.com/docs/git-worktree?ref=arabroot.io) عدة مجلدات عمل لمستودع واحد، وكل مجلد على فرع مختلف، وكلها تشترك في التاريخ نفسه. فتفتح الإصلاح العاجل في مجلد ثان، وعملك غير المكتمل باق في المجلد الأول كما تركته، دون stash ودون Commit مؤقت، وتستطيع أن تفتح المجلدين في نافذتين من المحرر، وأن تشغل البرنامج من الاثنين في الوقت نفسه. وهذا أفضل من أن تستنسخ المستودع مرة ثانية، لأن الاستنساخ الثاني ينسخ التاريخ كله، ولا يعرف فروع النسخة الأولى، أما worktree فيضيف الملفات فقط.

ونبدأ من الموقف نفسه: عملك غير مكتمل في `feature/loyalty`، ورقم الإصدار في `cart.py` أصبح `1.1.0-dev`، وGit يرفض التبديل:

```bash
git status --short
git switch main
```

والمخرج سوف يكون كما يلي:

```bash
 M cart.py
?? notes.txt

error: Your local changes to the following files would be overwritten by checkout:
	cart.py
Please commit your changes or stash them before you switch branches.
Aborting
```

### أنشئ مجلداً للإصلاح: git worktree add

بدلاً من التبديل، ننشئ مجلداً جديداً بجانب المستودع اسمه `shop-hotfix`، وفيه فرع جديد `hotfix/vat` يبدأ من main:

```bash
git worktree add -b hotfix/vat ../shop-hotfix main
git worktree list
ls ../shop-hotfix
cat ../shop-hotfix/.git
```

والمخرج سوف يكون كما يلي:

```bash
Preparing worktree (new branch 'hotfix/vat')
HEAD is now at eb15c88 Fix total for zero quantity

/work/shop        2411ee2 [feature/loyalty]
/work/shop-hotfix eb15c88 [hotfix/vat]

README.md
cart.py

gitdir: /work/shop/.git/worktrees/shop-hotfix
```

في المخرج أعلاه لاحظ التالي:

- صيغة الأمر: `git worktree add` ثم الخيار `-b` واسم الفرع الجديد، ثم مسار المجلد، ثم من أين يبدأ الفرع. وإذا كان الفرع موجوداً من قبل فتكتب اسمه مكان نقطة البداية دون `-b`.
- أنشأ Git المجلد ووضع فيه ملفات main كما هي، والسطر `HEAD is now at eb15c88` يبين أنه بدأ من آخر Commit في main، وهو إصلاح المجموع الذي دفعناه في قسم Stash.
- `git worktree list` يعرض كل مجلدات العمل: المجلد الرئيسي Main Worktree الذي استنسخناه أولاً على `feature/loyalty`، والمجلد الجديد Linked Worktree على `hotfix/vat`.
- داخل المجلد الجديد لا يوجد مجلد `.git`، وإنما ملف `.git` صغير فيه سطر واحد يشير إلى المستودع الحقيقي، وهذا كل ما يربطه به.

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

```bash
cd ../shop-hotfix
git status
git commit -qam "Round line prices"
git push -q origin hotfix/vat
git log --oneline -n 2
```

والمخرج سوف يكون كما يلي:

```bash
On branch hotfix/vat
nothing to commit, working tree clean

e6bb7c0 Round line prices
eb15c88 Fix total for zero quantity
```

كل الأوامر التي تعرفها تعمل هنا كما هي: status وcommit وpush وlog. ودفعنا الفرع إلى السيرفر لنفتح له طلب دمج. والآن نرجع إلى المجلد الأول، ونتأكد أن عملنا لم يتحرك، وأن الإصلاح معروف هنا أيضاً:

```bash
cd ../shop
git status --short
git log --oneline -n 1 hotfix/vat
git branch -a
```

والمخرج سوف يكون كما يلي:

```bash
 M cart.py
?? notes.txt

e6bb7c0 Round line prices

  feature/badges
* feature/loyalty
+ hotfix/vat
  main
  remotes/origin/feature/loyalty
  remotes/origin/hotfix/vat
  remotes/origin/main
```

هذه هي اللحظة التي تفهم فيها worktree: عملك غير المكتمل في المجلد الأول كما تركته بالضبط، لم يحفظ في أي مكان ولم يتحرك، ومع ذلك فال Commit الذي أنشأناه في المجلد الآخر قبل ثوان معروف هنا، لأن المجلدين يشتركان في المستودع نفسه. وفي `git branch -a` تظهر العلامة `*` أمام الفرع الحالي في هذا المجلد، والعلامة `+` أمام `hotfix/vat` تعني أنه مستخدم في مجلد عمل آخر.

### كيف يعمل Worktree من الداخل؟ How It Works

لكي تعمل عدة مجلدات على مستودع واحد، يجب أن يكون لكل مجلد شيئان خاصان به: HEAD الخاص به، أي على أي فرع هو، ومنطقة التجهيز الخاصة به Index، لأنك قد تجهز ملفاً في مجلد ولا تجهزه في آخر. أما ال Commits والفروع والوسوم والإعدادات فهي مشتركة. ولذلك ينشئ Git لكل مجلد إضافي مجلداً صغيراً داخل `.git/worktrees` يحفظ فيه هذه الأشياء الخاصة:

```bash
ls .git/worktrees
cat .git/worktrees/shop-hotfix/HEAD
du -sh .git ../shop-hotfix ../shop-v1 ../review
```

والمخرج سوف يكون كما يلي، بعد أن أضفنا مجلدين آخرين سوف نشرحهما بعد قليل:

```bash
review
shop-hotfix
shop-v1

ref: refs/heads/hotfix/vat

664.0K	.git
20.0K	../shop-hotfix
20.0K	../shop-v1
20.0K	../review
```

كل مجلد عمل له مجلد خاص باسمه في `.git/worktrees`، وفيه HEAD الخاص به، وفي حالة `shop-hotfix` يشير إلى `refs/heads/hotfix/vat`. والأرقام في `du` تبين الفائدة: المستودع نفسه 664K، وكل مجلد عمل إضافي 20K فقط، أي حجم الملفات دون التاريخ. والمستودع هنا صغير جداً، ولكن الفرق نفسه في مشروع تاريخه بمئات الميغابايت هو الفرق بين أن تنتظر استنساخاً كاملاً وأن يكون لك مجلد جاهز في ثوان. والصورة التالية تجمع هذا كله:

![أربعة مجلدات في الأعلى: /work/shop على feature/loyalty وفيه عملك غير المكتمل، و/work/shop-hotfix على hotfix/vat وفيه ملف .git يشير إلى المستودع، و/work/shop-v1 على v1.0.0، و/work/review لمراجعة طلب دمج، وكلها تشير بأسهم إلى المستودع الواحد /work/shop/.git بحجم 664K وفيه objects وrefs ومجلد worktrees لكل مجلد عمل](https://arabroot.io/content/images/2026/11/git-stash-worktree-04-worktree.webp)

كل مجلد عمل له HEAD وIndex خاصان به، وال Commits والفروع مشتركة بين الجميع

ومن المفيد أن تعرف بالتحديد ما المشترك وما الخاص، لأن هذا يجيب عن أسئلة كثيرة قبل أن تسألها. فبحسب [توثيق git worktree](https://git-scm.com/docs/git-worktree?ref=arabroot.io)، كل الأسماء Refs مشتركة بين مجلدات العمل، أي الفروع والوسوم وأسماء السيرفر مثل `origin/main`، ما عدا أسماء قليلة خاصة بكل مجلد، أهمها HEAD وأسماء البحث الثنائي `refs/bisect`. ونتيجة ذلك عملياً: إذا نفذت `git fetch` في أي مجلد رأت كل المجلدات ما جلبته، وإذا أنشأت فرعاً في مجلد ظهر في الآخر، والإعدادات في `.git/config` والخطافات Hooks في `.git/hooks` واحدة للجميع. وحتى قائمة الحفظ المؤقت مشتركة، لأنها مخزنة في الاسم `refs/stash`، فتستطيع أن تحفظ في مجلد وتسترجع في آخر. أما ما يخص كل مجلد فهو الفرع الذي يقف عليه، ومنطقة التجهيز، وحالة العمليات الجارية مثل دمج أو إعادة تأسيس أو بحث ثنائي توقف في المنتصف، فإذا بدأت `git bisect` في مجلد المراجعة فلن يتأثر مجلدك الرئيسي.

### قاعدة الفرع الواحد One Branch per Worktree

بما أن الفروع مشتركة، فماذا لو حاولت أن تفتح الفرع نفسه في مجلدين؟ جربنا الطريقتين: أن ننشئ مجلداً جديداً على `feature/loyalty` وهو مفتوح في المجلد الرئيسي، وأن نبدل إليه من داخل مجلد الإصلاح:

```bash
git worktree add ../shop-again feature/loyalty
cd ../shop-hotfix
git switch feature/loyalty
```

والمخرج سوف يكون كما يلي:

```bash
Preparing worktree (checking out 'feature/loyalty')
fatal: 'feature/loyalty' is already used by worktree at '/work/shop'

fatal: 'feature/loyalty' is already used by worktree at '/work/shop'
```

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

## ثلاث حالات استخدام Use Cases

رأينا الحالة الأولى، وهي الإصلاح العاجل وعملك الطويل في منتصفه. وهناك حالتان أخريان تجعلان worktree أداة يومية وليس أداة للطوارئ فقط.

### مراجعة طلب دمج Review a Pull Request

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

```bash
git fetch -q origin
git worktree add --detach ../review origin/feature/loyalty
cd ../review
git status
git log --oneline -n 2
```

والمخرج سوف يكون كما يلي:

```bash
Preparing worktree (detached HEAD 5d67b93)
HEAD is now at 5d67b93 Add loyalty points

Not currently on any branch.
nothing to commit, working tree clean

5d67b93 Add loyalty points
cecb5b7 Initial shop
```

جلبنا آخر ما على السيرفر أولاً، ثم فتحنا نسخة السيرفر من الفرع `origin/feature/loyalty` في وضع Detached، أي على Commit وليس على فرع محلي، وهذا مقصود لسببين: الفرع المحلي `feature/loyalty` مفتوح في المجلد الرئيسي فلا يمكن فتحه هنا، والمراجعة لا تحتاج فرعاً لأنك لن تلتزم بشيء. ولاحظ أن ما في السيرفر هو Commit «Add loyalty points» فقط، أما Commit مضاعفة النقاط فهو محلي عندنا لم ندفعه، وهذا بالضبط ما تريد أن تراجعه: ما دفعه صاحب الطلب. وبعد المراجعة تحذف المجلد كما سوف نرى. وفي Gitea وGitHub يمكن جلب أي طلب دمج كفرع، وقد شرحنا المراجعة نفسها في [مراجعة الكود Code Review](https://arabroot.io/articles/%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D9%83%D9%88%D8%AF-code-review-%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-pull-request-%D8%A8%D9%81%D8%A7%D8%A6%D8%AF%D8%A9/).

### تشغيل إصدارين معاً Two Versions

عميل يقول إن شيئاً كان يعمل في الإصدار 1.0.0 ولم يعد يعمل، وتريد أن تشغل النسختين جنباً إلى جنب وتقارن. ومع worktree تفتح الوسم في مجلد ثالث:

```bash
git worktree add ../shop-v1 v1.0.0
grep VERSION ../shop-v1/cart.py cart.py
```

والمخرج سوف يكون كما يلي:

```bash
Preparing worktree (detached HEAD cecb5b7)
HEAD is now at cecb5b7 Initial shop

../shop-v1/cart.py:VERSION = "1.0.0"
cart.py:VERSION = "1.1.0-dev"
```

الملفان موجودان الآن في الوقت نفسه: الإصدار 1.0.0 في مجلد، والتطوير الحالي في مجلد آخر، وتستطيع أن تشغل كل واحد على منفذ مختلف وتقارن السلوك. وعندما تجد أن الخطأ ظهر بين الإصدارين ولا تعرف أي Commit أدخله، فالأداة التالية هي `git bisect` التي شرحناها في [Cherry-pick مع git bisect](https://arabroot.io/articles/cherry-pick-%D9%85%D8%B9-git-bisect-%D9%86%D9%82%D9%84-%D8%A7%D9%84%D8%A7%D8%B5%D9%84%D8%A7%D8%AD-%D9%88%D8%A7%D9%8A%D8%AC%D8%A7%D8%AF-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7/). وهذه الحالة شائعة أيضاً مع المشاريع التي تحتاج بناء طويلاً، فتبقي مجلداً على main مبنياً وجاهزاً للمقارنة، دون أن تعيد البناء كلما بدلت الفرع.

## إنهاء مجلد العمل Worktree Cleanup

مجلد العمل الإضافي ليس مجلداً عادياً، فGit يتذكره في `.git/worktrees`، لذلك احذفه بالأمر المخصص وليس بحذف المجلد. ولكي نرى ماذا يحدث إذا نسيت شيئاً فيه، أنشأنا ملفاً مؤقتاً في مجلد الإصلاح قبل الحذف:

```bash
git worktree remove ../shop-hotfix
rm ../shop-hotfix/scratch.txt
git worktree remove ../shop-hotfix
git branch --list "hotfix/*"
```

والمخرج سوف يكون كما يلي:

```bash
fatal: '../shop-hotfix' contains modified or untracked files, use --force to delete it

  hotfix/vat
```

رفض Git الحذف الأول لأن في المجلد ملفاً لم يحفظ في أي Commit، وهذه حماية تمنعك من أن تخسر عملاً في مجلد نسيته. وبعد أن حذفنا الملف نجح الحذف دون أي رسالة. ولاحظ أن الفرع `hotfix/vat` ما زال موجوداً، لأن الفروع في المستودع وليس في المجلد، فإذا دمج الطلب احذف الفرع بالأمر `git branch -d` كالمعتاد. أما الخيار `--force` فيحذف المجلد ومعه أي تعديلات فيه، فاستخدمه فقط إذا كنت متأكداً.

والخطأ الشائع الآخر أن تحذف المجلد بيدك من مدير الملفات أو بالأمر `rm -rf`، كما فعلنا عمداً مع مجلد المراجعة:

```bash
rm -rf ../review
git worktree list
git worktree prune -v
```

والمخرج سوف يكون كما يلي:

```bash
/work/shop    2411ee2 [feature/loyalty]
/work/review  5d67b93 (detached HEAD) prunable
/work/shop-v1 cecb5b7 (detached HEAD)

Removing worktrees/review: gitdir file points to non-existent location
```

Git ما زال يتذكر المجلد المحذوف، ويضع بجانبه كلمة `prunable` أي قابل للتنظيف. والأمر `git worktree prune` يزيل من `.git/worktrees` كل مجلد لم يعد موجوداً، والخيار `-v` يطبع ما أزاله. وهذا مهم إذا كان المجلد المحذوف على فرع، لأن Git سوف يرفض فتح ذلك الفرع في مكان آخر حتى ينظف السجل. وGit ينظف هذه السجلات تلقائياً بعد مدة أيضاً، ولكن لا تعتمد على ذلك.

وماذا لو كان مجلد العمل على قرص خارجي أو مجلد شبكة يفصل أحياناً؟ عندها قد يظن Git أنه حذف فينظفه. والأمر `lock` يمنع ذلك:

```bash
git worktree lock --reason "on USB disk" ../shop-v1
git worktree list --verbose
git worktree unlock ../shop-v1
git worktree remove ../shop-v1
git worktree list
```

والمخرج سوف يكون كما يلي:

```bash
/work/shop    2411ee2 [feature/loyalty]
/work/shop-v1 cecb5b7 (detached HEAD)
	locked: on USB disk

/work/shop 2411ee2 [feature/loyalty]
```

الخيار `--verbose` يعرض سبب القفل، ثم فككنا القفل وحذفنا المجلد، فبقي المجلد الرئيسي وحده كما بدأنا. والمجلد المقفل لا يحذف حتى بالأمر `remove` العادي، وهذا هو المقصود من القفل. والصورة التالية تلخص دورة الحياة كاملة بالرسائل التي رأيناها:

![في الأعلى أربع خطوات: أنشئ بالأمر git worktree add، واعرض بالأمر git worktree list، واعمل وادفع، واحذف بالأمر git worktree remove، وتحتها أربع لوحات: فرع واحد في مجلد واحد فقط مع رسالة already used by worktree، وremove يرفض ما لم يحفظ، وprune لمجلد حذفته بيدك، وlock لمجلد على قرص خارجي](https://arabroot.io/content/images/2026/11/git-stash-worktree-05-worktree-life.webp)

أنشئ واعمل واحذف بأوامر worktree نفسها، ولا تحذف المجلد بيدك

وهناك أمران آخران تحتاجهما أحياناً: `git worktree move` لنقل مجلد عمل إلى مسار آخر دون أن يضيع ارتباطه بالمستودع، و`git worktree repair` لإصلاح الارتباط إذا نقلت المجلد أو المستودع بيدك. وتفاصيلهما في التوثيق الرسمي.

## نصائح عملية مع Worktree Tips

- **رتب المجلدات بجانب المستودع:** ضعها في مجلد أب واحد بأسماء واضحة مثل `shop` و`shop-hotfix` و`shop-review`، ولا تضعها داخل مجلد المستودع نفسه، وإلا ظهرت لGit كملفات جديدة.
- **كل مجلد يحتاج تجهيزه:** المجلد الجديد فيه الملفات المتتبعة فقط، فالمكتبات المثبتة مثل `node_modules` وملفات `.env` المتجاهلة غير موجودة فيه، وتحتاج أن تثبتها أو تنسخها.
- **المحرر:** افتح كل مجلد في نافذة مستقلة، فأغلب المحررات تقرأ الفرع من المجلد نفسه وتعرضه بشكل صحيح.
- **انتبه للصيغة المختصرة:** إذا كتبت `git worktree add ../hotfix` دون فرع ودون `--detach`، فإن Git ينشئ فرعاً جديداً باسم المجلد نفسه، أي `hotfix`، من الفرع الحالي، كما يذكر التوثيق. وهذا مريح أحياناً، ولكنه قد يبدأ الإصلاح من فرع الميزة بدلاً من main دون أن تنتبه، لذلك اكتب نقطة البداية دائماً.
- **اعرف في أي مجلد أنت:** أكثر خطأ يقع فيه من يستخدم worktree أول مرة أن ينفذ الأمر في النافذة الخطأ، فيلتزم بالإصلاح في مجلد الميزة. اجعل اسم الفرع ظاهراً في سطر الأوامر، أو نفذ `git status` قبل كل Commit.
- **أغلق ما انتهيت منه:** نفذ `git worktree list` من وقت لآخر، فالمجلدات المنسية تحجز فروعها وتمنعك من فتحها في مكان آخر.

## الطريقة الثالثة: Commit مؤقت WIP Commit

قبل المقارنة، لا نريد أن نترك انطباعاً أن Commit المؤقت خطأ، فهو أحياناً أفضل الثلاثة. وموقفه الطبيعي نهاية يوم العمل: عملك غير مكتمل، ولا تريد أن يبقى على جهازك وحده في stash قد تنساه أو يضيع مع القرص. فتنشئ Commit برسالة واضحة أنه مؤقت، وتدفعه إلى فرعك الشخصي، وفي اليوم التالي تفكه وتكمل:

```bash
git add -A
git commit -qm "WIP: redeem (do not merge)"
git log --oneline -n 2
git reset --soft HEAD~1
git status --short
```

والمخرج سوف يكون كما يلي:

```bash
0f959d9 WIP: redeem (do not merge)
2411ee2 Double loyalty points and add redeem

M  cart.py
A  notes.txt
```

ال Commit المؤقت دخل الفرع فوق آخر Commit حقيقي، ثم فككناه بالأمر `git reset --soft HEAD~1`، فرجع الفرع خطوة، وبقيت كل التعديلات مجهزة كما يبين العمود الأول، و`A` تعني ملفاً جديداً أضيف. وقد شرحنا أنواع reset بالتفصيل في [التراجع عن الأخطاء في Git](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/#reset). وانتبه لشرط واحد: إذا كنت قد دفعت ال Commit المؤقت، ففكه بهذه الطريقة يعيد كتابة فرعك، فتحتاج دفعاً بالقوة الآمنة إلى فرعك الشخصي، أو أن تتركه وترتبه مع غيره بإعادة التأسيس التفاعلية قبل طلب الدمج. والرسالة التي تبدأ بالكلمة WIP وتقول «do not merge» تنبه أي مراجع أن هذا ليس عملاً جاهزاً، وبعض الفرق تضبط المنصة حتى ترفض دمج طلب فيه Commit بهذه الكلمة.

## Stash أم Worktree؟ المقارنة Comparison

بعد أن جربنا الاثنين، نضعهما بجانب الطريقتين اللتين يلجأ إليهما المبتدئ عادة: Commit مؤقت يسمى WIP، واستنساخ ثان للمستودع:

![جدول بأربعة أعمدة: Commit مؤقت يبقى في الفرع ولا تكلفة له ويحتاج ترتيباً قبل الطلب ويناسب نهاية يوم العمل، وgit stash قائمة محلية دون تكلفة وسهل أن تنساه ويناسب المقاطعة القصيرة، وgit worktree مجلد ثان والتاريخ مشترك وتكلفته حجم الملفات فقط ولا يفتح الفرع إلا في مجلد واحد ويناسب المهمة الطويلة أو تشغيل نسختين، وgit clone مستودع مستقل ينسخ التاريخ مرة ثانية والفروع لا تظهر بين النسختين](https://arabroot.io/content/images/2026/11/git-stash-worktree-06-compare.webp)

مقاطعة دقائق تحتاج stash، ومهمة ساعات أو نسختان معاً تحتاج worktree

| الموقف                                       | الأنسب                            | السبب                                    |
| -------------------------------------------- | --------------------------------- | ---------------------------------------- |
| زميل يسألك سؤالاً وتحتاج أن ترى main دقيقتين | git stash                         | أسرع شيء، وترجع فوراً                    |
| إصلاح عاجل قد يستغرق ساعات ومراجعة           | git worktree                      | عملك يبقى كما هو، والإصلاح في مجلد مستقل |
| مراجعة طلب دمج وتشغيله                       | git worktree --detach             | لا تلمس عملك، وتحذف المجلد بعدها         |
| مقارنة إصدارين يعملان معاً                   | git worktree على وسم              | نسختان على القرص في الوقت نفسه           |
| نهاية اليوم والعمل غير مكتمل                 | Commit مؤقت تدفعه إلى فرعك        | محفوظ على السيرفر، وترتبه قبل الطلب      |
| بدأت تعديلاً على الفرع الخطأ                 | git stash ثم pop على الفرع الصحيح | الحفظ لا يرتبط بفرع                      |

وفي الجدول أعلاه، لاحظ أن Commit المؤقت ليس خطأ بحد ذاته، فهو أأمن من stash لأنك تستطيع أن تدفعه، والمشكلة فقط أن يصل إلى طلب الدمج كما هو، وقد شرحنا كيف ترتب هذه ال Commits قبل الطلب في [إعادة التأسيس التفاعلية](https://arabroot.io/articles/merge-%D8%A7%D9%85-rebase-%D8%A7%D9%85-squash-%D8%AF%D9%85%D8%AC-%D8%A7%D9%84%D9%81%D8%B1%D9%88%D8%B9-%D9%81%D9%8A-git/#interactive-rebase).

## أخطاء شائعة Common Mistakes

- **stash دون -u:** يبقى الملف الجديد في المجلد، وقد يدخل في Commit الإصلاح على الفرع الآخر.
- **pop دون --index:** يرجع التعديلات المجهزة غير مجهزة، فراجع `git status` قبل ال Commit التالي.
- **حفظات دون رسائل:** بعد أيام تصبح «WIP on feature» قائمة لا تعرف ما فيها، فاكتب دائماً `-m`.
- **drop أو clear بالخطأ:** الرقم المطبوع أو `git fsck` ينقذك، ولكن بسرعة قبل أن ينظف Git.
- **حذف مجلد worktree بيدك:** يبقى سجله ويحجز فرعه، فنفذ `git worktree prune`، والأفضل أن تحذف بالأمر `remove`.
- **مجلد worktree داخل مجلد المستودع:** يظهر كملفات جديدة، فضعه بجانبه.
- **نسيان أن الفرع في مجلد آخر:** رسالة `already used by worktree` تخبرك أين، فاذهب إليه هناك أو احذف ذلك المجلد.

## الموقف والأمر Cheat Sheet

| الموقف                                     | الأمر                                                           |
| ------------------------------------------ | --------------------------------------------------------------- |
| حفظ كل التعديلات مع الملفات الجديدة برسالة | git stash push -u -m "وصف"                                      |
| عرض القائمة ومحتوى حفظ                     | git stash list وgit stash show -p --include-untracked stash@{0} |
| استرجاع الأحدث وحذفه                       | git stash pop، ومع التجهيز git stash pop --index                |
| استرجاع حفظ دون حذفه                       | git stash apply stash@{1}                                       |
| حذف حفظ                                    | git stash drop stash@{1}                                        |
| استرجاع حفظ حذفته                          | git stash apply <hash> من رسالة drop أو git fsck --no-reflog    |
| تحويل حفظ إلى فرع                          | git stash branch feature/x                                      |
| مجلد عمل جديد بفرع جديد                    | git worktree add -b hotfix/x ../shop-hotfix main                |
| مجلد عمل لمراجعة فرع على السيرفر           | git worktree add --detach ../review origin/feature/x            |
| مجلد عمل على وسم إصدار                     | git worktree add ../shop-v1 v1.0.0                              |
| عرض مجلدات العمل                           | git worktree list                                               |
| حذف مجلد عمل                               | git worktree remove ../shop-hotfix                              |
| تنظيف سجل مجلد حذفته بيدك                  | git worktree prune -v                                           |
| حماية مجلد على قرص خارجي                   | git worktree lock --reason "…" ../path                          |

## تدريب عملي Practice

1. في مستودع فيه فرع ميزة، اصنع الأنواع الأربعة من التعديلات: ملف معدل، وملف مجهز، وملف جديد، وملف متجاهل. ثم نفذ `git stash` و`git stash -u` و`git stash -a` كل مرة، وقارن `git status --short --ignored` بعد كل واحد.
2. احفظ تعديلاً، ثم غير السطر نفسه في Commit، ثم نفذ `git stash pop`، وحل التعارض، وتأكد أن الحفظ بقي في القائمة حتى حذفته.
3. احذف حفظاً بالأمر drop، ثم استرجعه مرة بالرقم المطبوع، ومرة بالأمر `git fsck --no-reflog`.
4. أنشئ مجلد عمل لإصلاح عاجل على فرع جديد من main، وأنشئ فيه Commit، وتأكد من المجلد الأول أن ال Commit معروف وأن عملك لم يتحرك، ثم احذف المجلد بالأمر remove.
5. افتح وسماً قديماً في مجلد عمل، ثم احذف المجلد بالأمر `rm -rf`، وانظر إلى `git worktree list`، ثم نظفه بالأمر prune.

## ماذا تقرأ بعد ذلك؟ Next Steps

[![](https://arabroot.io/content/images/2026/11/git-merge-rebase-cover-cover.webp)دليلMerge أم Rebase أم Squash؟ دمج الفروع في Git خطوة بخطوةثلاث طرق لإدخال عمل فرعك إلى main، نجربها على المستودع نفسه حتى ترى بعينك ماذا تفعل كل واحدة بالتاريخ، ومتى تختارها، وكيف تحل التعارض في كل منها.](https://arabroot.io/articles/merge-%D8%A7%D9%85-rebase-%D8%A7%D9%85-squash-%D8%AF%D9%85%D8%AC-%D8%A7%D9%84%D9%81%D8%B1%D9%88%D8%B9-%D9%81%D9%8A-git/)[![](https://arabroot.io/content/images/2026/11/git-undo-cover-cover.webp)دليلالتراجع عن الأخطاء في Git: revert أم reset أم restore؟لكل خطأ في Git أمر تراجع يناسب المكان الذي وصل إليه، وهنا تتعلم أن تختاره بسؤال واحد، وأن تسترجع عملاً ظننت أنه ضاع.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/)[![](https://arabroot.io/content/images/2026/11/git-cherry-pick-bisect-cover-cover.webp)دليلCherry-pick مع git bisect: نقل الإصلاح وإيجاد الخطأكيف تنقل إصلاحاً واحداً إلى الإصدار الذي يعمل عند العميل دون بقية التغييرات وتضع له وسماً، وكيف تجد الـ Commit الذي أدخل الخطأ بين عشرات الـ Commits في دقائق.](https://arabroot.io/articles/cherry-pick-%D9%85%D8%B9-git-bisect-%D9%86%D9%82%D9%84-%D8%A7%D9%84%D8%A7%D8%B5%D9%84%D8%A7%D8%AD-%D9%88%D8%A7%D9%8A%D8%AC%D8%A7%D8%AF-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7/)[![](https://arabroot.io/content/images/2026/11/code-review-basics-cover-cover.webp)دليلمراجعة الكود Code Review: كيف تراجع Pull Request بفائدةكيف تفتح طلب دمج يسهل على زميلك مراجعته، وكيف تراجع طلب غيرك بتعليقات تحسن الكود دون أن تتحول إلى موافقة شكلية أو جدال، مع حماية الفرع main في Gitea.](https://arabroot.io/articles/%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D9%83%D9%88%D8%AF-code-review-%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-pull-request-%D8%A8%D9%81%D8%A7%D8%A6%D8%AF%D8%A9/)

بعد أن تدفع الإصلاح العاجل، قد تحتاج أن تنقله إلى فرع إصدار قديم عند عميل، وهذا موضوع [Cherry-pick مع git bisect](https://arabroot.io/articles/cherry-pick-%D9%85%D8%B9-git-bisect-%D9%86%D9%82%D9%84-%D8%A7%D9%84%D8%A7%D8%B5%D9%84%D8%A7%D8%AD-%D9%88%D8%A7%D9%8A%D8%AC%D8%A7%D8%AF-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7/). وإذا ضاع منك شيء أثناء التبديل بين المهام فاقرأ [التراجع عن الأخطاء في Git](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D8%A7%D8%AC%D8%B9-%D8%B9%D9%86-%D8%A7%D9%84%D8%A7%D8%AE%D8%B7%D8%A7%D8%A1-%D9%81%D9%8A-git-revert-%D8%A7%D9%85-reset-%D8%A7%D9%85-restore/)، وطرق إدخال الإصلاح إلى main في [Merge أم Rebase أم Squash](https://arabroot.io/articles/merge-%D8%A7%D9%85-rebase-%D8%A7%D9%85-squash-%D8%AF%D9%85%D8%AC-%D8%A7%D9%84%D9%81%D8%B1%D9%88%D8%B9-%D9%81%D9%8A-git/). والخريطة الكاملة لهذه المقالات في [Git في العمل اليومي](https://arabroot.io/articles/git-merge-%D9%88-rebase-%D9%88-cherry-pick/).

## الخلاصة Summary

- Git يرفض تبديل الفرع فقط عندما يحتاج أن يكتب فوق ملف فيه تعديلات غير محفوظة، وإلا نقل تعديلاتك معك إلى الفرع الآخر.
- `git stash push -u -m` يحفظ كل شيء غير متجاهل برسالة واضحة، و`pop` يرجعه ويحذفه، و`--index` يرجع التجهيز كما كان، و`apply` يرجعه دون حذف.
- عند تعارض pop يبقى الحفظ في القائمة، وكل حفظ Commit يمكن استرجاعه برقمه حتى بعد drop، لمدة محدودة.
- `git worktree` يعطي المستودع الواحد عدة مجلدات عمل، لكل مجلد HEAD وIndex خاصان، والتاريخ والفروع والإعدادات وقائمة الحفظ مشتركة، وكل مجلد إضافي بحجم الملفات فقط، فهو أخف بكثير من استنساخ ثان.
- الفرع الواحد يفتح في مجلد واحد فقط، وللمراجعة أو الإصدار القديم استخدم `--detach` أو الوسم.
- احذف مجلد العمل بالأمر `remove`، ونظف ما حذفته بيدك بالأمر `prune`، واقفل ما كان على قرص خارجي.
- مقاطعة دقائق: stash. مهمة ساعات أو نسختان معاً: worktree. نهاية يوم: Commit مؤقت على فرعك.

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، وتنفيذ كل الأمثلة على git 2.54.0 داخل Container من alpine:3.24، مع مستودع Bare محلي يعمل كسيرفر. ويأخذ المقال قسم الحفظ المؤقت من دليل Git في العمل اليومي بعد تقسيمه إلى أربعة مقالات، ويضيف إليه Worktree.