به Git و GitHub برای مبتدیان خوش آمدید! این راهنمای جامع برای کمک به شما در حرکت در دنیای کنترل نسخه و همکاری طراحی شده است.

چه تازه واردی باشید که تازه شروع به کار کرده اید یا یک توسعه دهنده با تجربه باشید که به دنبال تقویت مهارت های خود هستید، این راهنما یک رویکرد گام به گام برای درک و استفاده موثر از Git و GitHub ارائه می دهد.

در پایان این سفر، پایه محکمی در Git و GitHub خواهید داشت. شما به دانش عملی مجهز خواهید شد تا گردش کار کدنویسی خود را ساده کنید، به طور یکپارچه با تیم ها همکاری کنید و در پروژه های منبع باز مشارکت کنید.

پس ، بیایید وارد ماجرا شویم و ماجراجویی Git و GitHub خود را شروع کنیم!

فهرست مطالب

این راهنما برای چه کسانی است؟

فن آوری ها

مقررات

GitHub چیست؟

GitHub برای چه مواردی استفاده می شود؟

کارهای رایجی که با Git انجام خواهید داد

نحوه نصب Git

نحوه پیکربندی Git

نحوه تنظیم ویرایشگر پیش فرض

نحوه ایجاد یک مخزن با استفاده از وب سایت Github

نحوه ایجاد یک مخزن با استفاده از خط فرمان Git

چگونه یک مخزن محلی را به یک مخزن راه دور در GitHub متصل کنیم

چگونه تغییرات را از یک مخزن راه دور به یک مخزن محلی بکشیم

نحوه کار با دستورات Git

نحوه ایجاد تغییرات در یک فایل

نحوه تحلیل وضعیت شعبه فعلی

نحوه صحنه سازی تغییرات

نحوه انجام تغییرات

نحوه فشار دادن تغییرات به یک مخزن راه دور

نحوه ایجاد شعبه

نحوه ایجاد درخواست کشش

نحوه ادغام درخواست کشش

بسته بندی

این راهنما برای چه کسی است؟

این راهنما برای همه کسانی است که می خواهند مهارت های کدنویسی خود را ارتقا دهند و در استفاده از Git و GitHub مهارت پیدا کنند.

این که آیا شما:

تازه کار فنی خود را شروع کرده اید و باید اصول کنترل نسخه را یاد بگیرید.

یک توسعه دهنده مشتاق برای ادغام Git در گردش کار شما.

یک برنامه نویس باتجربه که به دنبال تازه کردن دانش شما یا کشف ویژگی های جدید است.

سرپرست تیم یا مدیری که علاقه مند به پرورش فرهنگ همکاری و مدیریت کد کارآمد است.

صرف نظر از سابقه یا تجربه شما، این راهنما برای توانمندسازی شما با ابزارها و دانش مورد نیاز برای برتری در تلاش های کدنویسی طراحی شده است.

فن آوری ها

قبل از شروع، مطمئن شوید:

شما یک حساب GitHub دارید

Git روی دستگاه شما نصب شده است

شما یک ویرایشگر متن مانند Visual Studio Code نصب کرده اید

Node.js روی دستگاه شما نصب شده است

مقررات

آنها اصطلاحات زیادی در مورد Git و Github هستند که ممکن است هنگام کار با کنترل نسخه با آنها برخورد کنید. اجازه دهید قبل از شروع آن را برای شما شرح دهم:

Branch : نسخه ای از پایگاه کد که از شاخه اصلی جدا می شود تا تغییرات را برای ویژگی ها، اصلاحات یا آزمایشات خاص جدا کند.

Commit : یک عکس فوری از تغییرات شما که در مخزن محلی شما ذخیره شده است. هر commit به طور منحصر به فرد توسط یک چک سام شناسایی می شود.

مرحله : ناحیه ای که Git تغییراتی را که آماده گنجاندن در commit بعدی هستند، ردیابی می کند. فایل‌های موجود در ناحیه مرحله‌بندی برای کامیت بعدی آماده می‌شوند.

ادغام : فرآیند ادغام تغییرات از یک شاخه به شاخه دیگر، معمولاً شاخه اصلی.

درخواست کشش : پیشنهادی برای ادغام تغییرات از یک شاخه به شاخه دیگر، که اغلب در محیط های مشارکتی برای تحلیل و بحث درباره تغییرات قبل از ادغام آنها استفاده می شود.

Fork : یک کپی شخصی از پروژه شخص دیگری که در حساب GitHub شما زندگی می کند.

Clone : ​​عمل بارگیری یک مخزن از یک منبع راه دور به دستگاه محلی شما.

Remote : یک مخزن مشترک که همه اعضای تیم برای تبادل تغییرات خود از آن استفاده می کنند.

