پث‌وایز

آموزش گیت و گیتهاب از صفردرس ۱۲ از ۱۲

کار تیمی با گیت و گیتهاب: یه روز کاری واقعی

جریان کار روزانه با گیت و گیتهاب رو قدم‌به‌قدم دنبال کن؛ از پول کردن main و ساخت برنچ تا حل کانفلیکت، باز کردن پول ریکوئست و پاک کردن برنچ.

چیزی که از این درس می‌بری

  • یه روز کاری پربازده با پول کردن main شروع می‌شه تا کدت رو روی آخرین کدهای تیم بسازی.
  • چک کردن مداوم git status جلوی فایل‌های اشتباهی و کامیت‌های خراب رو می‌گیره.
  • مرج مداوم main به داخل برنچ فیچرت باعث می‌شه کانفلیکت‌ها کوچیک و بی‌دردسر بمونن.
فهرست این درس۸
  1. شروع کار از یه main به‌روز
  2. قبل از هر حرکتی وضعیت رو چک کن
  3. جریان کار وسط روز: کامیت‌های کوچیک و همگام‌سازی به‌موقع
  4. پوش کردن برنچ و باز کردن PR
  5. اعمال بازخوردها و تمیزکاری
  6. عادت‌های روزانه‌ای که ساعت‌ها برات وقت می‌خرن
  7. چک‌لیست روزانه کار با گیت
  8. مرور درس

۰۱شروع صبح

شروع کار از یه main به‌روز

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

ندا اول دستور git switch main و بعد git pull origin main رو اجرا می‌کنه. فقط وقتی کاملاً به‌روز شد، برنچ تسکش رو با git switch -c fix-login-button می‌سازه.

۰۲عادت طلایی

قبل از هر حرکتی وضعیت رو چک کن

بزرگ‌ترین و پرهزینه‌ترین اشتباه تازه‌کارها، زدن چشم‌بسته دستورهای گیته. اجرای git status فقط ۲ ثانیه وقت می‌گیره، اما سریع بهت نشون می‌ده روی کدوم برنچی، چه فایل‌هایی عوض شدن و چی برای کامیت استیج شده.

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

خودت رو امتحان کنسؤال ۱ از ۴

ندا ساعت ۹ صبح پشت سیستم می‌شینه تا قابلیت آپلود آواتار پروفایل رو بسازه. اولین قدمش توی گیت چی باید باشه؟

  1. بلافاصله از روی همون برنچی که دیروز روش کار می‌کرده یه برنچ جدید بسازه
  2. سوییچ کنه به main، آخرین تغییرات رو از گیتهاب پول کنه و از اونجا برنچ بسازه
  3. ریپازیتوری محلیش رو پاک کنه و دوباره کل پروژه رو کلون کنه
  4. دستور git push --force رو اجرا کنه تا گیتهاب تمام فایل‌های ترک‌نشده صبحش رو دریافت کنه
جواب رو ببین

سوییچ کنه به main، آخرین تغییرات رو از گیتهاب پول کنه و از اونجا برنچ بسازه

دقیقاً درسته. اول از همه پول کردن آخرین نسخه main تضمین می‌کنه که ندا کدش رو روی کارهای دیروز تیم بسازه و از کانفلیکت‌های بعدی دور بمونه.

۰۳قدم‌به‌قدم

