شرح SourceTree للمبتدئين لإضافة مستودع محلي وربطه بـ GitHub، ومراجعة الملفات قبل أول Commit وPush دون نشر كلمات المرور أو ملفات التوقيع.
تجهيز المستودع قبل الرفع
SourceTree واجهة رسومية لـ Git، وGitHub خدمة استضافة للمستودعات. أنشئ مستودعًا محليًا فقط إذا لم يكن المشروع يحتوي .git؛ وإلا اختر إضافة المستودع الموجود. ضع قواعد .gitignore المناسبة قبل تحديد الملفات: استثنِ .env ومفاتيح التوقيع ومجلدات البناء والاعتمادات التي يمكن توليدها. الإخفاء بعد نشر السر لا يزيله من التاريخ، ويلزم عندها إبطال السر وتغييره.
المصادقة وربط Remote
أضف رابط المستودع الصحيح كـ origin واختر HTTPS بمصادقة تدعمها GitHub، أو SSH بمفتاح مرتبط بحسابك. لا تضع token في رابط عام أو صورة للشاشة. تحقّق من أن الحساب يملك صلاحية المستودع وأن اسمه ومالكه صحيحان. لا تفترض أن إدخال كلمة مرور حساب GitHub هو طريقة مصادقة Git عبر HTTPS.
أول Commit ثم Push
راجع كل فرق في نافذة الملفات، ثم أضف الملفات المقصودة إلى Staged واكتب رسالة تصف التغيير. اختر الفرع الذي تعمل عليه وحدد تتبعه البعيد. إذا احتوى المستودع البعيد ملفات مثل README، اجلبها وافهم التاريخ قبل الدفع؛ لا تستخدم Force Push لحل رسالة رفض عادية. تحقق أخيرًا من الملفات والفرع في GitHub.
حل المشكلات الشائعة
رسالة nothing to commit تعني عدم وجود تغيير قابل للحفظ في الحالة الحالية، وليست عطلًا. رفض الدفع قد ينتج من صلاحية ناقصة أو تقدم الفرع البعيد؛ استخدم Fetch وافحص الفرق. عند تعارض الدمج راجع الملفات واحدًا واحدًا وشغّل اختبارات المشروع قبل إكماله. للرجوع عن Commit منشور، فضّل Revert الذي ينشئ تغييرًا عكسيًا بدل إعادة كتابة تاريخ الفريق.
المرجع الرسمي
للتفاصيل الخاصة بإصدار الأداة وبيئة التشغيل، راجع توثيق شرح SourceTree للمبتدئين. قد تختلف أسماء القوائم بين الإصدارات؛ طابق الإعداد مع مشروعك قبل تطبيقه.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.