مبدا : نام پیش فرض Git به سروری که از آن کلون کرده اید می دهد.

Upstream : مخزن اصلی که شبیه سازی شده است.

Master : نام شعبه پیش‌فرض که هنگام ایجاد مخزن به آن داده می‌شود. در عمل مدرن، اغلب با main جایگزین می شود.

مخزن : محل ذخیره سازی که پروژه شما در آن زندگی می کند و شامل تمام فایل ها و تاریخچه ویرایش است.

دایرکتوری کاری : دایرکتوری روی رایانه شما که در آن در حال ایجاد تغییرات در پروژه خود هستید.

منطقه مرحله بندی : همچنین به عنوان "شاخص" شناخته می شود، این منطقه ای است که در آن Git تغییراتی را که آماده انجام هستند ردیابی می کند.

Index : نام دیگری برای ناحیه استیجینگ، جایی که Git تغییراتی را که آماده انجام هستند ردیابی می کند.

HEAD : اشاره ای به آخرین commit در شعبه ای که در حال حاضر تحلیل شده است.

پرداخت : عمل تغییر از یک شعبه به شعبه دیگر یا به یک تعهد خاص.

Push : عمل ارسال commit های شما به یک مخزن راه دور.

کشش : عمل واکشی تغییرات از یک مخزن راه دور و ادغام آنها در شعبه فعلی شما.

واکشی : عمل بازیابی به روز رسانی ها از یک مخزن راه دور بدون ادغام آنها در شعبه فعلی شما.

GitHub چیست؟

GitHub پلتفرمی است که کد را میزبانی می کند، کنترل نسخه و ویژگی های همکاری را ارائه می دهد. این شما و دیگران را قادر می سازد تا با یکدیگر در پروژه ها از هر نقطه از جهان کار کنید.

این راهنما شما را با مفاهیم ضروری GitHub مانند repositories ، branches ، commits و Pull Requests آشنا می کند. شما یاد خواهید گرفت که چگونه مخزن Hello World خود را ایجاد کنید و گردش کار درخواست کشش GitHub را درک کنید، روشی پرکاربرد برای ایجاد و تحلیل کد.

در پایان این راهنما، شما به دانش و مهارت‌های لازم برای همکاری مؤثر در GitHub مجهز خواهید شد.

GitHub برای چه مواردی استفاده می شود؟

GitHub چیزی بیش از یک پلتفرم میزبانی کد است. این ابزاری است که امکان همکاری یکپارچه و کنترل نسخه را فراهم می کند. در اینجا به برخی از کاربردهای آن اشاره می کنیم:

میزبانی و به اشتراک گذاری کد خود با دیگران.

پیگیری و تعیین مسائل برای حفظ یک گردش کار سازمان یافته.

مدیریت درخواست های کششی برای تحلیل و گنجاندن تغییرات در پروژه شما.

ایجاد وب سایت خود با استفاده از GitHub Pages، یک سرویس میزبانی سایت ثابت.

همکاری با دیگران در پروژه ها، که آن را به ابزاری عالی برای مشارکت های منبع باز تبدیل می کند.

گیت چیست؟

Git یک سیستم کنترل نسخه توزیع شده رایگان و منبع باز است. این طراحی شده است تا همه چیز را از پروژه های کوچک گرفته تا بسیار بزرگ را با سرعت و کارایی انجام دهد

یادگیری Git آسان است و ردپایی کوچک با عملکرد سریع رعد و برق دارد. این ابزار از ابزارهای SCM مانند Subversion، CVS، Perforce و ClearCase با آپشن های ی مانند انشعاب محلی ارزان، مناطق مرحله‌بندی راحت و گردش‌های کاری متعدد، برتری دارد.

Git در ابتدا توسط لینوس توروالدز برای توسعه هسته لینوکس طراحی و توسعه داده شد.

برخی از ویژگی ها/مزایای Git:

به شما امکان می دهد تغییرات کد خود را در طول زمان پیگیری کنید.

به شما این امکان را می‌دهد تا با دیگران در همان پایگاه کد همکاری کنید.

شما می توانید به راحتی به نسخه قبلی کد خود برگردید یا ویژگی های جدید را بدون تأثیرگذاری بر پایه کد اصلی آزمایش کنید.

سابقه ای از تمام تغییرات ایجاد شده در کد شما، از جمله اینکه چه کسی آنها را انجام داده و چه زمانی می تواند برای ممیزی و اشکال زدایی مفید باشد، ارائه می دهد.

وظایف رایجی که با Git انجام خواهید داد

یک مخزن ایجاد کنید

یک شعبه ایجاد کنید

تغییراتی در یک فایل ایجاد کنید

تغییرات مرحله ای

تغییرات را متعهد شوید

تغییرات را به یک مخزن از راه دور فشار دهید