جریان کار وسط روز: کامیت‌های کوچیک و همگام‌سازی به‌موقع

  1. ۱. کار روی بخش‌های متمرکز و کوچیک

    یه بخش از منطق برنامه رو بنویس، محلی بررسیش کن، با git status وضعیت رو چک کن و با یه فعل معلوم مثل 'Add image size validation' کامیت کن.

  2. ۲. پول کردن main موقع کار

    ساعت ۱ ظهر، هم‌تیمی ندا، کاوه، رفع باگ پرداخت رو روی main مرج می‌کنه. ندا می‌ره روی main، دستور git pull رو اجرا می‌کنه و برمی‌گرده به برنچ خودش.

  3. ۳. آوردن main به برنچت

    ندا همون موقع توی برنچش دستور git merge main (یا git rebase main) رو اجرا می‌کنه. مرج کردن تغییرات کوچیک موقع کار فقط چند ثانیه طول می‌کشه.

  4. ۴. حل فوری هر کانفلیکت

    اگه هر دو فایل router رو دست زده باشن، ندا فایل رو باز می‌کنه، مارکرهای کانفلیکت رو حل می‌کنه، git add می‌زنه و بدون استرس مرج رو کامل می‌کنه.

خودت رو امتحان کنسؤال ۲ از ۴

امن‌تره صبر کنی تا فیچر دوهفته‌ایت ۱۰۰٪ تموم بشه، بعد تغییرات main رو پول یا مرج کنی.

  1. درست
  2. نادرست
جواب رو ببین

نادرست

غلطه. ۲ هفته صبر کردن باعث می‌شه برنچت فرسنگ‌ها از main فاصله بگیره و به کانفلیکت‌های غول‌پیکر بخوری. همگام کردن روزانه main با برنچت، کانفلیکت‌ها رو خیلی کوچیک و ساده نگه می‌داره.

۰۴باز کردن پول ریکوئست

پوش کردن برنچ و باز کردن PR

وقتی فیچرت تست شد و مرتب بود، برنچت رو با دستور git push -u origin <branch-name> روی گیتهاب بفرست. بعد برو توی گیتهاب و یه پول ریکوئست (PR) باز کن. PR در واقع دعوت از تیمته تا قبل از رفتن کدت به main، درباره‌ش نظر بدن و بررسیش کنن.

ندا عنوان PR رو می‌ذاره 'Add user avatar upload with size validation'، توضیح می‌ده چه بخش‌هایی رو تست کرده، یه اسکرین‌شات از ظاهر کار می‌ذاره و از کاوه می‌خواد کد رو ریویو کنه.

خودت رو امتحان کنسؤال ۳ از ۴

موقع آماده کردن پول ریکوئست (PR)، هر مورد کجا باید قرار بگیره؟

توی PR باشهنباید توی PR باشه

  • توضیح شفاف درباره تغییرات و نحوه تست کردنشون
  • تغییر فرمت تصادفی توی ۲۰ تا فایل نامربوط
  • کامیت‌های کوچیک و هدفمند که روند شکل‌گیری فیچر رو نشون می‌دن
  • یه API key موقت که موقع دیباگ هاردکد کردی
  • اسکرین‌شات‌هایی که نشون می‌دن ظاهر بخش جدید درسته
  • پوشه‌های خروجی بیلد و دایرکتوری‌های node_modules
جواب رو ببین

توی PR باشه: توضیح شفاف درباره تغییرات و نحوه تست کردنشون, کامیت‌های کوچیک و هدفمند که روند شکل‌گیری فیچر رو نشون می‌دن, اسکرین‌شات‌هایی که نشون می‌دن ظاهر بخش جدید درسته

نباید توی PR باشه: تغییر فرمت تصادفی توی ۲۰ تا فایل نامربوط, یه API key موقت که موقع دیباگ هاردکد کردی, پوشه‌های خروجی بیلد و دایرکتوری‌های node_modules

۰۵بررسی کد

اعمال بازخوردها و تمیزکاری

وقتی هم‌تیمی‌ات درخواست تغییر میده، اصلاً لازم نیست یه PR جدید باز کنی. روی همون برنچ بمون، تغییرات رو اعمال کن، کامیت بزن و پوش کن. گیتهاب خودش خودکار کامیت‌های جدیدت رو به گفت‌وگوی همون PR اضافه می‌کنه.

