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

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

به نقل از مهندس نرم‌افزار، مارتین فاولر، "هر کسی می‌تواند کدی بنویسد که یک کامپیوتر آن را بفهمد. برنامه‌نویسان خوب کدی می‌نویسند که انسان‌ها آن را بفهمند."
به عنوان توسعه‌دهندگان نرم‌افزار، درک چگونگی نوشتن کد تمیز که کاربردی، آسان برای خواندن و مطابقت با بهترین شیوه‌ها باشد، به شما کمک می‌کند تا به طور مستمر نرم‌افزار بهتری ایجاد کنید.


#clean_code

👾 @pishroapp

💡یکی از نکاتی که باعث میشه کد شما تمیزتر و بهتر باشه استفاده از نام درست و صحیح برای متغییرها، کلاس ها، توابع و... هست


نام متغیرها باید معنی دار و توصیف کننده داده هایی باشد که توی اون متغیر وجود داره.

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

برای نمونه قطعه کد زیر رو ببینید:

// Bad Example
int x = 5;

// Good Example
int numberOfStudents = 5;

بصورت کلی همونطور که گفتم سعی کنید از اسم های خلاصه شده و نامفهوم در هیچ کجای کد استفاده نکنید🍷

#clean_code


👾 @pishroapp

⭐️ نام توابع باید بصورت فعل باشد

یکی از اصولی که میتونه به تمیز بودن کدِ شما کمک کنه نامگذاری توابع هست

شما باید نام توابع رو جوری انتخاب کنید که بیانگر کاری (فعل) که داره انجام میده باشه

💡 با رعایت این نکته هم نیاز به نوشتن کامنت برای تابع شما کمتر میشه و هم فرد دیگه ای که بخواد کدِ شما رو بخونه خیلی راحت تر متوجه میشه که تابع(متد) قراره چه کاری انجام بده

به چند نمونه زیر دقت کنید:

#دریافت داده
def data(): #bad

def fetchData(): #good

#نمایش لیست
def listItems(): # bad

def displayItems(): # good

💡 میبینید که با این روش و استفاده از افعال برای نامگذاری توابع، عملکرد تابع به راحتی قابل تشخیص هست و به دیگر توسعه دهنده ها هم کمک میشه تا سریعتر کد رو درک کنن

#clean_code

👾 @pishroapp

-اصل Don't Repeat Yourself در کلین کد

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

مثلا اگه یه الگوریتم داری که میاد و بین هر سه رقم یه قیمت کاما میزاره نیای کپیش کنی هرجا که نیاز بود استفادش کنی!

چون اینجوری هر تغییری تو الگوریتم نیاز باشه باید همه جا تک تک عوضش کنی از طرفی کدت شلوغ تر میشه

‼️ راه بهتر اینه که بیای و اون کد رو توی تابع مجزا قرار بدی و هرجا نیاز بود تابع رو صدا بزنی

#clean_code


👾 @pishroapp