أنت في منتصف ميزة نقاط الولاء في متجر إلكتروني: دالة الاستبدال نصف مكتوبة وفيها 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 من جهة أوامر الدفع والجلب:
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 "[email protected]"
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. وكل أوامر البناء في ملف المختبر مع المقال. هذه هي الحالة:
git status --shortوالمخرج سوف يكون كما يلي:
M README.md
M cart.py
?? notes.txtتذكر قراءة هذه الصيغة: لكل ملف عمودان، الأول لمنطقة التجهيز والثاني لملفات العمل. فالسطر M README.md يعني تعديلاً مجهزاً، و M cart.py تعديلاً غير مجهز، و?? ملفاً جديداً لا يتتبعه Git. أما debug.log فلا يظهر أصلاً لأنه متجاهل. وهذه الأنواع الأربعة مهمة، لأن كل أداة في هذا المقال تتعامل معها بطريقة مختلفة.
لماذا يرفض Git تبديل الفرع؟ Switch Blocked
نحاول الانتقال إلى main كما يفعل أي شخص:
git switch mainوالمخرج سوف يكون كما يلي:
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 يأخذ تعديلاتك غير الملتزم بها، ويحفظها في مكان خاص داخل المستودع، ثم يرجع ملفاتك إلى حالة آخر Commit، فيصبح المجلد نظيفاً وتستطيع أن تبدل الفرع. وما يحفظه يبقى في قائمة، والأحدث في أعلاها، ثم ترجعه متى شئت. وفي الداخل كل حفظ هو Commit خاص لا ينتمي إلى أي فرع، ولهذا لا يضيع بسهولة كما سوف نرى. والصورة التالية تبين الفكرة:

أول محاولة: git stash دون خيارات
git stash
git status --shortوالمخرج سوف يكون كما يلي:
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فسوف يدخل ملف ملاحظاتك في إصلاح لا علاقة له به.
نرجع التعديلات ونرى ماذا رجع:
git stash pop
git status --shortوالمخرج سوف يكون كما يلي، بعد مخرج git status الطويل الذي يطبعه pop بنفسه:
Dropped refs/stash@{0} (436d6398fded183be3cdeec4b7049ed2e842292a)
M README.md
M cart.py
?? notes.txtرجعت التعديلات، وحذف الحفظ من القائمة، ورقمه 436d639 مطبوع في السطر، وسوف نحتاج هذه المعلومة لاحقاً. ولكن انظر جيداً إلى README: كان M README.md أي مجهزاً، وأصبح M README.md أي غير مجهز. وهذه نقطة لا ينتبه لها كثيرون: pop يرجع التعديلات إلى الملفات، ولكنه لا يرجع حالة التجهيز إلا إذا طلبت ذلك بالخيار --index. وقد جربنا ذلك في مستودع صغير منفصل فيه ملف مجهز:
git status --short --ignored
git stash push -q
git stash pop -q --index
git status --short --ignoredوالمخرج سوف يكون كما يلي:
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 لرسالة تصف العمل:
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والمخرج سوف يكون كما يلي:
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 معاً في الحفظ عندما استخدمناه:

الإصلاح العاجل مع Stash Hotfix
المجلد نظيف، فننتقل إلى main، ونصلح المجموع حتى يتجاهل المنتجات التي كميتها صفر، وندفع، ثم نرجع ونسترجع عملنا:
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:
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 بقيمة أخرى، ثم استرجعنا:
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والمخرج سوف يكون كما يلي:
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 يعني نسخة الحفظ، ثم أخرجنا الملف من حالة التعارض دون أن نجهزه، لأنه ما زال عملاً غير مكتمل، ثم حذفنا الحفظ بأنفسنا:
git checkout --theirs cart.py
git restore --staged cart.py
git stash drop
git status --shortوالمخرج سوف يكون كما يلي:
Updated 1 path from the index
Dropped refs/stash@{0} (60b6459863c2791d64700c893f5268a8f2319b41)
M README.md
M cart.py
?? notes.txtرجعت الحالة إلى ما نعرفه: README مجهز، وcart.py معدل دون تجهيز، والملف الجديد في مكانه. والصورة التالية تلخص الخطوات:

ولكي تقلل هذا الموقف، استخدم git stash apply بدلاً من pop عندما تشك أن الفرع تغير كثيراً، فهو يطبق الحفظ ولا يحذفه أبداً، حتى عند النجاح، ثم تحذفه بالأمر drop عندما تتأكد أن كل شيء في مكانه.
كيف يحفظ Stash من الداخل؟ Stash Internals
قلنا إن كل حفظ هو Commit، وهذه ليست استعارة، فلنطلب من Git أن يطبع الحفظ كما هو مخزن في المستودع، كما فعلنا مع Merge Commit في Merge أم Rebase أم Squash. حفظنا العمل غير المكتمل بالخيار -u، ثم نظرنا إليه:
git stash push -u -m "internals demo"
git cat-file -p stash@{0}
git log --oneline --graph -n 4 stash@{0}والمخرج سوف يكون كما يلي:
Saved working directory and index state On feature/loyalty: internals demo
tree a072ae257cb26fc444b934ccd2fea59de6faaf42
parent 2411ee2e2201c8dbc59a26183a31c959bca47184
parent 2479f0e4467b45f4d009d92597243de5e51b74c6
parent 06a5f16d37c4b64935aa8b1b7738e206bd047474
author ArabRoot Team <[email protected]> 1793685660 +0300
committer ArabRoot Team <[email protected]> 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.
حفظ ملف واحد فقط: git stash push -- path
لا تحتاج دائماً أن تحفظ كل شيء. فإذا كان التعديل الذي يمنعك من التبديل في ملف واحد، وبقية التعديلات تريد أن تبقى أمامك، فاكتب اسم الملف بعد علامتي --:
git stash push -m "only cart" -- cart.py
git status --shortوالمخرج سوف يكون كما يلي:
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 الذي يحذف القائمة كلها. جربناه بحفظ فيه فكرة «الشارات» ثم حذفناه:
git stash push -m "badge idea"
git stash drop
git stash listوالمخرج سوف يكون كما يلي:
Saved working directory and index state On feature/loyalty: badge idea
Dropped refs/stash@{0} (5b526703093e55b0ef72c933aa129463b0edd2ce)القائمة فارغة. ولكن تذكر أن كل حفظ هو Commit في المستودع، والحذف أزال فقط الاسم الذي يشير إليه، تماماً كما رأينا مع الفروع في شبكة الأمان reflog. وأسرع طريق للاسترجاع موجود في الشاشة أمامك: الرقم الذي طبعه drop بين القوسين. وإذا أغلقت الشاشة، فالأمر git fsck يجد كل Commits المعلقة، ثم نعرضها برسائلها لنعرف أيها نريد:
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:
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 الذي حفظت عنده، ثم يطبق الحفظ عليه ويحذفه من القائمة:
git stash push -m "badge idea"
git stash branch feature/badges
git status --shortوالمخرج سوف يكون كما يلي:
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 وقتها، أي بعد أن اعتاد جيل كامل من المطورين على stash وعلى الاستنساخ الثاني، وأغلب الكتب والدورات التي كتبت قبل ذلك لا تذكره. وفي السنوات الأخيرة عاد الاهتمام به مع المحررات التي تفتح عدة مشاريع، ومع الأدوات التي تشغل أكثر من مهمة على المستودع نفسه في الوقت نفسه، لأن كل مهمة تحتاج مجلداً خاصاً بها دون أن تنسخ التاريخ.
الفكرة بسيطة: بدلاً من أن يكون للمستودع مجلد عمل واحد تبدل فيه الفروع، يعطيك git worktree عدة مجلدات عمل لمستودع واحد، وكل مجلد على فرع مختلف، وكلها تشترك في التاريخ نفسه. فتفتح الإصلاح العاجل في مجلد ثان، وعملك غير المكتمل باق في المجلد الأول كما تركته، دون stash ودون Commit مؤقت، وتستطيع أن تفتح المجلدين في نافذتين من المحرر، وأن تشغل البرنامج من الاثنين في الوقت نفسه. وهذا أفضل من أن تستنسخ المستودع مرة ثانية، لأن الاستنساخ الثاني ينسخ التاريخ كله، ولا يعرف فروع النسخة الأولى، أما worktree فيضيف الملفات فقط.
ونبدأ من الموقف نفسه: عملك غير مكتمل في feature/loyalty، ورقم الإصدار في cart.py أصبح 1.1.0-dev، وGit يرفض التبديل:
git status --short
git switch mainوالمخرج سوف يكون كما يلي:
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:
git worktree add -b hotfix/vat ../shop-hotfix main
git worktree list
ls ../shop-hotfix
cat ../shop-hotfix/.gitوالمخرج سوف يكون كما يلي:
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صغير فيه سطر واحد يشير إلى المستودع الحقيقي، وهذا كل ما يربطه به.
والآن ننتقل إلى المجلد الجديد ونعمل فيه كأي مستودع عادي. والإصلاح هنا تقريب سعر كل سطر في الفاتورة إلى منزلتين عشريتين:
cd ../shop-hotfix
git status
git commit -qam "Round line prices"
git push -q origin hotfix/vat
git log --oneline -n 2والمخرج سوف يكون كما يلي:
On branch hotfix/vat
nothing to commit, working tree clean
e6bb7c0 Round line prices
eb15c88 Fix total for zero quantityكل الأوامر التي تعرفها تعمل هنا كما هي: status وcommit وpush وlog. ودفعنا الفرع إلى السيرفر لنفتح له طلب دمج. والآن نرجع إلى المجلد الأول، ونتأكد أن عملنا لم يتحرك، وأن الإصلاح معروف هنا أيضاً:
cd ../shop
git status --short
git log --oneline -n 1 hotfix/vat
git branch -aوالمخرج سوف يكون كما يلي:
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 يحفظ فيه هذه الأشياء الخاصة:
ls .git/worktrees
cat .git/worktrees/shop-hotfix/HEAD
du -sh .git ../shop-hotfix ../shop-v1 ../reviewوالمخرج سوف يكون كما يلي، بعد أن أضفنا مجلدين آخرين سوف نشرحهما بعد قليل:
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 فقط، أي حجم الملفات دون التاريخ. والمستودع هنا صغير جداً، ولكن الفرق نفسه في مشروع تاريخه بمئات الميغابايت هو الفرق بين أن تنتظر استنساخاً كاملاً وأن يكون لك مجلد جاهز في ثوان. والصورة التالية تجمع هذا كله:

ومن المفيد أن تعرف بالتحديد ما المشترك وما الخاص، لأن هذا يجيب عن أسئلة كثيرة قبل أن تسألها. فبحسب توثيق git worktree، كل الأسماء Refs مشتركة بين مجلدات العمل، أي الفروع والوسوم وأسماء السيرفر مثل origin/main، ما عدا أسماء قليلة خاصة بكل مجلد، أهمها HEAD وأسماء البحث الثنائي refs/bisect. ونتيجة ذلك عملياً: إذا نفذت git fetch في أي مجلد رأت كل المجلدات ما جلبته، وإذا أنشأت فرعاً في مجلد ظهر في الآخر، والإعدادات في .git/config والخطافات Hooks في .git/hooks واحدة للجميع. وحتى قائمة الحفظ المؤقت مشتركة، لأنها مخزنة في الاسم refs/stash، فتستطيع أن تحفظ في مجلد وتسترجع في آخر. أما ما يخص كل مجلد فهو الفرع الذي يقف عليه، ومنطقة التجهيز، وحالة العمليات الجارية مثل دمج أو إعادة تأسيس أو بحث ثنائي توقف في المنتصف، فإذا بدأت git bisect في مجلد المراجعة فلن يتأثر مجلدك الرئيسي.
قاعدة الفرع الواحد One Branch per Worktree
بما أن الفروع مشتركة، فماذا لو حاولت أن تفتح الفرع نفسه في مجلدين؟ جربنا الطريقتين: أن ننشئ مجلداً جديداً على feature/loyalty وهو مفتوح في المجلد الرئيسي، وأن نبدل إليه من داخل مجلد الإصلاح:
git worktree add ../shop-again feature/loyalty
cd ../shop-hotfix
git switch feature/loyaltyوالمخرج سوف يكون كما يلي:
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 فتفتح الطلب في مجلد مؤقت:
git fetch -q origin
git worktree add --detach ../review origin/feature/loyalty
cd ../review
git status
git log --oneline -n 2والمخرج سوف يكون كما يلي:
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.
تشغيل إصدارين معاً Two Versions
عميل يقول إن شيئاً كان يعمل في الإصدار 1.0.0 ولم يعد يعمل، وتريد أن تشغل النسختين جنباً إلى جنب وتقارن. ومع worktree تفتح الوسم في مجلد ثالث:
git worktree add ../shop-v1 v1.0.0
grep VERSION ../shop-v1/cart.py cart.pyوالمخرج سوف يكون كما يلي:
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. وهذه الحالة شائعة أيضاً مع المشاريع التي تحتاج بناء طويلاً، فتبقي مجلداً على main مبنياً وجاهزاً للمقارنة، دون أن تعيد البناء كلما بدلت الفرع.
إنهاء مجلد العمل Worktree Cleanup
مجلد العمل الإضافي ليس مجلداً عادياً، فGit يتذكره في .git/worktrees، لذلك احذفه بالأمر المخصص وليس بحذف المجلد. ولكي نرى ماذا يحدث إذا نسيت شيئاً فيه، أنشأنا ملفاً مؤقتاً في مجلد الإصلاح قبل الحذف:
git worktree remove ../shop-hotfix
rm ../shop-hotfix/scratch.txt
git worktree remove ../shop-hotfix
git branch --list "hotfix/*"والمخرج سوف يكون كما يلي:
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، كما فعلنا عمداً مع مجلد المراجعة:
rm -rf ../review
git worktree list
git worktree prune -vوالمخرج سوف يكون كما يلي:
/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 locationGit ما زال يتذكر المجلد المحذوف، ويضع بجانبه كلمة prunable أي قابل للتنظيف. والأمر git worktree prune يزيل من .git/worktrees كل مجلد لم يعد موجوداً، والخيار -v يطبع ما أزاله. وهذا مهم إذا كان المجلد المحذوف على فرع، لأن Git سوف يرفض فتح ذلك الفرع في مكان آخر حتى ينظف السجل. وGit ينظف هذه السجلات تلقائياً بعد مدة أيضاً، ولكن لا تعتمد على ذلك.
وماذا لو كان مجلد العمل على قرص خارجي أو مجلد شبكة يفصل أحياناً؟ عندها قد يظن Git أنه حذف فينظفه. والأمر lock يمنع ذلك:
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والمخرج سوف يكون كما يلي:
/work/shop 2411ee2 [feature/loyalty]
/work/shop-v1 cecb5b7 (detached HEAD)
locked: on USB disk
/work/shop 2411ee2 [feature/loyalty]الخيار --verbose يعرض سبب القفل، ثم فككنا القفل وحذفنا المجلد، فبقي المجلد الرئيسي وحده كما بدأنا. والمجلد المقفل لا يحذف حتى بالأمر remove العادي، وهذا هو المقصود من القفل. والصورة التالية تلخص دورة الحياة كاملة بالرسائل التي رأيناها:

وهناك أمران آخران تحتاجهما أحياناً: 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 برسالة واضحة أنه مؤقت، وتدفعه إلى فرعك الشخصي، وفي اليوم التالي تفكه وتكمل:
git add -A
git commit -qm "WIP: redeem (do not merge)"
git log --oneline -n 2
git reset --soft HEAD~1
git status --shortوالمخرج سوف يكون كما يلي:
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. وانتبه لشرط واحد: إذا كنت قد دفعت ال Commit المؤقت، ففكه بهذه الطريقة يعيد كتابة فرعك، فتحتاج دفعاً بالقوة الآمنة إلى فرعك الشخصي، أو أن تتركه وترتبه مع غيره بإعادة التأسيس التفاعلية قبل طلب الدمج. والرسالة التي تبدأ بالكلمة WIP وتقول «do not merge» تنبه أي مراجع أن هذا ليس عملاً جاهزاً، وبعض الفرق تضبط المنصة حتى ترفض دمج طلب فيه Commit بهذه الكلمة.
Stash أم Worktree؟ المقارنة Comparison
بعد أن جربنا الاثنين، نضعهما بجانب الطريقتين اللتين يلجأ إليهما المبتدئ عادة: Commit مؤقت يسمى WIP، واستنساخ ثان للمستودع:

| الموقف | الأنسب | السبب |
|---|---|---|
| زميل يسألك سؤالاً وتحتاج أن ترى main دقيقتين | git stash | أسرع شيء، وترجع فوراً |
| إصلاح عاجل قد يستغرق ساعات ومراجعة | git worktree | عملك يبقى كما هو، والإصلاح في مجلد مستقل |
| مراجعة طلب دمج وتشغيله | git worktree --detach | لا تلمس عملك، وتحذف المجلد بعدها |
| مقارنة إصدارين يعملان معاً | git worktree على وسم | نسختان على القرص في الوقت نفسه |
| نهاية اليوم والعمل غير مكتمل | Commit مؤقت تدفعه إلى فرعك | محفوظ على السيرفر، وترتبه قبل الطلب |
| بدأت تعديلاً على الفرع الخطأ | git stash ثم pop على الفرع الصحيح | الحفظ لا يرتبط بفرع |
وفي الجدول أعلاه، لاحظ أن Commit المؤقت ليس خطأ بحد ذاته، فهو أأمن من stash لأنك تستطيع أن تدفعه، والمشكلة فقط أن يصل إلى طلب الدمج كما هو، وقد شرحنا كيف ترتب هذه ال Commits قبل الطلب في إعادة التأسيس التفاعلية.
أخطاء شائعة 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
- في مستودع فيه فرع ميزة، اصنع الأنواع الأربعة من التعديلات: ملف معدل، وملف مجهز، وملف جديد، وملف متجاهل. ثم نفذ
git stashوgit stash -uوgit stash -aكل مرة، وقارنgit status --short --ignoredبعد كل واحد. - احفظ تعديلاً، ثم غير السطر نفسه في Commit، ثم نفذ
git stash pop، وحل التعارض، وتأكد أن الحفظ بقي في القائمة حتى حذفته. - احذف حفظاً بالأمر drop، ثم استرجعه مرة بالرقم المطبوع، ومرة بالأمر
git fsck --no-reflog. - أنشئ مجلد عمل لإصلاح عاجل على فرع جديد من main، وأنشئ فيه Commit، وتأكد من المجلد الأول أن ال Commit معروف وأن عملك لم يتحرك، ثم احذف المجلد بالأمر remove.
- افتح وسماً قديماً في مجلد عمل، ثم احذف المجلد بالأمر
rm -rf، وانظر إلىgit worktree list، ثم نظفه بالأمر prune.
ماذا تقرأ بعد ذلك؟ Next Steps
دليلMerge أم Rebase أم Squash؟ دمج الفروع في Git خطوة بخطوةثلاث طرق لإدخال عمل فرعك إلى main، نجربها على المستودع نفسه حتى ترى بعينك ماذا تفعل كل واحدة بالتاريخ، ومتى تختارها، وكيف تحل التعارض في كل منها.
دليلالتراجع عن الأخطاء في Git: revert أم reset أم restore؟لكل خطأ في Git أمر تراجع يناسب المكان الذي وصل إليه، وهنا تتعلم أن تختاره بسؤال واحد، وأن تسترجع عملاً ظننت أنه ضاع.
دليلCherry-pick مع git bisect: نقل الإصلاح وإيجاد الخطأكيف تنقل إصلاحاً واحداً إلى الإصدار الذي يعمل عند العميل دون بقية التغييرات وتضع له وسماً، وكيف تجد الـ Commit الذي أدخل الخطأ بين عشرات الـ Commits في دقائق.
دليلمراجعة الكود Code Review: كيف تراجع Pull Request بفائدةكيف تفتح طلب دمج يسهل على زميلك مراجعته، وكيف تراجع طلب غيرك بتعليقات تحسن الكود دون أن تتحول إلى موافقة شكلية أو جدال، مع حماية الفرع main في Gitea.بعد أن تدفع الإصلاح العاجل، قد تحتاج أن تنقله إلى فرع إصدار قديم عند عميل، وهذا موضوع Cherry-pick مع git bisect. وإذا ضاع منك شيء أثناء التبديل بين المهام فاقرأ التراجع عن الأخطاء في Git، وطرق إدخال الإصلاح إلى main في Merge أم Rebase أم Squash. والخريطة الكاملة لهذه المقالات في Git في العمل اليومي.
الخلاصة 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.