کاوه درخواست می‌کنه خطای فایل‌های SVG هم مدیریت بشه. ندا شرط رو اضافه می‌کنه، دستور git commit -am 'Handle SVG upload error' رو می‌زنه و پوش می‌کنه. بعد از تایید و مرج شدن، ندا با دستور git branch -d برنچ محلی رو پاک می‌کنه.

عادت‌های روزانه‌ای که ساعت‌ها برات وقت می‌خرن

جریان کاری روان و بی‌دردسر

از main به‌روز برنچ می‌گیره، مدام git status رو چک می‌کنه، هر روز با main همگام میشه، برای PR توضیح می‌نویسه و برنچ‌های مرج‌شده رو پاک می‌کنه.

جریان کاری پر از استرس

مستقیم روی main کامیت می‌زنه، ۳ هفته بدون ارتباط با بقیه کد می‌زنه، هشدارهای git status رو نادیده می‌گیره و ده‌ها برنچ رهاشده روی سیستم نگه می‌داره.

خودت رو امتحان کنسؤال ۴ از ۴

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

  • چک کردن برنچ فعلی و فایل‌های کامیت‌نشده
  • ساخت و سوییچ به یه برنچ فیچر تازه
  • منتشر کردن برنچ محلی روی گیتهاب برای اولین بار
  • پاک کردن امن برنچ فیچر بعد از مرج شدنش

git branch -d <name>git push -u origin <name>git statusgit switch -c <name>

جواب رو ببین
  • چک کردن برنچ فعلی و فایل‌های کامیت‌نشده → git status
  • ساخت و سوییچ به یه برنچ فیچر تازه → git switch -c <name>
  • منتشر کردن برنچ محلی روی گیتهاب برای اولین بار → git push -u origin <name>
  • پاک کردن امن برنچ فیچر بعد از مرج شدنش → git branch -d <name>

چک‌لیست روزانه کار با گیت

  • قبل از برنچ ساختن پول کن: همیشه قبل از ساختن برنچ جدید، main محلی رو از گیتهاب به‌روز کن.
  • دستور status آینه توئه: قبل از git add و قبل از git commit حتماً git status بگیر تا فایل‌های اشتباهی اضافه نشن.
  • زودبه‌زود سینک کن: هر وقت هم‌تیمی‌هات تغییرات مهمی روی main مرج کردن، سریع main رو بیار توی برنچ فیچرت.
  • یه PR، یه هدف: پول ریکوئست‌ها رو روی یه مسئله متمرکز نگه دار تا هم‌تیمی‌هات بتونن سریع بررسیش کنن و تأییدش کنن.
  • اصلاحات رو روی همون برنچ بفرست: اعمال بازخورد ریویو روی همون برنچ قبلی کامیت و پوش میشه، نه توی یه PR جدید.
  • برنچ‌های مرج‌شده رو پاک کن: بعد از مرج شدن کار، برنچ محلی رو پاک کن تا لیست برنچ‌هات خلوت و مرتب بمونه.

۰۸جمع‌بندی

مرور درس

  • یه روز کاری پربازده با پول کردن main شروع می‌شه تا کدت رو روی آخرین کدهای تیم بسازی.
  • چک کردن مداوم git status جلوی فایل‌های اشتباهی و کامیت‌های خراب رو می‌گیره.
  • مرج مداوم main به داخل برنچ فیچرت باعث می‌شه کانفلیکت‌ها کوچیک و بی‌دردسر بمونن.
  • پوش کردن کامیت‌های جدید به برنچ فعلی، همون پول ریکوئست باز رو خودکار به‌روز می‌کنه.
  • پاک کردن برنچ‌های مرج‌شده، محیط کار محلیت رو برای فردا تمیز و آماده نگه می‌داره.

به سبک خودت یادش بگیر.

توی اپ از یادآی بخواه این درس رو ساده‌تر توضیح بده، از زندگی خودت مثال بزنه یا عمیق‌تر بره. بعد یه مسیر کامل دور هدف خودت بساز.

Cafe Bazaar Myket توی اپ شخصی‌سازیش کن