در این آموزش ما برنامه vscode و کدهامون را به گیت هاب وصل میکنیم و شروع به به تبادل می کنیم و در مورد ساختار گیت و اصطلاحاتش صحبت می کنیم
اتصال Visual Studio Code (VSCode) به GitHub به شما امکان میدهد که به صورت مستقیم از داخل محیط ویرایش کد VSCode با GitHub کار کنید. این کار به شما امکان میدهد که کدهای خود را مدیریت کرده، تغییرات را به سیستم کنترل نسخه گیتهاب اضافه کنید، تغییرات را کامیت کنید و با سایر همکاران یا توسعه دهندگان در پروژههای مشترک همکاری کنید.
برای اتصال VSCode به GitHub، مراحل زیر را دنبال کنید:
- نصب گیت و VSCode
- نصب افزونه GitHub
- ورود به حساب GitHub
- مدیریت مخزنها
- کار با تغییرات
- ارسال به GitHub
فهرست مطالب
نصب گیت و VSCode
اگر هنوز گیت و VSCode را نصب نکردهاید، ابتدا آنها را نصب کنید. گیت را از سایت رسمی گیت و VSCode را از سایت رسمی VSCode دانلود و نصب کنید.
ررسی دقیقتر از هر دو راهنمایی میکنم:
نصب Git:
- دانلود گیت: برای شروع، به سایت رسمی گیت بروید.
- انتخاب سیستم عامل: سایت گیت به طور خودکار سیستم عامل شما را تشخیص میدهد و لینک دانلود مخصوص آن را نمایش میدهد. بر روی لینک دانلود کلیک کنید.
- نصب گیت: فایل نصب دانلود شده را اجرا کنید. مراحل نصب ممکن است بسته به سیستم عامل شما متفاوت باشند. هنگام نصب، میتوانید تنظیمات پیشفرض را پذیرفته یا تغییر دهید.
- تنظیم Git: پس از نصب، باید تنظیمات اولیه Git را تنظیم کنید. این شامل تنظیم نام و ایمیل شما است که به عنوان نویسنده کامیتها ثبت میشود. از دستورات زیر برای تنظیم نام و ایمیل استفاده کنید:
git config --global user.name "نام شما"
git config --global user.email "ایمیل شما
نصب Visual Studio Code:
- دانلود VSCode: به سایت رسمی VSCode بروید.
- انتخاب سیستم عامل: سایت VSCode نیز سیستم عامل شما را تشخیص میدهد و لینک دانلود مخصوص آن را نمایش میدهد. بر روی لینک دانلود کلیک کنید.
- نصب VSCode: فایل نصب دانلود شده را اجرا کنید. مراحل نصب نیز بسته به سیستم عامل ممکن است متفاوت باشد. معمولاً فرآیند نصب بسیار ساده و مشابه نصب برنامههای دیگر است.
- نصب افزونهها: پس از نصب VSCode، میتوانید به منوی “Extensions” (Ctrl+Shift+X) بروید و افزونههای مورد نیاز خود را نصب کنید. برخی از افزونههای معروف برای کار با Git و GitHub عبارتند از “GitLens” و “GitHub Pull Requests and Issues”.
- پیکربندی VSCode: ممکن است بخواهید تنظیمات پیشفرض VSCode را تغییر دهید. به منوی “File” > “Preferences” > “Settings” بروید و تنظیمات مورد نظر خود را تنظیم کنید.
اکنون شما گیت و VSCode را با موفقیت نصب کردهاید و میتوانید از آنها برای مدیریت کد و توسعه نرمافزارهای خود استفاده کنید.
نصب افزونه GitHub
در VSCode، به قسمت “Extensions” (Ctrl+Shift+X) بروید و افزونه GitHub را جستجو و نصب کنید. این افزونه به شما ابزارهای مرتبط با GitHub را در VSCode اضافه میکند.
نصب افزونه GitHub در Visual Studio Code بسیار ساده است و به شما اجازه میدهد که به صورت مستقیم از داخل VSCode با GitHub کار کنید. در اینجا مراحل دقیق نصب افزونه GitHub را آوردهام:
- باز کردن Visual Studio Code: ابتدا VSCode را اجرا کنید.
- دسترسی به منوی Extensions: در پنجره VSCode، به منوی “Extensions” (یا از طریق میانبر کلیدی Ctrl+Shift+X) بروید.
- جستجوی افزونه GitHub: در قسمت بالای صفحه Extensions، یک باکس جستجو وجود دارد. در این باکس، “GitHub” را تایپ کنید تا افزونه GitHub جستجو شود.
- نصب افزونه GitHub: نتایج جستجو نمایش داده میشود. افزونه “GitHub Pull Requests and Issues” معمولاً نخستین نتیجه است. بر روی دکمه “Install” در کنار آن کلیک کنید تا افزونه نصب شود.
- تایید نصب: پس از کلیک بر روی دکمه “Install”، فرآیند نصب آغاز میشود. شما میتوانید مشاهده کنید که افزونه GitHub در قسمت Extensions در حال نصب است.
- اجازه به VSCode برای دسترسی به GitHub: به عنوان یک قدم تاییدی، VSCode از شما اجازه میخواهد تا به GitHub وصل شود. بر روی دکمه “Open” در پنجره پیامی که ظاهر میشود کلیک کنید.
- ورود به حساب GitHub: در پنجره باز شده، شما باید به حساب GitHub خود وارد شوید یا حساب جدیدی ایجاد کنید. بر اساس وضعیت ورود، گزینههای “Sign in with your browser” (ورود از طریق مرورگر) یا “Sign in with GitHub Desktop” (ورود از طریق نرمافزار GitHub Desktop) ممکن است ظاهر شود.
- احراز هویت و دسترسی به GitHub: پس از ورود، به VSCode دسترسی به حساب GitHub شما را اعطا کنید. این اطلاعات احراز هویت به منظور اتصال به APIهای GitHub استفاده میشود تا افزونهها بتوانند با اطلاعات حساب شما تعامل کنند.
- نصب تکمیل شد: پس از احراز هویت موفقیتآمیز، افزونه GitHub به درستی نصب و پیکربندی میشود و شما میتوانید از آن برای مدیریت پروژهها و تعامل با مخزنهای GitHub خود استفاده کنید.
اکنون شما افزونه GitHub را با موفقیت نصب کردهاید و میتوانید از ویژگیها و امکانات آن در VSCode بهرهبرداری کنید.
ورود به حساب GitHub
بعد از نصب افزونه GitHub، به منوی “View” بروید، سپس بر روی “Command Palette” (یا از طریق میانبر Ctrl+Shift+P) کلیک کنید. در جستجوی باز شده، “GitHub: Sign in” را جستجو کنید و اطلاعات حساب GitHub خود را وارد کنید.
برای ورود به حساب GitHub خود، مراحل زیر را دنبال کنید:
- باز کردن مرورگر و مراجعه به وبسایت GitHub به آدرس: https://github.com/
- در صفحه اصلی، در بالا سمت راست، دکمه “Sign in” را برای ورود کلیک کنید.
- شما به صفحه ورود هدایت میشوید. در اینجا میتوانید یکی از دو گزینه ورود با استفاده از نام کاربری و رمز عبور خود یا از طریق اکانت Google خود را انتخاب کنید.
- ورود با نام کاربری و رمز عبور:
- فیلد “Username or email address” را پر کنید: نام کاربری یا ایمیل مرتبط با حساب GitHub خود را وارد کنید.
- فیلد “Password” را پر کنید: رمز عبور حساب خود را وارد کنید.
- بر روی دکمه “Sign in” کلیک کنید.
- ورود با اکانت Google:
- بر روی دکمه “Continue with Google” کلیک کنید.
- اگر در حال حاضر به اکانت Google وارد نشدهاید، پنجرهای باز میشود و از شما خواسته میشود که وارد اکانت Google خود شوید یا آن را تأیید کنید.
- پس از وارد شدن یا تأیید اکانت Google، به حساب GitHub خود وارد میشوید.
بعد از مراحل فوق، به حساب کاربری GitHub خود وارد خواهید شد و میتوانید از امکانات و ویژگیهای مختلف GitHub استفاده کنید. اطمینان حاصل کنید که از دسترسی به حساب خود به خوبی محافظت کرده و از رمز عبور قوی استفاده میکنید.
مدیریت مخزنها
با ورود به حساب GitHub خود، میتوانید مخزنهای GitHub خود را در VSCode مدیریت کنید. میتوانید مخزنها را کلون کنید، تغییرات را اعمال کنید، کامیت کنید و تغییرات را به GitHub ارسال کنید.
مدیریت مخزنها در GitHub به شما امکان میدهد تا پروژهها و کدهای خود را مرتبط با حساب کاربری خود در GitHub مدیریت کنید. در زیر به توضیح مراحل و عملکردهای مختلف مدیریت مخزنها در GitHub میپردازم:
- ایجاد مخزن (Repository) جدید:
- پس از ورود به حساب خود، در صفحه اصلی بر روی دکمه “New” در بالا سمت راست کلیک کنید.
- نام مخزن، توضیح کوتاه و نوع مخزن (عمومی یا خصوصی) را تعیین کنید.
- با کلیک بر روی “Create repository”، مخزن جدید ساخته میشود.
- کپی کردن (Fork) مخزن:
- Fork به شما اجازه میدهد یک نسخه از یک مخزن دیگر را به حساب خود منتقل کنید تا به آن اضافه کنید یا تغییرات انجام دهید.
- برای کپی کردن یک مخزن، بروید به مخزن مورد نظر و بر روی دکمه “Fork” در بالا سمت راست کلیک کنید.
- افزودن فایلها و تغییرات:
- با ورود به مخزن خود، میتوانید فایلها و پوشهها را اضافه کنید.
- برای افزودن تغییرات، از دستورات Git مانند
git add
،git commit
وgit push
استفاده کنید.
- افزودن همکاران (Collaborators):
- شما میتوانید افراد دیگر را به عنوان همکاران دعوت کنید تا بتوانند به مخزن شما دسترسی داشته باشند.
- برای افزودن همکاران، به تنظیمات مخزن بروید، بخش “Manage access” را پیدا کنید و از آنجا افراد را اضافه کنید.
- مدیریت Issues و Pull Requests:
- مسائل (Issues) به شما اجازه میدهند مشکلات، پیشنهادات و وظایف را باز کنید و مدیریت کنید.
- Pull Requests به شما اجازه میدهند تغییراتی که انجام دادهاید را از یک شاخه (Branch) دیگر به شاخه اصلی مخزن (مستر) ادغام کنید.
- تنظیمات مخزن:
- در تنظیمات مخزن، میتوانید تنظیمات امنیتی، همکاران، قوانین تائید کننده (Code of Conduct) و بسیاری از تنظیمات دیگر را مدیریت کنید.
- مشاهده تاریخچه (History) تغییرات:
- شما میتوانید تمامی تغییراتی که در مخزن انجام دادهاید را مشاهده کنید و بازبینی کنید.
- رفع اشکال (Bug) و ارائه ویژگیها (Feature):
- با استفاده از Issues و Pull Requests، میتوانید با همکارانتان روی رفع اشکال یا اضافه کردن ویژگیهای جدید کار کنید.
- همکاری در پروژههای دیگر:
- با کپی کردن یا ایجاد Pull Request به پروژههای دیگر هم میتوانید در پروژههای مشترک دیگران همکاری داشته باشید.
مدیریت مخزنها در GitHub از طریق وبسایت، و همچنین از طریق ابزارها و نرمافزارهای CLI (Command Line Interface) که توسط GitHub ارائه میشوند، انجام میشود.
کار با تغییرات GitHub
باز کنید مخزنی که میخواهید با آن کار کنید. ویرایشهای خود را انجام دهید و سپس به قسمت “Source Control” (نماد گیت در نوار کناری چپ) بروید. تغییرات شما در این قسمت نشان داده میشود. میتوانید تغییرات را انتخاب کنید، کامیت کنید و نهایتاً آنها را به GitHub ارسال کنید.
کار با تغییرات (Changes) در GitHub به شما اجازه میدهد تغییراتی که در فایلها و پروژههای خود ایجاد کردهاید را مدیریت، ثبت و ادغام کنید. در زیر توضیحی از مراحل کار با تغییرات در GitHub آمده است:
- ایجاد شاخه (Branch) جدید:
- قبل از ایجاد تغییرات در یک پروژه، معمولاً بهتر است یک شاخه از شاخه اصلی (معمولاً
main
یاmaster
) ایجاد کنید. - برای ایجاد شاخه جدید، به صفحه مخزن خود بروید و دکمه “Branch: main” را کلیک کنید، سپس نام شاخه جدید را وارد کنید و بر روی “Create branch” کلیک کنید.
- قبل از ایجاد تغییرات در یک پروژه، معمولاً بهتر است یک شاخه از شاخه اصلی (معمولاً
- افزودن و تغییر فایلها:
- میتوانید فایلها را در شاخه جدید خود اضافه یا تغییر دهید.
- برای افزودن تغییرات، از دستورات Git مانند
git add
برای افزودن فایلها به تغییرات وgit commit
برای ثبت تغییرات استفاده کنید.
- Push تغییرات:
- پس از انجام تغییرات و ایجاد Commit، با استفاده از دستور
git push
تغییرات خود را به شاخه اصلی روی GitHub ارسال کنید.
- پس از انجام تغییرات و ایجاد Commit، با استفاده از دستور
- ایجاد Pull Request:
- برای ادغام تغییرات از شاخه فعلی به شاخه اصلی، باید یک Pull Request (PR) ایجاد کنید.
- در صفحه مخزن خود، بر روی دکمه “Pull Request” کلیک کنید و تغییرات خود را با توضیحات کوتاه توضیح دهید.
- سپس بر روی “Create Pull Request” کلیک کنید.
- مرور و ادامه فرآیند:
- دیگران میتوانند تغییرات شما را مرور کنند و نظرات خود را ارائه کنند.
- شما میتوانید تغییرات را بازبینی کنید، نظرات را بررسی کنید و در صورت لزوم تغییرات اضافی انجام دهید.
- ادغام تغییرات (Merge):
- پس از اعمال تغییرات و تایید نهایی، میتوانید تغییرات را به شاخه اصلی ادغام کنید.
- با بررسی تغییرات و اطمینان از صحت آنها، بر روی دکمه “Merge pull request” کلیک کنید.
- حذف شاخه جدید:
- پس از ادغام تغییرات، میتوانید شاخه جدید خود را حذف کنید تا شاخه اصلی خالص باقی بماند.
به طور کلی، این مراحل نشاندهنده یک فرآیند معمول برای کار با تغییرات در GitHub است. همچنین، GitHub امکانات ویژهتری همچون تایید کنندهها (Reviewers)، افرادی که میتوانند تغییرات را تصویب کنند، و نظرات دقیقتر را نیز ارائه میکند.
ارسال به GitHub
پس از کامیت تغییرات، میتوانید از منوی “Source Control” گزینه “Push” را انتخاب کنید تا تغییرات شما به مخزن GitHub ارسال شود.
برای ارسال پروژه یا تغییرات خود به GitHub، شما باید از ابزارهای Git استفاده کرده و مراحل زیر را انجام دهید:
- نصب Git: اگر Git را در سیستم خود ندارید، باید ابتدا آن را نصب کنید. به طور معمول، میتوانید Git را از وبسایت رسمی Git دانلود کنید و نصب کنید.
- Clone مخزن (Repository): اگر مخزن خود را قبلاً نکلون نکردهاید، ابتدا باید آن را با استفاده از دستور
git clone
در محیط خط فرمان کلون کنید. مخزن را با اطلاعات clone URL آن (معمولاً HTTPS یا SSH) کلون کنید.git clone <URL مخزن>
- ایجاد یا انتقال به شاخه (Branch) جدید: اگر تغییرات خود را در یک شاخه جدید انجام میدهید، با استفاده از دستور
git checkout -b
یک شاخه جدید ایجاد کنید و به آن منتقل شوید.git checkout -b <نام شاخه جدید>
- افزودن تغییرات: فایلهایی که تغییرات در آنها ایجاد کردهاید را با دستور
git add
به مرحله آمادهسازی برای commit اضافه کنید.git add <نام فایل>
- ثبت تغییرات (Commit): تغییرات آمادهسازی شده را با دستور
git commit
به تاریخچه محلی تغییرات اضافه کنید. همچنین، یک پیام کوتاه درباره تغییرات نیز وارد کنید.git commit -m "پیام توضیحی درباره تغییرات"
- Push تغییرات: با استفاده از دستور
git push
تغییرات خود را به مخزن روی GitHub ارسال کنید. اگر از شاخه جدیدی استفاده میکنید، نام آن را به عنوان نام شاخه در دستور اضافه کنید.git push origin <نام شاخه>
- ایجاد Pull Request: برای ادغام تغییرات خود با شاخه اصلی، یک Pull Request ایجاد کنید. به وبسایت GitHub بروید، به صفحه مخزن خود بروید و دکمه “Pull Request” را کلیک کنید. سپس تغییرات خود را با توضیحات کوتاه توضیح دهید و درخواست ادغام را ایجاد کنید.
- مراقبت از Pull Request: دیگران میتوانند تغییرات شما را بررسی کنند و نظرات خود را ارائه دهند. شما میتوانید تغییرات خود را بازبینی کنید و در صورت لزوم تغییرات اضافی انجام دهید.
- ادغام تغییرات (Merge): پس از تایید تغییرات و رفع نظرات، شما میتوانید تغییرات را با ادغام (Merge) Pull Request به شاخه اصلی ادغام کنید.
با این مراحل، شما میتوانید از VSCode به GitHub متصل شده و کارهای مختلف مدیریت کد و همکاری در پروژهها را انجام دهید.