كيفيه رفع مشروعك على Github باستخدام اداة git
في عصر التكنولوجيا والبرمجة، أصبح من الضروري أن يكون للمطورين وجود قوي على الإنترنت. واحدة من أفضل الطرق لتحقيق ذلك هي رفع مشاريعك البرمجية على GitHub ، المنصة التي تُعتبر بمثابة المنزل الثاني لكل مطور. في هذا المقال الحصري، سنقدم لك دليلاً خطوة بخطوة حول كيفية رفع مشروعك الذي طورته باستخدام Visual Studio Code (VSCode) على GitHub.
ما هو GitHub ولماذا يجب عليك استخدامه؟
GitHub هو منصة استضافة لمستودعات الكود المفتوح، حيث يمكن للمطورين تخزين مشاريعهم، التعاون مع الآخرين، وتتبع التغييرات التي تطرأ على الكود. سواء كنت تعمل على مشروع شخصي أو ضمن فريق، فإن GitHub يوفر أدوات قوية لإدارة الكود وتنظيم العمل.
من خلال رفع مشروعك على GitHub، ستحصل على العديد من الفوائد:
- مشاركة المشروع مع العالم : يمكنك عرض مهاراتك البرمجية للشركات والمجتمع.
- التعاون مع المطورين : يمكن للآخرين المساهمة في تطوير مشروعك.
- إدارة الإصدارات : تتبع التغييرات التي تجريها على الكود بسهولة.
- تحسين ملفك الشخصي : المشاريع المنشورة على GitHub تعزز من فرصك في الحصول على وظيفة.
خطوات رفع مشروع VSCode على GitHub
1. إعداد مشروعك في VSCode
قبل البدء في رفع المشروع على GitHub، تأكد من أن الكود الخاص بك جاهز للنشر. اتبع هذه النصائح:
تنظيم الملفات : ضع الكود في مجلد منظم مع أسماء واضحة.
ملف README.md : أضف ملفًا يشرح فيه المشروع وكيفية استخدامه. هذا الملف مهم جدًا لتحسين SEO لأنه يظهر مباشرة على صفحة المشروع.
ملف .gitignore : حدد الملفات التي لا تريد رفعها إلى GitHub (مثل الملفات المؤقتة أو البيانات الحساسة).
2. إنشاء مستودع جديد على GitHub
قم بتسجيل الدخول إلى حسابك على GitHub.
انقر على زر "New" لإنشاء مستودع جديد.
اختر اسمًا واضحًا ووصفًا دقيقًا للمشروع.
قم بتحديد الخيار "Public" إذا كنت تريد أن يكون المشروع متاحًا للجميع.
3. تهيئة Git في مشروعك
افتح Terminal داخل VSCode وأدخل الأوامر التالية:
git init .
git add .
git commit -m "Initial commit"
ربط المستودع المحلي بـ GitHub
استبدل your-repo-url برابط المستودع الذي نسخته من GitHub:
git remote add origin your-repo-url
git branch -M main
git push -u origin main
حل مشكله error: remote origin already exists
قبل إضافة remote جديد، تحقق من الموجود حاليًا باستخدام
git remote -v
إزالة الـ Remote القديم وإضافة الجديد
لحذف الـ remote القديم وإضافة الجديد، استخدم:
git remote remove origin
git remote add origin your-repo-url
git push -u origin main
حل مشكله
remote: Invalid username or password.
fatal: Authentication failed for 'https://github.com/ahmedmahmoudbit/nodejs-social.git/'
إنشاء Access Token من GitHub
انتقل إلى GitHub Tokens
اضغط على Generate new token (classic)
حدد الصلاحيات التالية:
repo (لإدارة المستودعات)
workflow (للتعامل مع GitHub Actions)
اضغط Generate token ثم انسخ الـ Token.
حاول تنفيذ git push مجددًا
git push origin main
حل مشكله [rejected] main -> main (fetch first) error: failed to push some refs
سحب التغييرات ودمجها
git pull origin main --rebase
حاول الدفع مجددًا بعد نجاح الدمج
git push origin main
