هنگامی که دارید کد هاتون رو کامیت می کنید هیچ وقت کد های کامنت شده رو کامیت نکنید این باعث کثیف شدن پایگاه کد هاتون می شود و همچنین این باعث میشه از اصل کنترل ورژن دورتر شوید.
کثیف شدن پایگاه کد
وقتی که کدهای کامنت‌شده را در مخزن (Repository) خود کامیت می‌کنید، این کدها به عنوان بخشی از تاریخچه‌ی پروژه شما ذخیره می‌شوند. این موضوع باعث می‌شود که پایگاه کد شما پر از کدهای مرده، غیرقابل استفاده و غیرقابل پیگیری شود. به مرور زمان، این کدها می‌توانند باعث افزایش پیچیدگی پروژه شوند و درک کدها را برای توسعه‌دهندگان جدید و حتی خودتان در آینده دشوار کنند.
دوری از اصل کنترل ورژن:
یکی از اصول مهم کنترل ورژن این است که هر تغییر در کد به دقت مستند شود و تاریخچه‌ی تغییرات به صورت واضح و قابل پیگیری باشد. زمانی که شما کدهای کامنت‌شده را کامیت می‌کنید، در واقع دارید کدی را ذخیره می‌کنید که نه کامل است و نه مشخص است که چرا کامنت شده. این باعث می‌شود که دلایل تغییرات به درستی مستند نشود و در آینده برای شما یا همکارانتان فهمیدن دلیل این کامنت‌ها و بازگرداندن کدهای صحیح دشوار شود.
پایبندی به فلسفه کد تمیز:
کد تمیز (Clean Code) به معنای کدی است که خوانا، قابل فهم و بدون شلوغی‌های اضافی باشد. وجود کدهای کامنت‌شده در مخزن شما برخلاف این فلسفه است، زیرا این کدها می‌توانند باعث ایجاد ابهام و سردرگمی شوند. مثلاً ممکن است یک توسعه‌دهنده دیگر از خودش بپرسد که آیا این کد کامنت‌شده باید به کد اصلی اضافه شود یا نه. این موضوع می‌تواند باعث کاهش بهره‌وری و ایجاد خطاهای غیرمنتظره در آینده شود.
راه حل‌های جایگزین:
اگر نیاز دارید که کدی را برای مدت کوتاهی از اجرا خارج کنید ولی همچنان می‌خواهید آن را به یاد داشته باشید، می‌توانید از امکانات کنترل ورژن استفاده کنید. به عنوان مثال، می‌توانید آن کد را به یک شاخه (branch) جداگانه منتقل کنید. در این صورت، هم تاریخچه‌ی پروژه تمیز باقی می‌ماند و هم شما به راحتی می‌توانید در صورت نیاز به آن کد دسترسی داشته باشید.
خلاصه کلام :
در مجموع، کامیت کردن کدهای کامنت‌شده نه تنها باعث کثیف شدن پایگاه کد می‌شود بلکه می‌تواند اصول کنترل ورژن را زیر سوال ببرد و درک و نگهداری پروژه را برای شما و همکارانتان در آینده دشوارتر کند. به جای کامیت کردن کدهای کامنت‌شده، سعی کنید از ابزارهای کنترل ورژن و مدیریت پروژه به درستی استفاده کنید تا پایگاه کد تمیزی داشته باشید.
Anophel آنوفل
#گیت #کامیت #commit
کثیف شدن پایگاه کد
وقتی که کدهای کامنت‌شده را در مخزن (Repository) خود کامیت می‌کنید، این کدها به عنوان بخشی از تاریخچه‌ی پروژه شما ذخیره می‌شوند. این موضوع باعث می‌شود که پایگاه کد شما پر از کدهای مرده، غیرقابل استفاده و غیرقابل پیگیری شود. به مرور زمان، این کدها می‌توانند باعث افزایش پیچیدگی پروژه شوند و درک کدها را برای توسعه‌دهندگان جدید و حتی خودتان در آینده دشوار کنند.
دوری از اصل کنترل ورژن:
یکی از اصول مهم کنترل ورژن این است که هر تغییر در کد به دقت مستند شود و تاریخچه‌ی تغییرات به صورت واضح و قابل پیگیری باشد. زمانی که شما کدهای کامنت‌شده را کامیت می‌کنید، در واقع دارید کدی را ذخیره می‌کنید که نه کامل است و نه مشخص است که چرا کامنت شده. این باعث می‌شود که دلایل تغییرات به درستی مستند نشود و در آینده برای شما یا همکارانتان فهمیدن دلیل این کامنت‌ها و بازگرداندن کدهای صحیح دشوار شود.
پایبندی به فلسفه کد تمیز:
کد تمیز (Clean Code) به معنای کدی است که خوانا، قابل فهم و بدون شلوغی‌های اضافی باشد. وجود کدهای کامنت‌شده در مخزن شما برخلاف این فلسفه است، زیرا این کدها می‌توانند باعث ایجاد ابهام و سردرگمی شوند. مثلاً ممکن است یک توسعه‌دهنده دیگر از خودش بپرسد که آیا این کد کامنت‌شده باید به کد اصلی اضافه شود یا نه. این موضوع می‌تواند باعث کاهش بهره‌وری و ایجاد خطاهای غیرمنتظره در آینده شود.
راه حل‌های جایگزین:
اگر نیاز دارید که کدی را برای مدت کوتاهی از اجرا خارج کنید ولی همچنان می‌خواهید آن را به یاد داشته باشید، می‌توانید از امکانات کنترل ورژن استفاده کنید. به عنوان مثال، می‌توانید آن کد را به یک شاخه (branch) جداگانه منتقل کنید. در این صورت، هم تاریخچه‌ی پروژه تمیز باقی می‌ماند و هم شما به راحتی می‌توانید در صورت نیاز به آن کد دسترسی داشته باشید.
خلاصه کلام :
در مجموع، کامیت کردن کدهای کامنت‌شده نه تنها باعث کثیف شدن پایگاه کد می‌شود بلکه می‌تواند اصول کنترل ورژن را زیر سوال ببرد و درک و نگهداری پروژه را برای شما و همکارانتان در آینده دشوارتر کند. به جای کامیت کردن کدهای کامنت‌شده، سعی کنید از ابزارهای کنترل ورژن و مدیریت پروژه به درستی استفاده کنید تا پایگاه کد تمیزی داشته باشید.
Anophel آنوفل
#گیت #کامیت #commit
Anophel
Anophel | Where Developers Create Their Own Path
Anophel is an ecosystem for developers—a place for those who prefer building over consuming. If you want to create tools, think differently, and forge your own path in coding, Anophel is with you.