Git & GitHub Professional Workflow · درس

إنشاء طلبات السحب ومراجعتها

تعلّم دورة حياة طلب السحب، بدءًا من إنشائه ومراجعته، وصولًا إلى الموافقة عليه ودمجه على GitHub

إنشاء طلبات السحب ومراجعتها درس مجاني في Git & GitHub Professional Workflow على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Git & GitHub Professional Workflow، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Git & GitHub Professional Workflow 4 دروس في المجموع.

ما هي طلبات السحب؟

تُعد طلبات السحب (PRs) جوهر التطوير التعاوني على منصات مثل GitHub. فهي طريقة لاقتراح تغييرات على مشروع وإخضاعها للمراجعة قبل دمجها.

فكّر في PR على أنه طلب رسمي لدمج تعليماتك البرمجية الجديدة في فرع رئيسي، وغالبًا ما يكون main أو develop.

لماذا نستخدم طلبات السحب؟

توفر PRs العديد من الفوائد الأساسية للفرق والمطورين الذين يعملون بمفردهم:

مراجعة التعليمات البرمجية: يمكن للآخرين مراجعة تعليماتك البرمجية بحثًا عن الأخطاء وأفضل الممارسات والتحسينات.
المناقشة: توفر مساحة مخصصة لمناقشة التغييرات.
ضبط الجودة: يضمن عدم وصول سوى التعليمات البرمجية المعتمدة والمختبرة إلى المشروع الرئيسي.
تتبع التغييرات: سجل واضح يبيّن من غيّر ماذا ولماذا.

سير عمل PR: نظرة عامة

يتضمن سير عمل طلب السحب المعتاد الخطوات التالية:

أنشئ فرعًا جديدًا للميزة أو الإصلاح.
أجرِ التغييرات وأودعها في فرعك الجديد.
ادفع فرعك إلى GitHub.
افتح طلب سحب على GitHub.
يقدم المراجعون ملاحظاتهم ويوافقون.
ادمج تغييراتك في الفرع الرئيسي.

الخطوة 1: إنشاء فرع لميزة

قبل إجراء أي تغييرات، من أفضل الممارسات إنشاء فرع جديد. فهذا يبقي عملك معزولًا عن المشروع الرئيسي حتى يصبح جاهزًا.

استخدم git checkout -b لإنشاء فرع جديد والانتقال إليه:

git checkout main
git pull origin main
git checkout -b my-new-feature

الخطوة 2: تنفيذ التغييرات

الآن، أجرِ تغييرات التعليمات البرمجية اللازمة لإضافة ميزتك أو إصلاح الخطأ. بعد الانتهاء، أضِف هذه التغييرات إلى منطقة التجهيز ثم نفّذ لها commit في فرعك الجديد، تمامًا كما تفعل مع أي commit آخر في Git.

# Edit files, e.g., README.md
git add README.md
git commit -m "feat: Add new user profile section"

الخطوة 3: رفع فرعك

بعد تنفيذ commit لتغييراتك محليًا، ارفع فرعك الجديد إلى المستودع البعيد على GitHub. سيجعل ذلك فرعك وعمليات commit الخاصة به مرئية عبر الإنترنت.

يحدّد الخيار -u الفرع upstream، ولذلك تصبح أوامر git push المستقبلية أبسط.

git push -u origin my-new-feature

الخطوة 4: فتح Pull Request

بعد رفع فرعك، سيطلب منك GitHub عادةً إنشاء Pull Request مباشرةً من صفحة مستودعك أو من علامة التبويب "Pull requests".

حدّد فرع الميزات باعتباره head (المصدر).
حدّد فرع main (أو الفرع الهدف) باعتباره base.
أضف عنوانًا ووصفًا واضحين يشرحان التغييرات التي أجريتها.

الخطوة 5: مراجعة Pull Request

بعد فتح PR، يدخل مرحلة المراجعة. سيفحص أعضاء الفريق (المراجعون) تعليماتك البرمجية، ويطرحون الأسئلة أو يقترحون التحسينات.

علامة تبويب Conversation: المناقشات والتعليقات.
علامة تبويب Files changed: الاطلاع على الفروقات الدقيقة في التعليمات البرمجية (diff).
علامة تبويب Commits: عرض عمليات commit الفردية في PR.

الخطوة 6: الملاحظات والموافقات

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

Approve: التعليمات البرمجية جاهزة للدمج.
Request changes: يلزم إجراء المزيد من العمل قبل الدمج.
Comment: تقديم ملاحظات عامة من دون منع الدمج.

قد تحتاج إلى تنفيذ المزيد من عمليات commit في فرع ميزتك استنادًا إلى الملاحظات.

الخطوة 7: دمج PR

بعد الموافقة، يمكن دمج PR في الفرع الأساسي. يوفّر GitHub عدة خيارات للدمج:

Merge commit: يحافظ على جميع عمليات commit من فرع الميزات.
Squash and merge: يدمج جميع عمليات commit في commit جديد واحد.
Rebase and merge: يعيد تشغيل عمليات commit الخاصة بفرع الميزات فوق الفرع الأساسي.

تؤثر الطريقة المختارة في سجل عمليات commit لمشروعك.

اختبار سريع: أساسيات PR

لقد تعلّمت للتو الخطوات الأساسية لإنشاء Pull Requests وإدارتها. فلنختبر مدى فهمك!

مراجعة: إمكانات Pull Request

تُعد Pull Requests أساسية للتعاون الحديث بين أعضاء الفريق. لقد تعلّمت كيفية:

إنشاء فرع جديد لعملك.
رفع فرعك إلى GitHub.
بدء Pull Request.
فهم عملية المراجعة والموافقة.
دمج تغييراتك في المشروع الأساسي.

يُعد إتقان PRs أمرًا أساسيًا للمساهمة بفاعلية في أي مشروع يستند إلى Git!

الأسئلة الشائعة

هل درس «إنشاء طلبات السحب ومراجعتها» مجاني؟

نعم — نص درس «إنشاء طلبات السحب ومراجعتها» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Git & GitHub Professional Workflow، انتقل إلى CoddyKit PRO. تتضمن دورة Git & GitHub Professional Workflow 4 دروس في المجموع.

ماذا ستتعلم في «إنشاء طلبات السحب ومراجعتها»؟

تعلّم دورة حياة طلب السحب، بدءًا من إنشائه ومراجعته، وصولًا إلى الموافقة عليه ودمجه على GitHub تتمرن على Git & GitHub Professional Workflow مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Git & GitHub Professional Workflow؟

لا تُشترط خبرة سابقة. Git & GitHub Professional Workflow على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.

كم من الوقت يستغرق درس «إنشاء طلبات السحب ومراجعتها»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Git & GitHub Professional Workflow هذا؟

نعم. كل درس في Git & GitHub Professional Workflow يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Git & GitHub Professional Workflow