إدارة الإصدارات والعمل الجماعي
تتبّع تغييرات مشروعك، وجرّب أفكارك بأمان، ونسّق العمل مع فريقك حتى تصل التعديلات إلى إصدار موثوق.
3 تقنيات
قصة صغيرة: أصلحت Bug، وجرّبت تصميمًا جريئًا، ثم اكتشفت أن النسخة الأولى كانت أفضل. من دون تاريخ محفوظ ستضطر إلى التخمين. مع Version Control تستطيع مقارنة المحاولتين، والاحتفاظ بما يفيد، وفهم كيف وصل المشروع إلى حالته الحالية.
يسير هذا الدليل مع تغيير واحد من جهاز المطور إلى مراجعة الزميل ثم إلى Release. ستتعرف على أفكار Git، ومكان GitHub وGitLab حوله، وكيف تتصرف بهدوء عندما تتشابك التغييرات.
ماذا يفعل Version Control فعلًا؟
يسجل Version Control التغييرات على الملفات مع مرور الوقت. ويساعدك على الإجابة عن أسئلة عملية: ما الذي تغيّر؟ من غيّره؟ ولماذا؟ أي نسخة كانت تعمل الأسبوع الماضي؟ وهل يستطيع شخصان العمل في الوقت نفسه دون أن يكتب أحدهما فوق عمل الآخر؟
تخيّله كخط زمني للمشروع، عليه نقاط حفظ واضحة. النقطة المفيدة ليست زر تراجع للطوارئ فقط؛ فهي تعطي الفريق سياقًا، وتجعل المراجعة ممكنة، وتسمح بالتجربة دون خسارة نسخة معروفة بأنها تعمل.
ثلاثة نماذج قد تسمع عنها
| النموذج | أين يوجد التاريخ؟ | ماذا يعني عمليًا؟ |
|---|---|---|
| Local Version Control | على جهاز واحد. | أفضل من نسخ المجلدات يدويًا، لكن التعاون وتعطل الجهاز يظلان مصدر قلق. |
| Centralized Version Control | على Server مركزي. | يحصل المستخدمون على الملفات من مصدر مشترك واحد، ويصبح Server مهمًا للعمل اليومي. |
| Distributed Version Control | داخل كل Repository مستنسخة. | تحتوي كل نسخة على تاريخ المشروع، وتعمل عمليات كثيرة دون إنترنت إلى أن يصبح تبادل التغييرات مناسبًا. |
Git نظام Distributed Version Control. يستطيع تتبع المشروع محليًا دون حساب أو خدمة استضافة أو اتصال بالإنترنت. تستضيف GitHub وGitLab Git Repositories وتضيفان ميزات التعاون؛ هما منصتان حول Git وليستا بديلًا عن أداة Git نفسها.
الأماكن الأربعة التي يمر بها التغيير
أسهل صورة أولية هي طاولة عمل تسير في اتجاه واحد. يبدأ الملف في Working Tree، ثم تختار ما يدخل نقطة الحفظ التالية، ثم تسجلها في Repository المحلية.
Working Tree -> Staging Area (Index) -> Local Repository -> Remote Repository
تعديل الملفات اختيار ما يدخل Commit تاريخ محفوظ محليًا مشاركة مع الفريق
| المكان | الصورة المبسطة | أمر يساعدك |
|---|---|---|
| Working Tree | الملفات التي تراها وتستطيع تعديلها الآن. | git status وgit diff |
| Staging Area / Index | معاينة دقيقة لما سيحتويه Commit التالي. | git add وgit diff --staged |
| Local Repository | التاريخ المحفوظ على جهازك. | git commit وgit log |
| Remote Repository | نسخة أخرى لتبادل التاريخ مع الزملاء أو منصة الاستضافة. | git fetch وgit pull وgit push |
ليست Staging خطوات شكلية. إنها اللحظة التي تراجع فيها محتوى Commit القادم. إذا جمع التغيير إصلاح إملاء مع تجربة لا علاقة لها به، جهّز الجزء الذي يصنع قصة واضحة واحدة فقط.
أول جلسة آمنة
ثبّت Git من مصدره الرسمي، وافتح Terminal داخل مجلد المشروع، ثم افحص ما يراه Git:
git --version
git status
لبدء Repository في مجلد جديد استخدم git init. أما إذا كان المشروع موجودًا على منصة استضافة، فاستخدم git clone <repository-url>؛ فهو ينزّل المشروع وتاريخه.
يسجل Git الاسم والبريد الإلكتروني بوصفهما هوية مؤلف Commit. اختر هوية مرتاحًا لنشرها:
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
تطبق --global هذه الإعدادات على حسابك في هذا الجهاز. ويمكن للمشروع تجاوزها محليًا باستخدام git config user.name "Project Name" عند الحاجة. لا تضع كلمات مرور أو Access Tokens أو Private Keys في هذه القيم أو في Repository.
أنشئ Commit يحكي قصة
جرّب تغييرًا صغيرًا، وافحصه، ثم احفظ فقط ما تقصده:
git status
git diff
git add README.md
git diff --staged
git commit -m "docs: explain local setup"
git log --oneline
اقرأ التسلسل هكذا: افحص، وراجع Diff غير المجهّز، واختر ملفًا، وراجع النسخة المجهّزة، واحفظ نقطة، ثم انظر إلى التاريخ. الأمر git add . مريح، لكنه قد يجهّز ملفات مولدة أو أسرارًا بالخطأ؛ في التعلم اذكر الملفات التي تنوي إضافتها بالاسم.
يكون Commit الجيد صغيرًا بما يكفي لفهمه ومتكاملًا بما يكفي ليكون منطقيًا. استخدم رسالة مثل Fix empty search state بدلًا من updates. ابدأ بفعل، وافصل التغييرات غير المرتبطة، وأضف توضيحًا في جسم الرسالة إذا لم يكن السبب ظاهرًا.
Branches: جرّب دون خسارة المسار الرئيسي
Branch اسم خفيف يشير إلى مسار من Commits. وهو ليس عادة نسخة كاملة إضافية من المشروع. يكون الفرع الافتراضي—وغالبًا اسمه main—هو المسار المشترك الذي يعدّه الفريق مستقرًا.
أنشئ Branch قصيرة العمر لتغيير واحد:
git switch -c feature/search-empty-state
أنشئ عليها بضعة Commits مركزة. إذا فشلت التجربة، يبقى الفرع المستقر كما هو. وإذا نجحت، يمكن مراجعة Branch ودمجها. أسماء مثل feature/ وfix/ وdocs/ أعراف للفريق وليست صياغة خاصة في Git.
في الداخل، تكوّن Commits رسمًا بيانيًا. يشير كل Commit إلى Commit سابق أو أكثر، ويتحرك اسم Branch عند إضافة Commits جديدة. يخبر HEAD Git بمكان Checkout الحالي. تفسر هذه الأفكار سرعة التنقل بين Branches ووجود أكثر من Parent أحيانًا بعد Merge.
شارك التاريخ مع Remote
Remote اتصال مسمى بـRepository أخرى. الاسم origin شائع افتراضيًا، لكنه مجرد اسم مستعار وليس Server خاصًا بحد ذاته.
git remote -v
git fetch origin
git status
git push -u origin feature/search-empty-state
- ينزّل
git fetchالكائنات الجديدة ويحدّث مراجع Remote-Tracking؛ ولا يغيّر ملفاتك الحالية بصمت. - ينفذ
git pullعملية Fetch ثم يدمج التغيير البعيد، عادةً عبر Merge أو Rebase حسب الإعدادات والخيارات. - يرسل
git pushCommits المحلية إلى Branch على Remote. يستخدم أول Push عادةً الخيار-uلتذكر Branch التي يتتبعها.
قبل المشاركة، نفّذ Fetch وافحص التغييرات. إذا كان للفريق أسلوب Pull معتاد، التزم به؛ فخلط Merge وRebase دون فهم قد يجعل التاريخ مربكًا.
Pull Requests وMerge Requests: طبقة المراجعة البشرية
في GitHub يقترح Pull Request (PR) دمج Branch في أخرى. وفي GitLab يؤدي Merge Request (MR) دورًا مشابهًا. تختلف التسمية، لكن الفكرة واحدة: اعرض Diff مركزًا، واشرح القصد، وشغّل الفحوصات، وناقش الملاحظات، ثم قرر هل حان وقت الدمج.
المراجعة الصحية حوار حول التغيير لا حول الشخص. اجعل PR/MR مركزة، واشرح المشكلة التي تحلها، واربط العمل ذي الصلة، واذكر المخاطر أو الصور إن كانت مفيدة. على المراجع طلب توضيح إذا كان القصد غامضًا، وألا يوافق إلا عندما يلتزم التغيير بمعايير المشروع.
| المرحلة | ما يفعله المساهم | ما يكسبه الفريق |
|---|---|---|
| Branch | يعزل جزءًا واحدًا من العمل. | وحدة قابلة للمراجعة بدل هدف يتغير باستمرار. |
| Commit وPush | يسجل العمل ويشاركه. | تاريخ يمكن تتبعه وDiff واضح. |
| PR/MR | يشرح التغيير ويطلب المراجعة. | سياق ونقاش وقرار صريح. |
| Checks | تشغّل Automation. | مؤشرات قابلة للتكرار قبل الدمج. |
| Merge | يدمج العمل المقبول. | تاريخ مشترك يستطيع الفريق البناء عليه. |
تعارضات Merge دون ذعر
يعني Merge Conflict أن Git لا يستطيع تحديد كيفية جمع تغييرين بأمان. هذا ليس فشلًا ولا يعني ضياع عملك. يضع Git علامة على الملف المتأثر ويتوقف ليختار شخص النتيجة المقصودة.
- اقرأ الملف وافهم التغييرين قبل التعديل.
- ابحث عن علامات التعارض:
<<<<<<<و=======و>>>>>>>. - احتفظ بالأسطر الصحيحة أو اجمعها أو أعد كتابة القسم بنتيجة متماسكة.
- احذف جميع علامات التعارض، وشغّل الفحوصات المناسبة، ثم جهّز الملف المحلول.
- أنهِ بـ
git commitبعد Merge، أوgit rebase --continueإذا كنت تحل Rebase.
لا تحل التعارض باختيار “ours” أو “theirs” دون فهم. يعتمد معنى الاسمين على العملية الجارية، وقد يحتوي الجزء المحذوف على إصلاح مهم. إذا لم يكن الاختيار واضحًا، اسأل الكاتب أو المراجع.
Merge أم Rebase؟
تدمج العمليتان العمل، لكنهما تعرضان التاريخ بشكل مختلف.
| العملية | ماذا تفعل؟ | استخدام مناسب |
|---|---|---|
| Merge | تصل التاريخ وقد تنشئ Merge Commit. تحتفظ Commits الحالية بهوياتها. | دمج Branch فريق تمت مراجعتها مع الحفاظ على طريقة اجتماع العمل. |
| Rebase | تعيد تطبيق Commits فوق أساس جديد، فتتغير هوياتها. | ترتيب Branch خاصة بك وغير منشورة قبل المراجعة، إذا كان هذا أسلوب الفريق. |
تجنب Rebase على Commits عامة بنى عليها زملاؤك عملهم؛ فتغيير التاريخ المنشور يجبرهم على إصلاح Branches لديهم. لا تستخدم Force Push إلى Branch مشتركة أو محمية كاختصار. اتفقوا على سياسة للفريق واستخدموا إعدادات حماية Branch والمراجعة في المنصة.
تراجع بأمان: اختر العملية حسب الموقف
لدى Git طرق متعددة للتراجع، ومن السهل الخلط بين أسمائها. ابدأ بـgit status وحدد هل التغيير غير مجهز أو مجهز أو محفوظ محليًا أو تمت مشاركته.
| الموقف | الأداة المعتادة | ما الذي تغيّره؟ |
|---|---|---|
| تجاهل تعديل غير مجهز في ملف متتبع | git restore path/to/file |
يستبدل نسخة العمل من Index. وهذا يلغي ذلك التعديل. |
| إلغاء تجهيز ملف مع إبقاء تعديلاته | git restore --staged path/to/file |
يزيله من Commit القادم، وتظل نسخة العمل معدلة. |
| التراجع عن Commit تمت مشاركته | git revert <commit> |
يضيف Commit جديدًا يعكس التغيير المختار. |
| تغيير رسالة آخر Commit محلي | git commit --amend |
يستبدل آخر Commit؛ تجنب ذلك إذا كان الآخرون يستخدمونه. |
| تحريك مؤشر Branch محلي | git reset |
يغير Commit الذي تشير إليه Branch؛ وتحدد الخيارات ما يحدث للملفات المجهزة وملفات العمل. |
قد يتخلص git reset --hard نهائيًا من عمل غير محفوظ. لا تشغله كأمر عام لـ“إصلاح Git”. يساعد git reflog غالبًا في العثور على مراجع محلية تحركت مؤخرًا، لكنه ليس Backup ولا يضمن استعادة كل ملف محذوف.
حافظ على Repository نظيفة وآمنة
يسرد ملف .gitignore الملفات المولدة أو المحلية التي لا ينبغي لـGit تتبعها. من أمثلته Build Output ومجلدات Dependencies وإعدادات المحرر وملفات .env التي تحتوي إعدادات محلية. لا تزيل قواعد Ignore ملفًا تتم متابعته أصلًا؛ أوقف تتبعه عن قصد وافحص Diff الناتج.
لا تحفظ أسرارًا في Repository. إذا وصل Password أو Token أو Private Key إلى Remote، فحذفه في Commit لاحق لا يكفي؛ قد يبقى السر في التاريخ أو نسخ الآخرين. ألغِه أو غيّره أولًا، وأبلغ مالك المشروع، واتبع إجراء المؤسسة.
فضّل إعدادات النصوص على الملفات الثنائية الكبيرة عندما يكون ذلك عمليًا. قد تناسب Git Large File Storage (Git LFS) الأصول الكبيرة، لكن تحقق من دعم خدمة الاستضافة والمتعاونين. Git ممتاز لتاريخ الملفات النصية؛ وليس أرشيف وسائط أو Backup تلقائيًا.
اقرأ تاريخ المشروع واستكشفه
git log --oneline --graph --decorate --all
git show <commit>
git diff main...feature/search-empty-state
git blame path/to/file
يعرض git log القصة، ويفحص git show Commit واحدة، ويقارن Diff بثلاث نقاط Branch بقاعدة دمجهما. يعرض git blame آخر Commit غيّر كل سطر؛ إنه أداة تتبع وليس وسيلة لإلقاء اللوم على شخص.
أدوات مفيدة عندما تصبح القصة أعقد:
- Stash: ضع تغييرات العمل المتتبعة جانبًا مؤقتًا باستخدام
git stash؛ وافحصgit stash listقبل تطبيق مدخل قديم. - Cherry-pick: طبّق Commit مختارة على Branch أخرى. ينشئ ذلك Commit جديدة، لذا قد يظهر التغيير نفسه مرتين في التاريخ.
- Bisect: استخدم
git bisectللبحث في التاريخ عن Commit التي أدخلت Regression. - Reflog: افحص التحركات المحلية الأخيرة لـ
HEADومراجع Branch. - Tags: سمِّ نقطة مهمة، غالبًا Release؛ وعلى عكس Branch من المفترض أن يبقى Release Tag ثابتًا.
- Submodules: اربط Repository محددة بCommit من Repository أخرى. تضيف خطوات إعداد وتحديث، لذا وثّقها بوضوح.
Releases وأرقام الإصدارات
يسمي Tag نقطة مهمة باسم ثابت مثل v1.4.0. وتستطيع منصة الاستضافة استخدام Tag لإنشاء Release مع ملاحظات وملفات جاهزة للتنزيل. تسجل Tags نقطة في التاريخ؛ لكن عملية Release ما زالت تحتاج إلى Tests ومراجعة وخطة تراجع.
تستخدم مشاريع كثيرة Semantic Versioning بالشكل MAJOR.MINOR.PATCH. في صيغته الشائعة، يشير Major إلى تغيير غير متوافق في Public API، وMinor إلى ميزة متوافقة، وPatch إلى إصلاح متوافق للأخطاء. ينبغي للفريق إعلان وعود التوافق التي يتبعها؛ فالرقم وحده لا يضمن الجودة.
GitHub أم GitLab؟
تستضيف المنصتان Git Repositories وتدعمان Issues ومراجعة Code والصلاحيات وAutomation. هما منتجان بميزات متداخلة، وليستا نظامي Version Control مختلفين.
| الاعتبار | GitHub | GitLab |
|---|---|---|
| اسم المراجعة | Pull Requests | Merge Requests |
| Automation المرتبطة به عادةً | GitHub Actions | GitLab CI/CD |
| خيارات الاستضافة | استضافة GitHub وخيارات مؤسسات مدعومة | استضافة GitLab أو إدارة الخدمة ذاتيًا |
| طريقة الاختيار | افحص Integrations والحوكمة وسير عمل الفريق الحالي. | افحص Integrations والحوكمة والاستضافة وما يستطيع الفريق تشغيله. |
لا توجد منصة هي الأفضل تلقائيًا لكل مشروع. اختَر وفق متطلبات الأمان وIntegrations والاستضافة والدعم والتكلفة وقدرة الفريق على صيانة سير العمل.
من Commit إلى CI/CD
يشغّل Continuous Integration (CI) فحوصات قابلة للتكرار عند مشاركة التغييرات: Tests وLinting وBuilds وأحيانًا فحوصات أمان. ويمد Continuous Delivery/Deployment (CD) هذا المسار نحو تجهيز البرنامج وإطلاقه. تستطيع GitHub Actions وGitLab CI/CD تشغيل Workflows، لكن موثوقية Automation تعتمد على صلاحياتها وإعداداتها.
أبقِ Deployment Credentials خارج ملفات المصدر. امنح Automation أقل صلاحيات تحتاجها، واحمِ Branches وEnvironments الخاصة بالإصدارات، وراجع تغييرات Pipeline، وحدد الفحوصات الواجب نجاحها قبل Release. علامة النجاح دليل مفيد، وليست برهانًا أن البرنامج آمن أو صحيح.
مشروع عملي للطالب
أنشئ Notes App صغيرة أو موقعًا شخصيًا أو مشروعًا دراسيًا داخل Repository تملكها:
- أنشئ Repository وأضف README قصيرة.
- احفظ نقطة البداية في Commit برسالة تشرحها.
- أنشئ Feature Branch وأجرِ تغييرًا واضحًا واحدًا.
- افحص العمل باستخدام
git diffوgit status، ثم جهّز الملفات المقصودة فقط. - ارفع Branch إلى GitHub أو GitLab وافتح PR/MR.
- اطلب من زميل إضافة ملاحظة مراجعة مفيدة، ثم أجب عنها بـCommit متابعة.
- ادمج التغيير، وأضف Version Tag، واكتب Release Notes تشرح ما تغيّر.
- جرّب تعارضًا بسيطًا على Branch مؤقتة وحلّه دون حذف عمل أي طرف.
النجاح ليس في عدد الأوامر. بل في قدرتك على شرح ما تغيّر ولماذا، وكيف يستطيع الفريق متابعة العمل بأمان.
قاموس مختصر
| المصطلح | المعنى |
|---|---|
| Repository / repo | مجلد المشروع مع تاريخ Git وإعداداته. |
| Commit | نقطة محفوظة في التاريخ، لها Hash. |
| Branch | اسم متحرك لمسار من Commits. |
| HEAD | مرجع Git إلى Checkout الحالي. |
| Working Tree | الملفات التي تعمل عليها الآن. |
| Index / staging area | محتوى Commit القادمة المقترح. |
| Remote | اتصال مسمى بـRepository أخرى. |
| Fetch | تنزيل تاريخ Remote دون دمجه في Branch الحالية. |
| Merge | وصل تاريخين. |
| Rebase | إعادة تطبيق Commits على أساس آخر مع تغيير هوياتها. |
| Conflict | تغيير يحتاج إلى شخص كي يوفّق بينه وبين تغيير آخر. |
| Pull Request / Merge Request | اقتراح مستضاف لمراجعة تغييرات ودمجها. |
| Tag | اسم ثابت مرتبط بCommit مهمة. |
| CI/CD | خطوات Build وTest وDelivery المؤتمتة والمرتبطة بالتغييرات. |
مراجع رسمية
- Git documentation — مرجع الأوامر والمفاهيم.
- Pro Git book — دليل مفصل ومجاني لـGit.
- GitHub flow — سير عمل Branch والمراجعة في GitHub.
- GitHub pull requests — إنشاء تغييرات مقترحة ومراجعتها.
- GitLab Flow — إرشادات Branch وRelease.
- GitLab CI/CD — Pipelines وJobs وAutomation.
- Conventional Commits — معيار اختياري لرسائل Commit.
- Semantic Versioning — مواصفة ترقيم الإصدارات.