الـ Repository والـ Working Tree والـ Staging Area
Git بيدير تاريخ مشروعك كسلسلة لقطات (snapshots). عشان تفهمه لازم تعرف التلات أماكن اللي الملفات بتعدّي عليها، لأن كل أمر Git بيحرّك حاجة بين الأماكن دي.
ليه فيه Staging Area؟ عشان تتحكم في اللي بيدخل الـ commit: ممكن تكون عدّلت 5 ملفات لكن بتعمل commit لـ 2 فقط (أو جزء من ملف واحد بـ git add -p) فكل commit بيحكي «حاجة واحدة» ويبقى التاريخ نضيف.
الـ Git من جوه: 4 أنواع objects
الـ Git في الأصل content-addressable filesystem: كل حاجة بتتخزن في .git/objects باسم هو الـ hash (SHA-1، أو SHA-256 في repos الجديدة اللي بتفعّله) لمحتواها. فيه أربع أنواع:
- blob: محتوى ملف (من غير اسمه).
- tree: مجلد: قايمة (اسم ⇒ blob أو tree).
- commit: لقطة كاملة: بيشاور على tree + الأب + المؤلف + الرسالة.
- tag (annotated): object بيشاور على commit مع رسالة وتوقيع.
$ git cat-file -p HEAD # the latest commit object
tree 4b825dc642cb6eb9a060e54bf8d69288fbee4904
parent 9f8e7d1c...
author Ali <ali@example.com> 1731300000 +0200
committer Ali <ali@example.com> 1731300000 +0200
Add order validation
$ git cat-file -p HEAD^{tree} # the root folder snapshot
100644 blob e69de29b... .gitignore
100644 blob 3f2a1b9c... README.md
040000 tree 7c9d1e4a... src
$ git cat-file -t 3f2a1b9c # type of an object
blob
$ cat .git/HEAD # where am I?
ref: refs/heads/main- الـ commit مش «فرق» (diff): هو لقطة كاملة بتشاور على tree. الـ diffs بتتحسب وقت الطلب بين لقطتين. وبيتتبّع الملفات اللي مااتغيرتش بنفس الـ blob فمفيش تكرار في التخزين.
- الـ hash بيتحسب من المحتوى (بما فيه الأب). لو غيّرت أي حاجة في commit قديم، الـ hash بتاعه (وكل اللي بعده) بيتغير. وده سبب إن تعديل التاريخ = إنشاء commits جديدة (rebase/amend)، وإن مشاركة تاريخ معدّل بتسبب مشاكل.
HEADبيشاور على الـ branch الحالية (refs/heads/main) والـ branch ملف صغير فيه hash آخر commit. ده كل اللي هو.
الأوامر الأساسية: init، clone، add، commit، status، diff، log
دورة العمل اليومية: عدّل ⇒ status ⇒ diff ⇒ add ⇒ commit. ده الـ loop اللي هتعمله مئات المرات.
$ mkdir shop-api && cd shop-api
$ git init -b main # create .git (-b names the first branch)
Initialized empty Git repository in /home/ali/shop-api/.git/
$ git config user.name "Ali Hassan" # identity stored in every commit (use --global for all repos)
$ git config user.email "ali@example.com"
$ dotnet new webapi -n ShopApi && ls
ShopApi/
$ git status # what changed? where is it?
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
ShopApi/
$ git add ShopApi/Program.cs # stage ONE file
$ git add -p # stage interactively, hunk by hunk
$ git add . # stage everything in the tree (check status first!)
$ git commit -m "feat: scaffold ShopApi web API"
[main (root-commit) 3f2a1b9] feat: scaffold ShopApi web API
12 files changed, 214 insertions(+)
$ git status
nothing to commit, working tree cleanالشرح
git initبيعمل مجلد.git(الـ repository). بدونه المجلد مجرد ملفات عادية.git config user.name/email: كل commit بيحمل الهوية دي. من غير ضبطها Git بيرفض أو يخمّن. مع--globalبتتحفظ في~/.gitconfigلكل الـ repos.git add <file>بينقل لقطة الملف الحالية للـ staging. لو عدّلت الملف بعد الـ add، التعديل الجديد مش staged (لازم add تاني).git add -pبيعرض كل جزء متغير (hunk) وبتختارy/n/s(split)/e(edit): ده اللي بيخليك تعمل commits صغيرة مركزة.git commit -mبيحفظ الـ staging في الـ repo ويحرّك الـ branch الحالية لـ commit الجديد.
git clone
$ git clone https://github.com/acme/shop-api.git # full history + all branches
$ git clone git@github.com:acme/shop-api.git my-folder # SSH, custom folder name
$ git clone --depth 1 https://github.com/acme/shop-api.git # shallow: only the latest commit (fast CI)
$ git clone --branch release/2.1 --single-branch https://github.com/acme/shop-api.git
$ git remote -v # the clone set up 'origin' for you
origin https://github.com/acme/shop-api.git (fetch)
origin https://github.com/acme/shop-api.git (push)الـ clone = تنزيل الـ repository كامل (كل التاريخ) + checkout لـ default branch + تسجيل الـ remote باسم origin. الـ --depth 1 بيسرّع الـ CI بس بيشيل التاريخ (مش هينفع مع bisect أو changelog).
git diff
$ git diff # working tree vs staging (unstaged changes)
$ git diff --staged # staging vs last commit (what the next commit will contain)
$ git diff HEAD # working tree vs last commit (everything)
$ git diff main..feature/cart # two branches/commits
$ git diff --stat # summary: files and +/- counts
$ git diff -- src/Orders.cs # one path only
diff --git a/src/Orders.cs b/src/Orders.cs
index 3f2a1b9..8c4d2e1 100644
--- a/src/Orders.cs
+++ b/src/Orders.cs
@@ -12,7 +12,8 @@ public class OrderService
- if (order.Total < 0) return;
+ if (order.Total <= 0)
+ throw new ArgumentException("Total must be positive");- أكتر خطأ: كتابة
git diffبعدgit addوإنك ما تشوفش حاجة (لأن التعديل staged). استخدم--staged. - قراءة الـ hunk:
@@ -12,7 +12,8 @@= بدأ من سطر 12 في القديم (7 أسطر) ومن سطر 12 في الجديد (8 أسطر). السطر اللي بيبدأ بـ-اتحذف و+اتضاف. - عادة ممتازة:
git diff --stagedقبل كل commit عشان تراجع نفسك (متلاقيشConsole.WriteLineللـ debugging أو secret).
git log
$ git log --oneline --graph --decorate --all -15
* 8c4d2e1 (HEAD -> feature/cart, origin/feature/cart) feat(cart): add item removal
* 5b7a9c2 feat(cart): add cart endpoint
| * 1d3f5e7 (main, origin/main) fix(orders): reject zero total
|/
* 3f2a1b9 feat: scaffold ShopApi web API
$ git log -p -3 # last 3 commits with their patches
$ git log --author="ali" --since="2 weeks ago"
$ git log -S"ArgumentException" # "pickaxe": commits that added/removed this string
$ git log --follow -- src/Orders.cs # history of one file (even across renames)
$ git log main..feature/cart # commits in feature that are not in main
$ git show 1d3f5e7 # one commit with its diff
$ git blame src/Orders.cs # who last changed each line--oneline --graph --decorate --allهو الـ combo اللي بيرسملك شكل التاريخ بالـ branches (فتعمله alias:git config --global alias.lg "log --oneline --graph --decorate --all").(HEAD -> feature/cart, origin/feature/cart): HEAD على feature/cart، وآخر ما عرفناه عن الـ remote هو نفس الـ commit.-S"text"بيجاوب «إمتى الكلمة دي اتضافت أو اتشالت؟»، وده مفيد جداً في الـ debugging.git blameمش لمعرفة «مين الغلطان» بل لمعرفة ليه السطر ده كده (ادخل على الـ commit والـ PR بتاعه).
الـ Branches
الـ branch في Git مش نسخة من المشروع. هي مجرد مؤشر (pointer) متحرك على commit، بتتحرك لقدام أوتوماتيك لما تعمل commit وانت عليها. عشان كده إنشاء branch فوري ومجاني، وعشان كده Git بيشجعك تعمل branch لكل شغلة.
$ git branch # list local branches (* = current)
$ git switch -c feature/cart # create AND switch (modern; older: git checkout -b)
$ git switch main # move HEAD back (working tree files change!)
$ git branch -vv # with last commit and upstream info
$ git branch -d feature/cart # delete if merged (safe)
$ git branch -D feature/cart # force delete (unmerged commits become unreachable)
$ git branch -m old-name new-name # rename
# Detached HEAD: HEAD points to a COMMIT, not a branch
$ git switch --detach 3f2a1b9 # (or: git checkout 3f2a1b9)
$ git switch -c rescue-work # if you made commits here, give them a branch name NOWgit switchوgit restore(من Git 2.23) قسّموا مهامgit checkoutالمتشعبة: switch للـ branches، restore للملفات.checkoutلسه شغال.- لما تعمل switch، Git بيغيّر ملفات الـ working tree لتطابق اللقطة. لو عندك تعديلات غير محفوظة هتتعارض معاها بيرفض (وهنا تستخدم
stash). - Detached HEAD مش مشكلة، هو إنك واقف على commit مباشرة (للمعاينة). لو عملت commits هنا من غير branch هتبقى «يتيمة» وممكن تضيع (تتنضف بعد فترة). الحل:
git switch -c اسم. -Dمش بتمسح commits فوراً لكنها بتفقدها الـ reference؛ لو ندمت استرجعها منgit reflog(قسم Recovery).
Merge و Rebase
الاتنين بيدمجوا شغل branch في تانية، لكن بيسيبوا تاريخ مختلف. فهمك للفرق بينهم هو أهم قرار في الـ workflow اليومي.
Merge
Fast-forward: لو الـ main ماتحركتش من وقت ما أخدت منها الـ branch، Git بيحرّك مؤشر main لقدام وخلاص (مفيش commit جديد). 3-way merge: لو الاتنين اتحركوا، Git بيعمل merge commit ليه أبوين ويجمع الشغلين (بيستخدم آخر commit مشترك كأساس).
Rebase
الـ rebase بياخد commits الـ branch بتاعتك ويعيد «تشغيلها» فوق آخر main، بيعمل commits جديدة (hashes جديدة) بنفس التغييرات. النتيجة تاريخ خطي من غير merge commit.
# --- MERGE ---
$ git switch main
$ git merge feature/cart # fast-forward if possible, otherwise a merge commit
$ git merge --no-ff feature/cart # always create a merge commit (keeps the branch visible)
$ git merge --squash feature/cart # stage ALL changes as one; you commit them yourself
# --- REBASE ---
$ git switch feature/cart
$ git fetch origin
$ git rebase origin/main # replay my commits on top of the latest main
$ git rebase --continue # after resolving a conflict in the middle
$ git rebase --abort # change my mind: back to how it was beforeتتبع الـ rebase
main (C6).| Merge | Rebase | |
|---|---|---|
| التاريخ | بيحافظ على الحقيقة (مين اتفرع وإمتى) | خطي ونضيف |
| بيعدّل commits؟ | لا (آمن) | أيوه: commits جديدة بـ hashes جديدة |
| الـ conflicts | مرة واحدة في الـ merge | ممكن تتكرر على كل commit |
| الـ debugging | merge commits بتزحم التاريخ | أسهل (bisect, blame على تاريخ خطي) |
متعملش rebase لـ commits اتعمل لها push وفيه حد تاني بيشتغل عليها. الـ rebase بيغير الـ hashes فلما زميلك يعمل pull هيشوف تاريخين مختلفين لنفس الشغل (commits مكررة وتعارضات). الـ rebase آمن على شغلك المحلي أو feature branch اللي انت بس بتشتغل عليها (وبعده push بـ --force-with-lease).
إمتى أستخدم إيه؟ Rebase عشان تحدّث الـ feature branch بآخر main قبل الـ PR. Merge (غالباً squash أو merge commit) لدمج الـ PR في main حسب سياسة الفريق (قسم GitHub).
Merge Conflicts
الـ conflict بيحصل لما الاتنين عدّلوا نفس الأسطر (أو واحد عدّل ملف والتاني حذفه) و Git مقدرش يقرر لوحده. دي مش «غلطة»، دي حاجة عادية ولازم تتعلم تحلها بهدوء.
$ git switch main && git merge feature/discount
Auto-merging src/PriceCalculator.cs
CONFLICT (content): Merge conflict in src/PriceCalculator.cs
Automatic merge failed; fix conflicts and then commit the result.
$ git status
Unmerged paths:
both modified: src/PriceCalculator.cs
$ cat src/PriceCalculator.cs
public decimal Total(Order o)
{
<<<<<<< HEAD
return o.Subtotal * 1.14m; // main: VAT 14%
=======
return o.Subtotal * (1 - o.Discount) * 1.14m; // feature: discount + VAT
>>>>>>> feature/discount
}# 1) Edit the file: keep the right result and DELETE the three marker lines
public decimal Total(Order o)
{
return o.Subtotal * (1 - o.Discount) * 1.14m; // both intentions combined
}
$ dotnet build && dotnet test # make sure it actually works!
$ git add src/PriceCalculator.cs # "I resolved this file"
$ git commit # finishes the merge (default message is fine)
# If you get lost:
$ git merge --abort # back to before the merge
$ git rebase --abort # same, during a rebase
$ git checkout --ours path/file # take main's version of the file (during merge)
$ git checkout --theirs path/file # take the feature's version
$ git mergetool # open a visual 3-way tool (VS Code, Visual Studio, kdiff3)<<<<<<< HEADلحد=======هو نسخة الـ branch اللي انت عليها. من=======لحد>>>>>>>هو نسخة الـ branch المدموجة.- الحل مش «اختار واحد»، غالباً هو دمج النيّتين (هنا الخصم والضريبة). عشان كده لازم تفهم الكودين، واسأل زميلك لو مش فاهم.
- بعد الحل: build واختبارات. conflict ممكن يتحل نصياً وينكسر منطقياً (compile error أو سلوك غلط). ودايماً دوّر على بقايا
<<<<<<<قبل الـ add (git diff --check). - أثناء الـ rebase،
oursوtheirsبيتعكسوا (ours = الـ branch اللي بتـ rebase فوقها، theirs = commit بتاعك). انتبه. - تقليل الـ conflicts: commits صغيرة، pull/rebase متكرر، ماتعملش reformat لملفات كاملة، وقسّم الشغل بحيث متعدلوش نفس الملفات.
git config --global rerere.enabled true بيخلي Git «يفتكر» إزاي حليت conflict معين ويطبّق نفس الحل تلقائياً لو اتكرر (مفيد في rebase طويل).
restore و reset و revert، والـ Amend، والاسترجاع الآمن
أقوى حاجة تخليك تشتغل بثقة: إنك تعرف إزاي ترجع في أي مرحلة. الأمر بيختلف حسب الغلطة وصلت لأي مكان: working tree، staging، commit محلي، ولا commit اتعمل له push.
| الموقف | الأمر | بيعمل إيه |
|---|---|---|
| عدّلت ملف وعايز ترجّعه زي آخر commit | git restore file | بيرجّع الملف من الـ index. بيضيّع تعديلاتك غير المحفوظة (مفيش undo) |
عملت add بالغلط | git restore --staged file | بيشيل من الـ staging ويسيب التعديل في الـ working tree |
| رسالة آخر commit غلط / نسيت ملف | git commit --amend | بيستبدل آخر commit بـ commit جديد (محلي فقط!) |
| commit محلي عايز تلغيه (لسه ماتعملوش push) | git reset | بيحرّك الـ branch لورا (3 أنماط) |
| commit اتعمله push ومشترك | git revert <hash> | بيعمل commit جديد يعكس التغيير (بيحافظ على التاريخ) |
| «ضيّعت» commits أو عملت reset hard | git reflog | بيوريك كل حركات HEAD علشان ترجع |
git reset: التلات أنماط
# 1) Discard edits in one file (cannot be undone!)
$ git restore src/Orders.cs
$ git restore . # all files (careful)
# 2) Unstage
$ git restore --staged src/Orders.cs
# 3) Fix the LAST commit (message or forgot a file) — only if not pushed
$ git add src/Missing.cs
$ git commit --amend --no-edit # same message, new content
$ git commit --amend -m "fix(orders): validate total" # new message
# 4) Undo the last 2 local commits but KEEP the work
$ git reset --soft HEAD~2 # changes stay STAGED (re-commit as one commit)
$ git reset HEAD~2 # --mixed: changes stay in the working tree, unstaged
# 5) Throw away the last commit AND its changes (dangerous)
$ git reset --hard HEAD~1
# 6) Undo a commit that is ALREADY PUSHED: add a new commit that reverses it
$ git revert 8c4d2e1
$ git revert -m 1 <merge-commit> # reverting a merge commit: choose the mainline parent
# 7) I broke everything: where was HEAD before?
$ git reflog
8c4d2e1 HEAD@{0}: reset: moving to HEAD~1
a91b3f0 HEAD@{1}: commit: feat(cart): add discount <- the "lost" commit
$ git reset --hard a91b3f0 # or: git switch -c rescue a91b3f0الشرح
restoreعلى working tree بيمسح التعديلات للأبد (Git مفيش عنده نسخة منها). لو مش متأكد، اعملgit stashالأول.--amendبيعمل commit جديد بـ hash مختلف بدل القديم. لو كان القديم مرفوع، هتحتاج force push، فاستخدمه بس على commits محلية.reset --softمفيد لتجميع كذا commit صغيرة في واحدة قبل الـ push.--hardهو الخطير: بيمسح تعديلات الـ working tree.revertهو الخيار الآمن للتاريخ المشترك: بيضيف commit يعكس الأثر ومبيمسحش حاجة. ممكن تعمل revert لـ revert لو رجعت عن رأيك.- reflog هو شبكة الأمان: Git بيسجل كل مكان HEAD وقف فيه (لمدة 90 يوم افتراضياً للـ reachable و 30 يوم للـ unreachable). حتى بعد
reset --hardالـ commits لسه موجودة، لكن التعديلات اللي ما اتعملهاش commit مبترجعش. السبب إنك اتعلمت: commit كتير وبدري.
- وقف: متكتبش أوامر عشوائية.
git statusوgit reflogلتفهم الوضع.- اعمل branch احتياطية:
git branch backup-before-fixقبل أي إصلاح. - استخدم
git reset/revert/cherry-pickحسب الحالة. الغالب إن الـ commits لسه موجودة.
Cherry-Pick و Stash
git cherry-pick
بياخد commit معين من أي branch ويطبّقه (كـ commit جديد) على الـ branch الحالية. مفيد لـ hotfix: الإصلاح اتعمل في main وعايزه كمان في release/2.1 من غير دمج الباقي.
$ git switch release/2.1
$ git cherry-pick 1d3f5e7 # apply that single commit here (new hash)
$ git cherry-pick A..B # a range (A excluded, B included)
$ git cherry-pick -x 1d3f5e7 # adds "(cherry picked from commit 1d3f5e7)" to the message
$ git cherry-pick --continue # after fixing a conflict
$ git cherry-pick --abortتحذير: الـ commit بيتكرر بـ hash مختلف في الـ branchين، فلما تدمجهم بعدين Git غالباً بيتعامل معاها صح، لكن الإفراط في cherry-pick بيعمل تاريخ مكرر ومربك. استخدمه للـ hotfixes والـ backports.
git stash
بيحط تعديلاتك غير المحفوظة في «درج مؤقت» وبيرجّع الـ working tree نضيف، عشان تقدر تبدّل branch (مثلاً حريق في الإنتاج) وترجع تكمل.
$ git stash push -m "wip: discount rules" # save tracked changes (add -u to include untracked files)
$ git switch main # now free to switch / pull / hotfix
$ git stash list
stash@{0}: On feature/discount: wip: discount rules
$ git stash show -p stash@{0} # preview the content
$ git stash pop # re-apply AND drop it (conflicts keep the stash)
$ git stash apply stash@{1} # re-apply but keep it in the list
$ git stash drop stash@{0}
$ git stash push -p # choose hunks to stash- الـ stash بيخزن التعديلات كـ commits مخفية. الـ untracked files مش بتدخل إلا بـ
-u، والـ ignored بـ-a. pop= apply + drop. لو حصل conflict الـ stash بيفضل (عشان متضيعش).- الـ stash مش بديل للـ commit: stash قديم بيتنسى. للشغل الأطول اعمل commit على branch (حتى WIP) وعدّله بعدين.
Remotes و Fetch vs Pull و Push والـ Upstream
الـ remote هو نسخة تانية من الـ repository على سيرفر (GitHub مثلاً)، باسم مختصر (الافتراضي origin). Git موزّع: كل حد عنده نسخة كاملة بالتاريخ، والـ remote مجرد نقطة اتفاق لتبادل الشغل.
$ git remote add origin git@github.com:acme/shop-api.git # connect a local repo to a remote
$ git remote -v
$ git remote rename origin upstream-repo # (rare)
# --- FETCH: download new commits, DON'T touch my branch or files (safe, always) ---
$ git fetch origin
$ git log --oneline main..origin/main # what's new upstream?
$ git diff main origin/main
# --- PULL: fetch + integrate into the current branch ---
$ git pull # = fetch + merge (creates merge commits if diverged)
$ git pull --rebase # = fetch + rebase (linear history)
$ git config --global pull.rebase true # make --rebase the default
$ git pull --ff-only # refuse anything but fast-forward (safest)
# --- PUSH: publish my commits ---
$ git push -u origin feature/cart # first push: -u sets the UPSTREAM (tracking) branch
$ git push # later: knows where to go
$ git branch -vv # feature/cart 8c4d2e1 [origin/feature/cart: ahead 2] ...
$ git push --force-with-lease # after a rebase of YOUR branch: refuses if someone else pushed meanwhile
$ git push origin --delete feature/cart # delete the remote branch
$ git config --global push.autoSetupRemote true # auto -u for new branches- fetch بيحدّث الـ
origin/*(الصور المحلية) بس. مفيش أي تغيير في فروعك أو ملفاتك. فهو آمن 100% وتقدر تعمله في أي وقت لتشوف إيه الجديد. - pull = fetch + دمج في الـ branch الحالية. لو كلاكما اتقدم (diverged) بيعمل merge commit أو rebase حسب الإعداد.
--ff-onlyبيرفض لو مش ممكن fast-forward فتحل انت بنفسك بوعي. - upstream branch: ربط بين فرعك المحلي وفرع الـ remote. لما يكون مضبوط،
git statusبيقولك «ahead 2, behind 1» وبتقدر تكتبgit push/git pullمن غير وسائط. بتضبطه بـ-uفي أول push. - force push: مرفوض بشكل افتراضي لأنه بيمسح commits بعيدة. لو لازم (بعد rebase لفرعك الخاص) استخدم
--force-with-leaseمش--force: بيتأكد إن الـ remote لسه زي آخر مرة شفته، فمش هيمسح شغل زميل حطه في النص. - أبداً force push على
mainأو أي branch مشتركة. فعّل branch protection (قسم GitHub) لمنعه.
! [rejected] main -> main (non-fast-forward): الـ remote فيه commits مش عندك. اعمل git pull --rebase ثم push. fatal: The current branch has no upstream branch: استخدم git push -u origin <branch>.
Tags و .gitignore
Tags
الـ tag اسم ثابت لـ commit معين (عكس الـ branch المتحركة). بنستخدمه لعلامات الإصدارات: v1.4.0.
$ git tag v1.4.0 # lightweight: just a name for the current commit
$ git tag -a v1.4.0 -m "Release 1.4.0" # annotated: has author/date/message (preferred for releases)
$ git tag -a v1.3.2 3f2a1b9 # tag an OLDER commit
$ git tag -l "v1.*" # list (pattern)
$ git show v1.4.0
$ git push origin v1.4.0 # tags are NOT pushed by default
$ git push origin --tags # push all tags
$ git tag -d v1.4.0 && git push origin --delete v1.4.0 # delete locally and remotely
$ git switch --detach v1.4.0 # inspect the code as it was at releaseاستخدم Semantic Versioning: MAJOR.MINOR.PATCH: MAJOR لتغييرات كاسرة، MINOR لميزات متوافقة، PATCH لإصلاحات. الـ CI عادةً بيبني الـ release من الـ tag.
.gitignore
بيقول لـ Git مين الملفات اللي متتتبعش: ملفات البناء، الـ dependencies، الإعدادات الشخصية، والـ secrets.
# .NET build output
bin/
obj/
*.user
.vs/
*.suo
# Secrets and local config — NEVER commit these
appsettings.Development.json
appsettings.*.local.json
.env
*.pfx
secrets.json
# Node / Angular
node_modules/
dist/
.angular/
# OS / editor
.DS_Store
Thumbs.db
.idea/
# but keep this one even though *.log is ignored:
*.log
!important.log- الـ patterns:
folder/لمجلد،*.extwildcard،!nameاستثناء (re-include)،#تعليق. - الـ
.gitignoreبيأثر فقط على الملفات غير المتتبعة (untracked). لو ملف اتعمله commit قبل كده، هيفضل متتبع: لازمgit rm --cached fileثم commit. (ده لا يمسح الملف من الـ disk). - لو ملف فيه secret اتعمله commit، مسحه في commit جديد مش كفاية: هو لسه في التاريخ. لازم تعتبر الـ secret اتسرّب، وتغيّره (rotate) فوراً، وبعدين تنضف التاريخ بـ
git filter-repoلو لازم. - لـ .NET استخدم
dotnet new gitignoreلتوليد ملف جاهز ومحدّث. وعلى GitHub في مجموعة templates (github/gitignore). - ملاحظة:
.git/info/excludeو global ignore (core.excludesFile) للملفات الشخصية اللي متخصش المشروع.
Interactive Rebase و Squash و bisect و Hooks
Interactive rebase و Squash
git rebase -i بيخليك تعدّل تاريخ commits محلية قبل ما تشاركها: تدمج commits صغيرة، تغيّر رسايل، تعيد ترتيب، أو تحذف commit. ده اللي بيحوّل «wip» و«fix typo» و«oops» لتاريخ نضيف.
$ git log --oneline -4
d4e5f6a wip
c3d4e5f fix typo
b2c3d4e oops forgot validation
a1b2c3d feat(cart): add discount endpoint
$ git rebase -i HEAD~4 # opens your editor with the todo list (oldest first):
pick a1b2c3d feat(cart): add discount endpoint
fixup b2c3d4e oops forgot validation # squash into previous, DISCARD this message
fixup c3d4e5f fix typo
reword d4e5f6a wip # keep the change but rewrite the message
# Commands: p/pick r/reword e/edit s/squash (keep message) f/fixup (drop message) d/drop
# You can also reorder lines to reorder commits.
# Shortcut: create fixup commits as you work, then auto-apply them
$ git commit --fixup a1b2c3d
$ git rebase -i --autosquash origin/main- الـ todo list بتتنفذ من فوق لتحت.
fixupبتدمج الـ commit في اللي قبلها وبتتجاهل رسالته؛squashبتدمج وبتديك فرصة تدمج الرسايل. - الناتج: commit واحد نضيف + commit بـ message محدثة بدل أربعة مزعجة. كل commit بيحصل له hash جديد.
- لو حصل conflict: حلّه،
git add،git rebase --continue. وgit rebase --abortبيرجّعك لما قبل البدء. - القاعدة نفسها: على commits محلية أو branch خاصة بيك فقط.
git bisect: دوّر على الـ commit اللي كسر الكود
لو عندك bug «كان شغال من أسبوعين وبايظ دلوقتي» وبينهم 200 commit، الـ bisect بيعمل binary search على التاريخ: بتخبره commit «كويس» و commit «وحش»، وهو بيعمل checkout للنص وبتقوله كويس ولا وحش، وكل مرة بيقسم المدى. ~8 خطوات بدل 200.
$ git bisect start
$ git bisect bad # current commit is broken
$ git bisect good v1.3.0 # this release was fine
Bisecting: 100 revisions left to test after this (roughly 7 steps)
# ... build/test, then tell Git:
$ git bisect good # or: git bisect bad
...
8c4d2e1 is the first bad commit
$ git bisect reset # back to where you started
# AUTOMATIC: let a script decide (exit 0 = good, non-zero = bad, 125 = skip)
$ git bisect start HEAD v1.3.0
$ git bisect run dotnet test --filter "FullyQualifiedName~OrderTotalTests"- الفعالية
O(log n): 1000 commit = ~10 خطوة. وده سبب أهمية commits صغيرة ومركزة وكل واحد بيبني ويعدّي الاختبارات: الـ bisect هيدلك على commit واحد صغير يتفحص بسهولة. bisect runمع اختبار آلي بيعمل الشغل كله بدون تدخل. اكتب أولاً اختبار يفشل بسبب الـ bug.- الـ commit الكبير اللي فيه 40 ملف هيدّيك «found it» لكن ما يفيدش.
Git Hooks و pre-commit
الـ hooks سكريبتات بيشغّلها Git تلقائياً في أحداث (قبل commit، قبل push…). موجودة في .git/hooks/ (مش بتتشارك مع الـ repo). الاستخدام: منع commit فيه secret، تشغيل formatter/linter، فرض شكل الرسالة.
#!/usr/bin/env bash
set -euo pipefail
# Only look at what is about to be committed
files=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(cs|ts|json)$' || true)
[ -z "$files" ] && exit 0
# 1) Debug leftovers
if git diff --cached -U0 -- $files | grep -E '^\+.*(Console\.WriteLine|debugger;)' ; then
echo "✗ Remove debug statements before committing." >&2
exit 1
fi
# 2) Naive secret scan
if git diff --cached -U0 -- $files | grep -Ei '^\+.*(password|secret|apikey)\s*[:=]\s*"[^"]+"' ; then
echo "✗ Possible secret in the staged changes." >&2
exit 1
fi
# 3) Format check (fails the commit if code is not formatted)
dotnet format --verify-no-changes --include $files >/dev/null 2>&1 || { echo "✗ Run: dotnet format"; exit 1; }#!/usr/bin/env bash
msg_file="$1"
pattern='^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([a-z0-9._-]+\))?(!)?: .{1,72}$'
if ! head -n1 "$msg_file" | grep -Eq "$pattern"; then
echo "✗ Commit message must look like: feat(cart): add discount endpoint" >&2
exit 1
fi- الـ hook بيرجّع exit code غير صفر ⇒ Git بيلغي العملية.
git diff --cachedبيفحص اللي staged بس. - تخطّي مؤقت:
git commit --no-verify(استخدمه بحذر، والـ CI لازم يعمل نفس الفحوصات لأن الـ hooks المحلية ممكن تتخطى). - مشكلة الـ hooks المحلية: مش بتتشارك. الحل:
git config core.hooksPath .githooksمع مجلد في الـ repo، أو أدوات زي pre-commit (Python) وHusky (Node) وLefthook اللي بتديرها بالـ config ملف في الـ repo. - أنواع شائعة:
pre-commit،commit-msg،pre-push(شغّل الاختبارات السريعة قبل الرفع)،post-merge.
Branching Strategies و Pull Request Workflow و Commit Practices
Branching Strategies
| الاستراتيجية | الفكرة | مناسبة لـ | العيوب |
|---|---|---|---|
| Trunk-Based Development | الكل بيدمج في main بشكل متكرر (كل يوم)، فروع قصيرة جداً أو commit مباشر، و feature flags للميزات غير المكتملة | فرق بتعمل CI/CD ونشر مستمر | محتاج اختبارات آلية قوية وانضباط |
| GitHub Flow | main دايماً قابلة للنشر؛ branch لكل تغيير ⇒ PR ⇒ review ⇒ merge ⇒ deploy | أغلب المشاريع والويب (الافتراضي الموصى به) | مش مصممة لإدارة عدة إصدارات متوازية |
| Git Flow | فروع main + develop + feature/* + release/* + hotfix/* | منتجات بإصدارات مجدولة ودعم لنسخ قديمة متعددة (desktop, mobile, libraries) | معقدة، دمج طويل الأمد، conflicts أكتر، بطيئة مع CD |
الاتجاه الحديث: الأبسط أحسن. لو بتنشر باستمرار استخدم GitHub Flow أو trunk-based. Git Flow بس لو فعلاً عندك إصدارات متوازية.
Pull Request Workflow
git switch -c feature/cart-discount من آخر main (بعد git pull).git push -u origin feature/cart-discount مبكراً (عشان الـ CI يشتغل وتحتفظ بنسخة).git fetch && git rebase origin/main، شغّل الاختبارات محلياً، راجع git diff origin/main بنفسك، ونضّف الـ commits (rebase -i).git switch main && git pull && git branch -d feature/cart-discount.تفاصيل الـ PR على GitHub (templates، reviews، branch protection) في درس GitHub.
Commit Best Practices و Conventional Commits
✅ commit كويس
- ذرّي (atomic): تغيير منطقي واحد، يبني ويعدّي الاختبارات.
- رسالة بتشرح ليه مش بس إيه.
- سطر العنوان ≤ 72 حرف، بصيغة الأمر: «Add», «Fix».
- سطر فاضي ثم body لو محتاج شرح.
- مفيش ملفات مش متعلقة (formatting كبير مخلوط بمنطق).
❌ commit وحش
fix,wip,update,asdf.- commit فيه 3 ميزات و refactor و dependency upgrade.
- ملفات generated أو binaries أو secrets.
- كود معلّق (commented-out) أو debug.
- commit بيكسر الـ build (يخرّب bisect).
Conventional Commits هو اتفاق على شكل الرسالة يتيح أدوات تولّد الـ changelog وتحدد رقم الإصدار آلياً:
feat(cart): add discount code endpoint -> MINOR release
fix(orders): reject orders with zero total -> PATCH release
perf(search): cache category lookups
refactor(auth): extract token validation
docs: document the /orders API
test(cart): cover expired discount codes
ci: cache NuGet packages in the build workflow
chore(deps): bump Npgsql to 9.0.2
feat(api)!: remove v1 /orders endpoint -> "!" = BREAKING CHANGE -> MAJOR release
feat(payments): support Apple Pay
Adds a new IPaymentMethod implementation and wires it into checkout.
Closes #482
BREAKING CHANGE: PaymentRequest.Method is now an enum, not a string.- الأنواع الأساسية:
feat(ميزة جديدة)،fix(إصلاح bug)، وبعدهاdocs, style, refactor, perf, test, build, ci, chore, revert. !أوBREAKING CHANGE:في الـ footer بيعني تغيير كاسر ⇒ MAJOR في Semantic Versioning.- الأدوات:
semantic-releaseوrelease-pleaseوgit-cliffبتقرا الـ history وتولّد CHANGELOG وتنشر الإصدارات. - الفحص بـ
commit-msghook (شوف القسم السابق) أوcommitlintفي الـ CI.
Monorepo vs Polyrepo (وعي معماري)
| Monorepo (repo واحد لكل حاجة) | Polyrepo (repo لكل خدمة/مكتبة) | |
|---|---|---|
| التغييرات عبر المشاريع | commit/PR واحد بيغيّر API والـ client والـ docs (atomic) | تنسيق بين repos متعددة وإصدارات |
| مشاركة الكود | سهلة (مفيش نشر packages داخلية) | محتاجة packages مُصدرة وإدارة نسخ |
| الاستقلالية والصلاحيات | أصعب (CODEOWNERS لازم) | طبيعية: فريق = repo = صلاحيات |
| الـ CI | لازم path filters و build ذكي (affected projects) وإلا هيبقى بطيء | بسيط لكل repo |
| الحجم | repo كبير (أدوات: sparse-checkout, partial clone) | صغير وسريع |
| أمثلة | Google, Microsoft (جزئياً)، Nx/Turborepo monorepos | microservices كلاسيكية |
مفيش إجابة صح مطلقة: monorepo بيناسب فرق صغيرة/متوسطة وـ full-stack (Angular + API في نفس الـ repo)، والـ polyrepo بيناسب فرق مستقلة بإصدارات مستقلة. المهم الوعي بالتكلفة (tooling و CI وصلاحيات) مش الموضة.
أخطاء شائعة وتشخيص
| الموقف | السبب | الحل |
|---|---|---|
عملت commit على main بدل الـ feature branch (لسه محلي) | نسيت switch -c | git branch feature/x (الـ commit يتحفظ عليها) ثم git reset --hard origin/main على main ثم git switch feature/x |
| commit فيه secret اتعمله push | ملف مش في .gitignore | غيّر الـ secret فوراً (rotate). بعدين git filter-repo أو BFG لتنضيف التاريخ، والـ history rewrite محتاج تنسيق مع الفريق |
detached HEAD وضاع شغلي | commits من غير branch | git reflog ⇒ git switch -c rescue <hash> |
| push مرفوض non-fast-forward | الـ remote اتقدم | git pull --rebase ثم push. متستخدمش --force |
عملت reset --hard ومسحت commits | غلط في الهدف | git reflog ثم reset --hard <hash قبل الحركة> |
| ملف في .gitignore لسه بيظهر متغيّر | الملف كان متتبّع قبل الـ ignore | git rm --cached file ثم commit |
| conflicts في كل rebase | branch عاشت طويلاً أو ملفات مشتركة كبيرة | rebase/merge من main بشكل متكرر، commits صغيرة، rerere |
| CRLF/LF تغيّر كل الأسطر في diff | اختلاف نهايات الأسطر Windows/Linux | .gitattributes بـ * text=auto و core.autocrlf |
| repo كبير وبطيء | ملفات binaries كبيرة في التاريخ | Git LFS للملفات الكبيرة، وماتعملش commit لـ build outputs |
(1) commit بدري ومتكرر (تقدر تنضّفه بعدين بـ rebase -i)؛ اللي اتعمله commit ينتهى استرجاعه تقريباً. (2) git status و git diff --staged قبل كل commit. (3) git switch -c backup-xyz قبل أي عملية خطرة (rebase/reset).
Knowledge Check
أهم النقاط
- الـ commit لقطة كاملة (مش diff) بتشاور على tree وعلى الأب. الـ branch مؤشر متحرك على commit. الـ HEAD هو «أنا واقف فين».
- التلات مناطق: working tree ⇒ (
add) staging ⇒ (commit) repository. استخدمadd -pلـ commits مركزة. - Merge بيحافظ على التاريخ. Rebase بيعيد كتابته (commits جديدة) فمتعملهوش على تاريخ مشترك.
- Conflict = نفس الأسطر اتعدلت؛ حلّه بدمج النيّتين وبعدين build واختبارات.
- للتراجع:
restore(ملفات)،reset(commits محلية)،revert(commits مشتركة)،reflog(شبكة الأمان). - fetch آمن دايماً، pull = fetch + دمج، و
--force-with-leaseبدل--force. - تاريخ نضيف (atomic commits + Conventional Commits) بيخلي bisect و blame والـ changelog شغّالين.
أسئلة مفاهيمية
ليه Git بيعتبر الـ branch رخيصة؟
لأنها مجرد ملف صغير فيه hash آخر commit. مفيش نسخ للملفات؛ الـ objects مشتركة بين كل الـ branches.
الفرق بين git reset و git revert؟ وإمتى تستخدم كل واحد؟
reset بيحرّك مؤشر الـ branch لورا (بيعيد كتابة التاريخ) فمناسب للـ commits المحلية. revert بيضيف commit جديد يعكس التغيير ويحافظ على التاريخ، فهو الصح لـ commits اتعمل لها push وفيه ناس بتشتغل عليها.
ليه rebase على branch مشتركة بيعمل مشاكل؟
لأنه بيخلق commits جديدة بـ hashes جديدة، فنسخة زميلك لسه بالـ commits القديمة. لما يعمل pull هيشوف تاريخين متشعبين للشغل نفسه، commits مكررة و conflicts.
إيه الفرق بين git fetch و git pull؟
fetch بينزّل commits جديدة بس ويحدّث origin/* من غير ما يغيّر فروعك. pull = fetch ثم merge (أو rebase) في الـ branch الحالية.
ليه تحط secret في .gitignore بعد ما اتعمله commit مش بيحل المشكلة؟
الـ .gitignore بيمنع تتبع ملفات جديدة بس، والـ secret لسه في تاريخ الـ commits القديمة (وأي حد عمل clone هيشوفه). لازم تغيّر الـ secret (rotate) وتنضّف التاريخ.
سيناريوهات عملية
سيناريو: كتبت شغل 3 ساعات على main ومحتاج تنقله لـ branch من غير ما تفقد حاجة (لسه من غير commit)
git switch -c feature/x — بتاخد معاك التعديلات غير المحفوظة لأن الـ working tree مش بيتغير، فبعدها add و commit على الـ branch الجديدة و main تفضل نضيفة.
سيناريو: عملت 5 commits، وعايز تدمجهم في commit واحد قبل الـ PR
git rebase -i HEAD~5 واختار pick للأول و fixup/squash للباقي. أو git reset --soft HEAD~5 && git commit. طالما محلي أو branch خاصة، ولو اترفع قبل كده فـ git push --force-with-lease.
سيناريو: الإنتاج واقع بسبب commit في main اتدمج من يومين، وفيه 20 commit بعده
الأسرع والأأمن: git revert <hash> (أو -m 1 لو merge commit)، ادمج، انشر. تحديد الـ commit: git bisect مع اختبار يفشل. متعملش reset/force على main.
أسئلة إنترفيو شائعة
اشرح مراحل ما بعد git commit من جوه: إيه اللي Git بيخزنه؟
بيكتب blobs للملفات المتغيرة، trees للمجلدات، و object commit بيشاور على الـ tree الجذر وعلى الأب (hash)، ثم بيحرّك الـ branch الحالية (ملف refs) لـ hash الجديد ويحدّث HEAD/reflog.
إزاي تعثر على الـ commit اللي ضيّع bug؟
git bisect (يدوي أو bisect run مع اختبار آلي)، أو git log -S"text" لو عارف الكود المتأثر، و git blame لتتبع آخر تعديل لسطر.
Git Flow ولا Trunk-based؟ ومتى؟
Trunk-based/GitHub Flow لو بتنشر باستمرار وعندك CI قوي (feature flags للميزات غير الجاهزة). Git Flow لو عندك إصدارات مجدولة ومتوازية (ومعظم الفرق الحديثة بتتجنبه لتعقيده).
المراجع والقراءة الإضافية
الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)
التوثيق الرسمي — Official documentation
مصادر تعليمية ومتقدمة — Third-party & advanced reading
خريطة التغطية: 29 عنصر من الـ Roadmap ومكان شرحه في الدرس
خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.