ادغام تغییرات

برگرداندن تغییرات

یک شاخه را حذف کنید

نحوه نصب Git

برای نصب Git بر روی دستگاه محلی خود، باید این مراحل را دنبال کنید:

Git را از وب سایت رسمی دانلود کنید: Git Downloads

Git را بر روی دستگاه محلی خود با دنبال کردن دستورالعمل های ارائه شده در وب سایت رسمی نصب کنید: نصب Git

تبریک می گویم! شما با موفقیت Git را روی دستگاه محلی خود نصب کرده اید. اکنون آماده شروع استفاده از Git برای پروژه های خود هستید.

نحوه پیکربندی Git

Git پیکربندی های مختلفی را ارائه می دهد که می تواند گردش کار شما را ساده کند. در این بخش، من شما را از طریق فرآیند راه اندازی Git در دستگاه محلی خود راهنمایی می کنم. بیا شروع کنیم.

پیکربندی name و آدرس email خود در دستگاه محلی شما یک مرحله ضروری در راه اندازی Git است. این جزئیات به هر تعهدی که انجام می‌دهید پیوست می‌شود و زمینه و مالکیت را فراهم می‌کند. بیایید یاد بگیریم که چگونه از دستور git config --global برای تنظیم نام و ایمیل خود به صورت سراسری در دستگاه محلی خود استفاده کنیم.

برای تنظیم نام خود، باید دستور زیر را در ترمینال خود تایپ کنید:

 # Set a name that is identifiable for credit when reviewing version history $ git config --global user.name "Your Name" 

همانطور که در تصویر بالا مشاهده می کنید، من نام خود را وارد کرده ام.

پس از وارد کردن نام خود، Enter فشار دهید تا آن را ذخیره کنید. شما هیچ پاسخی دریافت نخواهید کرد، اما مطمئن باشید نام شما با موفقیت ذخیره شده است.

همانطور که نام کاربری را تنظیم می کنیم، باید ایمیل کاربر را نیز تنظیم کنیم. این ایمیل با هر تعهدی که انجام می دهید مرتبط می شود. بیایید یاد بگیریم که چگونه از دستور git config --global برای تنظیم سراسری ایمیل خود در دستگاه محلی خود استفاده کنیم.

 # Set an email address that will be associated with each history marker $ git config --global user.email "your-email@example.com" 

مطمئن شوید که آن را با ایمیل واقعی خود که در حساب GitHub شما استفاده شده است جایگزین کنید.

اکنون که تنظیم نام کاربری و ایمیل شما را برای Git و GitHub به پایان رساندیم، اجازه دهید تحلیل کنیم که همه چیز به درستی پیکربندی شده است.

برای این کار از دستور زیر استفاده کنید:

 git config --global --list .

این دستور نام کاربری و ایمیل مورد استفاده در کنسول را برای دیدن شما فهرست می کند.

شما باید برخی از اطلاعات را در ترمینال خود مشاهده کنید.

نحوه تنظیم ویرایشگر پیش فرض

در توسعه مدرن، داشتن یک ویرایشگر کد می تواند گردش کار شما را به طور قابل توجهی ساده کند، به خصوص زمانی که بر روی کدنویسی متمرکز هستید.

اکنون، بیایید ببینیم که چگونه Git را برای استفاده از یک ویرایشگر پیش فرض با استفاده از این دستور پیکربندی کنیم:

 # Set the default editor for Git $ git config --global core.editor "code --wait"

تبریک می گویم! شما با موفقیت Git را در دستگاه محلی خود پیکربندی کرده اید. اکنون آماده شروع استفاده از Git برای پروژه های خود هستید.

نحوه ایجاد یک مخزن با استفاده از وب سایت Github

ایجاد یک مخزن اولین قدم در استفاده از Git است. مخزن یک مکان ذخیره سازی است که پروژه های شما در آن زندگی می کنند و شامل تمام فایل ها و تاریخچه ویرایش است.

در این بخش، من شما را از طریق فرآیند ایجاد یک مخزن در GitHub راهنمایی می کنم.

دو راه برای ایجاد یک مخزن وجود دارد: استفاده از GitHub website یا خط فرمان. بیا شروع کنیم. در این بخش، ما بر روی ایجاد یک مخزن با استفاده از وب سایت GitHub و خط فرمان تمرکز خواهیم کرد.

پس از ورود به حساب GitHub خود، می توانید با دنبال کردن مراحل زیر یک مخزن جدید ایجاد کنید:

روی علامت + در گوشه سمت راست بالای صفحه کلیک کنید و از منوی کشویی New Repository را انتخاب کنید.

در بالا تصویری از دکمه مخزن جدید در GitHub است.

شما به صفحه جدیدی هدایت می شوید که در آن می توانید جزئیات مخزن جدید خود را پر کنید. شما باید اطلاعات زیر را وارد کنید:

Repository name : این نام مخزن شما است. باید منحصر به فرد و توصیفی باشد.

Description : شرح مختصری از مخزن شما.

Public or Private : می توانید مخزن خود را عمومی یا خصوصی کنید. مخازن عمومی برای همه قابل مشاهده است، در حالی که مخازن خصوصی فقط برای شما و افرادی که آنها را با آنها به اشتراک می گذارید قابل مشاهده است.

این مخزن را با یک README Initialize : می توانید مخزن خود را با یک فایل README مقداردهی اولیه کنید. اگر می خواهید اطلاعاتی در مورد پروژه خود یا دستورالعمل هایی در مورد نحوه استفاده از آن ارائه دهید، این کار مفید است.

تصویر بالا فرمی را نشان می دهد که در آن جزئیات مخزن جدید خود را پر می کنید.

پس از پر کردن جزئیات، روی دکمه Create Repository کلیک کنید تا مخزن جدید خود را ایجاد کنید.

تصویر بالا دکمه Create Repository نشان می دهد.

تبریک می گویم! شما با موفقیت یک مخزن جدید در GitHub ایجاد کردید. اکنون می توانید شروع به اضافه کردن فایل ها و ایجاد تغییرات در مخزن خود کنید.

شما باید صفحه ای مانند صفحه زیر را ببینید:

حالا بیایید با استفاده از خط فرمان یک مخزن ایجاد کنیم.

نحوه ایجاد یک مخزن با استفاده از خط فرمان Git

برای ایجاد یک repository جدید با استفاده از خط فرمان، باید مراحل زیر را دنبال کنید:

ترمینال خود را باز کنید و به دایرکتوری که می خواهید مخزن جدید خود را در آن ایجاد کنید بروید.

از دستور git init برای ایجاد یک مخزن جدید استفاده کنید. این دستور یک دایرکتوری جدید به نام .git در دایرکتوری فعلی شما ایجاد می کند که شامل تمام فایل های لازم برای مخزن شما خواهد بود.

 # initialize a new repository called my-project $ git init my-project 

تصویر بالا دستور اولیه سازی یک مخزن جدید به نام my-project را نشان می دهد.

هنگامی که مخزن جدید خود را ایجاد کردید، می توانید شروع به اضافه کردن فایل ها و ایجاد تغییرات در آن کنید. همچنین می توانید با دنبال کردن دستورالعمل های ارائه شده در وب سایت GitHub، مخزن محلی خود را به یک مخزن راه دور در GitHub متصل کنید.

تبریک می گویم! شما با موفقیت یک مخزن جدید با استفاده از خط فرمان ایجاد کردید.

اکنون ما با استفاده از وب سایت GitHub و خط فرمان با موفقیت یک مخزن ایجاد کرده ایم – اما چگونه آنها را به هم متصل کنیم؟ حالا بیایید یاد بگیریم که چگونه یک مخزن محلی را به یک مخزن راه دور در GitHub متصل کنیم.

نحوه اتصال یک مخزن محلی به یک مخزن از راه دور در GitHub

برای اتصال مخزن محلی خود به یک مخزن راه دور در GitHub، باید این مراحل را دنبال کنید:

در GitHub، به صفحه اصلی مخزنی که قبلا ایجاد کرده اید بروید.

روی دکمه Code کلیک کنید تا URL مخزن خود را کپی کنید.

تصویر بالا دکمه کد برای کپی URL مخزن شما را نشان می دهد.

در ترمینال خود، به دایرکتوری مخزن محلی خود بروید.

از دستور git remote add origin برای اتصال مخزن محلی خود به مخزن راه دور در GitHub استفاده کنید. Repository-URL را با URL مخزن خود جایگزین کنید.

 $ git remote add origin repository-url 

تصویر بالا فرمان اتصال مخزن محلی شما به مخزن راه دور در GitHub را نشان می دهد.

هنگامی که مخزن محلی خود را به مخزن راه دور در GitHub متصل کردید، می توانید با استفاده از دستور git push تغییرات خود را به مخزن راه دور فشار دهید.

تبریک می گویم! شما با موفقیت مخزن محلی خود را به مخزن راه دور در GitHub متصل کرده اید.

چگونه تغییرات را از یک مخزن راه دور به یک مخزن محلی بکشیم

برای کشیدن تغییرات از مخزن راه دور به مخزن محلی، باید این مراحل را دنبال کنید:

در ترمینال خود، به دایرکتوری مخزن محلی خود بروید.

از دستور git pull برای کشیدن تغییرات از مخزن راه دور به مخزن محلی استفاده کنید.

 $ git pull origin main 

تصویر بالا فرمان انتقال تغییرات از مخزن راه دور به مخزن محلی را نشان می دهد.

