آموزش جامع اضافه کردن پروژه به گیت (Git) و گیتهاب (GitHub)
سیستم کنترل نسخه (Version Control System) یکی از حیاتیترین ابزارها برای هر توسعهدهنده نرمافزار است. Git به شما اجازه میدهد تغییرات کد خود را پیگیری کرده، به نسخههای قبلی بازگردید و بهصورت تیمی روی یک پروژه همکاری کنید. همچنین پلتفرمهایی مانند GitHub بستری امن برای ذخیرهسازی ابری و به اشتراکگذاری پروژهها فراهم میکنند.
هر توسعه دهنده وب یا Backend Developer که روی پروژههای مختلف کار میکند، باید نحوه مقداردهی اولیه ریپازیتوری، مدیریت فایلهای نادیدهگرفتهشده و ارسال کدها به مخزن از راه دور (Remote Repository) را بداند. در این مقاله تمامی مراحل افزودن پروژه به گیت و گیتهاب را بهصورت عملی بررسی میکنیم.
🚀 بخش ۱: مقداردهی اولیه مخزن گیت (Git Init)
برای شروع استفاده از گیت در یک پروژه جدید یا قدیمی، ابتدا باید ترمینال را در پوشه اصلی (Root) پروژه باز کرده و مخزن گیت را مقداردهی اولیه کنید.
۱. ورود به مسیر پروژه
ابتدا با دستور cd به پوشه پروژه خود بروید:
cd path to your project۲. ساخت مخزن محلی
با اجرای دستور زیر، یک پوشه مخفی به نام git. ایجاد میشود که تمام تاریخچه تغییرات را ذخیره میکند:
git init🛠️ بخش ۲: تنظیم فایل gitignore. (فایلهای حساس و اضافی)
در پروژهها (بهویژه لاراول یا Node.js)، پوشهها و فایلهایی وجود دارند که نباید وارد گیت شوند؛ مانند پوشه node_modules، پوشه vendor، فایلهای تنظیمات محیطی (.env) و فایلهای لاگ.
پیکربندی فایل gitignore.
یک فایل به نام gitignore. در ریشه پروژه ایجاد کرده و مسیرهای زیر را درون آن قرار دهید:
# فایلهای محیطی و حساس
.env
.env.backup
# وابستگیها و پکیجها
/vendor
/node_modules
# فایلهای لاگ و کش
.phpunit.result.cache
Homestead.json
Homestead.yaml
npm-debug.log
yarn-error.log💡 بخش ۳: افزودن فایلها به Stage و ثبت Commit
قبل از ثبت نهایی تغییرات، باید فایلهای مورد نظر را به منطقه Staging اضافه کنید تا آماده کامیت شوند.
۱. بررسی وضعیت فایلها
برای مشاهده فایلهای تغییریافته و جدید دستور زیر را بزنید:
git status۲. افزودن تمامی فایلها به Staging
با دستور زیر تمام فایلهای پروژه به مرحله آمادهسازی اضافه میشوند:
git add .۳. ثبت کامیت اولیه
با دستور زیر کامیت را به همراه یک پیام توصیفی ثبت کنید:
git commit -m "Initial commit - Add project files"🧪 بخش ۴: دریافت لینک مخزن از گیتهاب (کجا و چگونه؟)
راهنمای قدم به قدم پیدا کردن آدرس URL
۱. وارد سایت GitHub.com شده و وارد حساب کاربری خود شوید. ۲. روی آیکون + در بالای صفحه (سمت راست) کلیک کرده و گزینه New repository را انتخاب کنید. ۳. یک نام برای مخزن خود (مثلاً my-first-project) انتخاب کرده و بدون تیک زدن گزینههای README یا gitignore، روی دکمه Create repository کلیک کنید. ۴. پس از ساخت، صفحهای باز میشود. در بخش Quick setup، آدرس مخزن را میبینید. ۵. مطمئن شوید زبانه روی HTTPS (یا SSH در صورت تنظیم) است، سپس آدرسی که شبیه `https://github.com/username/repository-name.git` است را با کلیک روی آیکون کپی (Copy) بردارید.
🎨 بخش ۵: اتصال پروژه محلی به گیتهاب و ارسال کدها
حالا که لینک مخزن را کپی کردهاید، دستورات زیر را به ترتیب در ترمینال پروژه اجرا کنید:
۱. تغییر نام شاخه اصلی به main
در نسخه جدید گیت، نام شاخه اصلی بهصورت استاندارد main نامیده میشود:
git branch -M main۲. متصل کردن آدرس ریموت
لینک کپی شده از گیتهاب را جایگزین URL زیر کرده و دستور را اجرا کنید:
git remote add origin https://github.com/username/your-repository-name.git۳. ارسال فایلها به گیتهاب
با دستور زیر تمامی کامیتهای محلی روی گیتهاب آپلود میشوند:
git push -u origin main⚡ بخش ۶: دستورات کاربردی روزمره (کاربرد همیشگی)
پس از اتصال اولیه، در طول توسعه پروژه برای ثبت تغییرات جدید طبق مراحل زیر عمل کنید:
گام اول: بررسی وضعیت
دستور مشاهده تغییرات انجامشده:
git statusگام دوم: انتخاب تغییرات
دستور افزودن همه تغییرات جدید:
git add .گام سوم: ثبت کامیت
دستور ثبت پیام کامیت مربوط به تغییرات:
git commit -m "Fix user authentication bug"گام چهارم: دریافت تغییرات جدید (در صورت کار تیمی)
دریافت کدهای جدید ثبتشده توسط سایر همکاران از گیتهاب:
git pull origin mainگام پنجم: آپلود تغییرات روی گیتهاب
ارسال کامیت جدید به سرور گیتهاب:
git push origin main🛠️ جمعبندی؛ مدیریت حرفهای سورسکدها
نکته پایانی برای توسعهدهندگان
استفاده منظم از Git و GitHub نه تنها امنیت کدهای شما را در برابر از دست رفتن اطلاعات تضمین میکند، بلکه رزومه کاری شما را به عنوان یک توسعهدهنده حرفهای شکل میدهد. همیشه متعهد باشید که پیامهای کامیت (Commit Messages) معنادار و توصیفی بنویسید و فایلهای دارای اطلاعات حساس مانند کلیدهای API و رمزهای عبور دیتابیس در .env را هرگز به مخازن عمومی (Public) ارسال نکنید.