پس از آن، با استفاده از دستور زیر در شاخه اصلی حرکت کنید:

 $ git checkout main

تبریک می گویم! شما با موفقیت تغییرات را از یک مخزن راه دور به یک مخزن محلی انجام دادید. مخزن محلی شما اکنون با مخزن راه دور در GitHub* به روز است.

نحوه کار با دستورات Git

در این بخش به برخی از متداول ترین دستورات Git و عملکردهای آنها می پردازیم. این دستورات به شما کمک می کند مسیر خود را در جریان کار Git در مخزن GitHub خود طی کنید. بیا شروع کنیم.

ابتدا چند فایل اضافه می کنم تا بتوانیم از دستورات Git استفاده کنیم.

نحوه ایجاد تغییرات در یک فایل

برای ایجاد تغییرات در یک فایل در Git، باید این مراحل را دنبال کنید:

ترمینال خود را باز کنید و به دایرکتوری مخزن محلی خود بروید.

از یک ویرایشگر متن برای ایجاد تغییرات در فایل استفاده کنید. برای مثال، می توانید از دستور code برای باز کردن فایل در Visual Studio Code استفاده کنید.

 $ code file-name # For example, code index.html

پس از انجام تغییرات، فایل را ذخیره کرده و ویرایشگر متن را ببندید.

تبریک می گویم! شما با موفقیت در یک فایل در مخزن محلی خود تغییراتی ایجاد کردید. بعد، اجازه دهید به مرحله بعدی برویم: تغییرات مرحله‌بندی.

تصویر بالا فایل جدیدی که اضافه کردم را نشان می دهد که یک برنامه React و TypeScript است.

کد ویژوال استودیو (VS Code) شامل یک ویژگی کنترل منبع است که به شما امکان می دهد مستقیماً با مخزن GitHub خود تعامل داشته باشید. این ویژگی از انواع عملیات، از جمله مرحله بندی، ارتکاب، فشار دادن و کشیدن تغییرات پشتیبانی می کند.

علاوه بر ویژگی کنترل منبع، می توانید از ترمینال یکپارچه در VS Code نیز برای تعامل با مخزن GitHub خود استفاده کنید.

در حال حاضر، اگر به بخش کنترل منبع در VS Code نگاه کنید، فایلی را که اضافه کردیم در فهرست تغییرات مشاهده خواهید کرد.

در مرحله بعد، بیایید نحوه استفاده از ترمینال برای تعامل با مخزن GitHub را تحلیل کنیم.

ترمینال خود را باز کنید و به دایرکتوری مخزن محلی خود بروید.

حالا بیایید از دستور git status برای تحلیل وضعیت شاخه فعلی استفاده کنیم.

نحوه تحلیل وضعیت شعبه فعلی

دستور git status وضعیت شاخه فعلی را نشان می دهد، از جمله تغییراتی که در فایل های موجود در مخزن ایجاد شده است. اطلاعاتی در مورد اینکه کدام فایل ها اصلاح شده اند، کدام فایل ها مرحله بندی شده اند و کدام فایل ها ردیابی نشده اند را ارائه می دهد.

این دستور برای درک وضعیت فعلی مخزن شما و تعیین اینکه کدام فایل ها باید مرحله بندی و انجام شوند مفید است.

 # Check the status of the current branch $ git status # On branch master 

تصویر بالا دستور تحلیل وضعیت شاخه فعلی را نشان می دهد.

ممکن است متوجه شوید که قسمت هایی از فایل با رنگ های مختلف برجسته شده است. رنگ red نشان می دهد که فایل اصلاح شده است، در حالی که رنگ green نشان می دهد که فایل به قسمت مرحله اضافه شده است.

در حال حاضر، همه فایل ها باید با red برجسته شوند زیرا ما هنوز هیچ فایلی را به قسمت مرحله اضافه نکرده ایم.

بیایید با استفاده از دستور git add فایل را به ناحیه مرحله بندی اضافه کنیم.

چگونه تغییرات را صحنه سازی کنیم

دستور git add فایل ها را به قسمت مرحله اضافه می کند و آنها را برای commit بعدی آماده می کند. با استفاده از git add . فرمان

اگر می خواهید فایل خاصی را اضافه کنید، از دستور git add <file-name> استفاده کنید و نام فایل خود را جایگزین <file-name> کنید. این فرآیند به مرحله بندی معروف است که فایل ها را برای commit بعدی آماده می کند.

 # Add files to the staging area $ git add . # Changes to be committed: or $ git add file-name # Changes to be committed:

اینطور فکر کنید: سوار شدن به ماشین مانند گفت ن فایل به قسمت صحنه است و رانندگی با ماشین مانند انجام تعهد است.

حالا بیایید از دستور git commit برای انجام تغییرات در شاخه فعلی استفاده کنیم.

نحوه انجام تغییرات

دستور git commit تغییرات را در شاخه فعلی انجام می دهد. می توانید از پرچم -m برای گفت ن پیام به commit خود استفاده کنید. این پیام باید خلاصه‌ای از تغییراتی که ایجاد کرده‌اید ارائه کند.

به عنوان مثال، "تعهد اولیه" می تواند پیام تعهد شما باشد. این دستور برای ذخیره تغییرات در مخزن محلی استفاده می شود.

 # Commit changes to the current branch $ git commit -m "Commit message" # For example, git commit -m "Initial commit"

ما با موفقیت تغییرات را در شاخه فعلی انجام دادیم. در مرحله بعد، این تغییرات را با استفاده از دستور git push به مخزن راه دور در GitHub فشار می دهیم.

چگونه تغییرات را در یک مخزن از راه دور اعمال کنیم

دستور git push تغییرات را از مخزن محلی شما به یک مخزن راه دور در GitHub هدایت می کند. می توانید از دستور git push برای فشار دادن تغییرات از مخزن محلی خود به مخزن راه دور در GitHub استفاده کنید. این فرآیند برای به روز رسانی مخزن راه دور با تغییراتی که به صورت محلی ایجاد کرده اید ضروری است.

 # Push changes to a remote repository $ git push origin main # For example, git push origin master

تبریک می گویم! شما با موفقیت تغییرات خود را در مخزن راه دور در GitHub اعمال کردید. اکنون می توانید تغییرات خود را در وب سایت GitHub مشاهده کنید.

اکنون که با موفقیت تغییرات خود را در مخزن راه دور در GitHub انجام دادیم، بیایید به مرحله بعدی برویم: ایجاد یک شعبه.

بسته به محیط رایانه شخصی شما، مخزن محلی شما ممکن است یک شاخه پیش فرض به نام main یا master داشته باشد. در این راهنما، main به عنوان نام شعبه پیش‌فرض استفاده می‌کنیم که با تغییر اخیر GitHub از master به main همسو می‌شود.

قبل از شروع به گفت ن فایل‌ها، بیایید با انجام هر گونه تغییر، مطمئن شویم که مخزن محلی ما با مخزن راه دور به‌روز است.

اگر اصطلاح branch ناآشنا به نظر می رسد، نگران نباشید. در بخش بعدی، نحوه ایجاد یک شاخه و نحوه کشیدن تغییرات از مخزن راه دور به مخزن محلی را توضیح خواهیم داد.

چگونه یک شعبه ایجاد کنیم

انشعاب یک مفهوم اساسی در Git است. این به شما امکان می‌دهد از خط اصلی توسعه فاصله بگیرید و بدون تأثیرگذاری بر پایه کد اصلی به کار خود ادامه دهید.

در این بخش، من شما را در فرآیند ایجاد یک شاخه جدید با استفاده از دستور git branch راهنمایی می کنم. این دستور یک شاخه جدید ایجاد می کند اما به آن سوئیچ نمی کند. در مراحل زیر، نحوه جابجایی به شعبه جدید ایجاد شده خود را با استفاده از دستور git checkout نیز توضیح خواهیم داد. بیایید شیرجه بزنیم

برای ایجاد یک شعبه جدید، باید مراحل زیر را دنبال کنید:

ترمینال خود را باز کنید و به دایرکتوری مخزن محلی خود بروید.

از دستور git branch برای ایجاد یک شاخه جدید استفاده کنید. نام شعبه جدید خود را جایگزین <branch-name> کنید.

 # Create a new branch $ git branch <branch-name> # For example, git branch feature-branch

دستور git branch یک شاخه جدید ایجاد می کند اما به آن سوئیچ نمی کند. برای جابجایی به شعبه تازه ایجاد شده خود، از دستور git checkout استفاده کنید.

 # Switch to the newly created branch $ git checkout <branch-name> # For example, git checkout feature-branch

دستور git checkout برای جابجایی از یک شاخه به شاخه دیگر استفاده می شود. نام شعبه جدید خود را جایگزین <branch-name> کنید. در این مورد، ما به شاخه feature-branch تغییر می کنیم. اما اگر بخواهیم شاخه را حذف کنیم می توانیم از دستور زیر استفاده کنیم:

 # Delete a branch $ git branch -d <branch-name> # For example, git branch -d feature-branch

دستور git branch -d برای حذف یک شاخه استفاده می شود. <branch-name> را با نام شعبه ای که می خواهید حذف کنید جایگزین کنید. در این مورد، ما شاخه feature-branch حذف می کنیم.

تبریک می گویم! شما با موفقیت یک شعبه جدید ایجاد کردید و به آن تغییر مکان دادید. اکنون می توانید شروع به اضافه کردن فایل ها و ایجاد تغییرات در شعبه جدید خود کنید.

اکنون می دانید که چگونه مخزن GitHub را ایجاد کنید، یک مخزن محلی را به یک مخزن راه دور در GitHub متصل کنید، تغییرات را از یک مخزن راه دور به یک مخزن محلی بکشید، با دستورات Git کار کنید و یک شاخه ایجاد کنید.

بیایید به بخش بعدی برویم، جایی که نحوه ایجاد یک درخواست کشش را پوشش خواهیم داد. این یک گام مهم در گردش کار مشترک است، زیرا به شما امکان می دهد تغییراتی را پیشنهاد دهید و از سایر همکاران درخواست تحلیل کنید.

نحوه ایجاد یک درخواست کشش

درخواست کشش پیشنهادی برای ادغام تغییرات از یک شاخه به شاخه دیگر است. این یک روش پرکاربرد برای ایجاد و تحلیل کد است. در این بخش، من شما را در فرآیند ایجاد یک درخواست کشش با استفاده از وب سایت GitHub راهنمایی می کنم.

به عنوان مثال، فرض کنید یک شاخه به نام feature-branch دارید و می خواهید آن را در شاخه main ادغام کنید. ما شما را با نحوه ایجاد یک درخواست کشش برای این سناریو آشنا خواهیم کرد. بیا شروع کنیم.

ابتدا بیایید با گفت ن یک فایل به شاخه ویژگی خود تغییری ایجاد کنیم:

 $ git checkout feature-branch

شما باید چیزی شبیه به این را در ترمینال خود ببینید:

 git checkout feature-branch Switched to a new branch 'feature-branch' branch 'feature-branch' set up to track 'origin/feature-branch'.

حالا بیایید یک فایل به شاخه ویژگی اضافه کنیم.

 $ touch feature-branch-file.txt

پس از اجرای دستور، باید فایل جدیدی به نام feature-branch-file.txt در دایرکتوری خود مشاهده کنید.

دستور touch برای ایجاد یک فایل جدید استفاده می شود. نام فایل خود را جایگزین feature-branch-file.txt کنید. در این مورد، ما یک فایل جدید به نام feature-branch-file.txt ایجاد می کنیم.

حالا بیایید مقداری محتوا به فایل اضافه کنیم.

 $ echo "This is a file in the feature branch" >> feature-branch-file.txt

این دستور متن "This is a file in the feature branch" را به فایل feature-branch-file.txt اضافه می کند.

دستور echo برای گفت ن محتوا به فایل استفاده می شود. در این مورد، متن "This is a file in the feature branch" را به فایل feature-branch-file.txt اضافه می کنیم.

حالا که مقداری متن در فایل داریم، اجازه دهید مرحله بندی کنیم و تغییرات را در شاخه ویژگی انجام دهیم.

 $ git add .

git add . دستور تمام تغییرات دایرکتوری فعلی را مرحله بندی می کند.

 $ git commit -m "Add file to feature branch"

دستور git commit -m تغییرات را در شاخه فعلی انجام می دهد. Add file to feature branch را با پیام توصیفی خود جایگزین کنید. این پیام باید خلاصه‌ای از تغییراتی که ایجاد کرده‌اید ارائه کند. در این مورد، ما تغییرات را در شاخه ویژگی انجام می دهیم.

اکنون، اجازه دهید تغییرات را به مخزن راه دور در GitHub فشار دهیم.

 $ git push origin feature-branch

دستور git push برای فشار دادن تغییرات از مخزن محلی شما به مخزن راه دور در GitHub استفاده می شود. به جای feature-branch نام شعبه خود را جایگزین کنید. در این مورد، ما تغییرات را به شاخه feature-branch اعمال می کنیم.

تبریک می گویم! شما با موفقیت تغییرات خود را در مخزن راه دور در GitHub اعمال کردید. اکنون می توانید تغییرات خود را در وب سایت GitHub مشاهده کنید.

اکنون هنگامی که مخزن GitHub خود را باز می کنید، باید پیامی را مشاهده کنید که نشان می دهد اخیراً یک شاخه جدید را فشار داده اید. می‌توانید روی دکمه Compare & pull request کلیک کنید تا یک درخواست کشش برای شاخه feature-branch ایجاد کنید.

تصویر بالا دکمه Compare & pull request در GitHub را نشان می دهد.

پس از کلیک بر روی دکمه Compare & pull request به صفحه جدیدی هدایت می شوید که می توانید جزئیات درخواست pull خود را در آن پر کنید.

شما باید اطلاعات زیر را وارد کنید:

عنوان: خلاصه ای از درخواست کشش شما.

توضیحات: شرح مفصلی از درخواست کشش شما، شامل اطلاعاتی در مورد تغییراتی که ایجاد کرده اید و دلیل ایجاد آنها.

بازبینان: می توانید انتخاب کنید که از همکاران خاصی درخواست تحلیل کنید.

افراد واگذار شده: می توانید انتخاب کنید که درخواست کشش خود را به همکاران خاصی اختصاص دهید.

برچسب‌ها: می‌توانید برچسب‌هایی را به درخواست کشش خود اضافه کنید تا آن را دسته‌بندی کنید.

پروژه ها: می توانید انتخاب کنید که درخواست کشش خود را به تابلوی پروژه اضافه کنید.

Milestone: می توانید انتخاب کنید که درخواست کشش خود را به یک نقطه عطف اضافه کنید.

تصویر بالا فرمی را برای پر کردن جزئیات درخواست کشش شما نشان می دهد.

شما می توانید تصمیم بگیرید که جزئیات درخواست کشش خود را ثبت کنید یا درخواست کشش را ایجاد کنید. پس از ایجاد درخواست کشش، می توانید آن را در وب سایت GitHub مشاهده کنید. همچنین می‌توانید از همکاران خاص درخواست تحلیل کنید و در صورت لزوم تغییراتی در درخواست کشش خود ایجاد کنید.

هنگامی که درخواست کشش شما تحلیل و تایید شد، می توانید آن را در شعبه main ادغام کنید. در مورد ما، ما نمی‌خواهیم فرم را ثبت کنیم، اما می‌خواهیم درخواست کشش را ایجاد کنیم.

تصویر بالا درخواست pull ایجاد شده در GitHub را نشان می دهد.

اکنون که یک درخواست کشش ایجاد کرده ایم، به بخش بعدی می رویم، جایی که نحوه ادغام یک درخواست کشش را پوشش می دهیم. این آخرین مرحله در گردش کار مشترک است، زیرا به شما امکان می دهد تغییرات را در پایگاه کد اصلی بگنجانید.

نحوه ادغام یک درخواست کششی

ادغام یک درخواست کشش به معنای ادغام تغییرات از یک شاخه به شاخه دیگر، اغلب شاخه اصلی است. این مرحله در گردش کار مشترک بسیار مهم است و امکان جذب تغییرات در پایگاه کد اولیه را فراهم می کند.

در این بخش، فرآیند ادغام یک درخواست کشش را از طریق وب سایت GitHub مرور خواهیم کرد.

پس از ایجاد یک درخواست کشش، می توانید آن را با انجام مراحل زیر در شاخه main ادغام کنید:

در GitHub، به صفحه اصلی مخزن که در آن درخواست کشش را ایجاد کرده اید، بروید.

برای مشاهده فهرست درخواست های کشش، روی تب Pull requests کلیک کنید.

تصویر بالا برگه Pull requests در GitHub را نشان می دهد.

روی درخواست کششی که می خواهید ادغام شود کلیک کنید.

بر روی دکمه Merge pull request کلیک کنید تا درخواست کشش در شاخه main ادغام شود.

برای تایید Confirm merge ادغام کلیک کنید.

پس از آن باید پیامی را مشاهده کنید که نشان می دهد درخواست کشش با موفقیت ادغام شده است. همچنین می توانید پس از ادغام درخواست کشش، شاخه را حذف کنید.

اکنون درخواست کشش را با موفقیت در شاخه main ادغام کرده اید. اکنون می توانید شاخه feature-branch را حذف کنید، زیرا دیگر به آن نیازی نیست.

بسته بندی

در طول این راهنما، ما به مفاهیم اصلی Git و GitHub پرداخته‌ایم و شما را با درک قوی از کنترل نسخه و شیوه‌های مشارکتی مجهز می‌کنیم.

ما عملیات ضروری Git از جمله راه اندازی یک مخزن، پیوند مخزن محلی به همتای راه دور خود در GitHub، همگام سازی تغییرات بین مخازن محلی و راه دور، اجرای دستورات Git، انشعاب، شروع درخواست های کشش، و ادغام آن درخواست ها را پیمایش کرده ایم.

تسلط بر این اصول به طور قابل توجهی گردش کار کدنویسی شما را افزایش می دهد، همکاری یکپارچه تیمی را تسهیل می کند و مشارکت معنی دار در پروژه های منبع باز را امکان پذیر می کند.

من اطمینان دارم که این راهنما دانش و اعتماد به نفس را در شما القا کرده است تا در سفر برنامه نویسی خود موفق شوید و شروع به مشارکت در پروژه های منبع باز کنید. در اینجا موفقیت شما در کدنویسی است!

برای هرگونه سوال یا بازخورد می توانید با من در توییتر یا لینکدین تماس بگیرید. من دوست دارم از شما بشنوم!

خبرکاو