قواعد نامگذاری در برنامه نویسی

اهمیت نام گذاری فایل ها

ارتباط با محتوا

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

جلوگیری از تداخل نام ها

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

سازماندهی بهتر

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

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

کاراکتر های مجاز و غیر مجاز در نامگذاری پوشه ها

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

• آلفابتی
• عددی
• خط تیره -
• آندرلاین _
• و نقطه .

مجاز هستند. اما برخی کاراکترها:

• Forward Slash /
• Backslash \
• Colon :
• Asterisk *
• Question Mark ?
• Greater Than < Less Than >
• Vertical Bar |
• Double Quotation Marks "

را در نامگذاری نمی توانید بنویسید.

نام های غیر مجاز در ویندوز

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

CON، PRN، AUX، NUL، COM1، COM2، COM3، COM4، COM5، COM6، COM7، COM8، COM9، LPT1، LPT2

LPT3، LPT4، LPT5، LPT6، LPT7، LPT8، LPT9 و …

پیوستگی معنایی در نامگذاری

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

نکاتی در نامگذاری فایل ها در ویندوز

• تاریخ ها را در نام فایل ها قرار دهید تا آن ها را توصیفی کنید.
• می توانید از تاریخ در نام فایل ها در ویندوز استفاده کنید. برخی از رایج ترین روش های نوشتن تاریخ در قالب های YYYY-MM-DD، YYYYMMDD، YYMMDD و YYMM هستند. با این حال، نمی توانید از YYYY/MM/DD استفاده کنید زیرا کاراکتر اسلش رو به جلو در نام فایل پشتیبانی نمی شود.
• اسم ها تا حد امکان کوتاه و با معنی باشد
• از تکرار بی مورد در نام فایل ها پرهیز کنید. اگر در نام فایل مجبور هستید از عدد استفاده کنیم همیشه با صورت دو رقمی بنویسید. برای مثال برای نوشته نسخه فایل به جای نوشتن V1 به صورت V01 بنویسید.
• اگر در نام فایل مجبور هستید از تاریخ استفاده کنید سعی کنید به صورت عددی آن را قرار دهید. 20200224Request.docx
• سعی کنید تصمیم بگیرید همیشه سال اول باشد یا روز تا در sort کردن راحت تر باشید.
• اگر نام شخصی را باید در فایل ذکر کنید حتماً از فامیلی و نام آن استفاده کنید و از کلماتی مثل Mr, Ms, Mrs استفاده نکنید.
• از کلمات مثل Draft, Final در ابتدای نام استفاده نکنید.

قواعد نامگذاری در برنامه نویسی

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

نام گذاری PascalCase پاسکال

در روش نامگذاری پاسکال Pascal در این شیوه نام گذاری حرف اول همه کلمات با حروف بزرگ نوشته می شود و بین هر کلمه از هیج کاراکتری (space ، - ، _ و ...) استفاده نمی شود. کاربرد در نامگذاری کلاس ها و property ها.

مانند: ClientTarget, UserStatus

نام گذاری camelCase شتر

درشیوه نام گذاری کمل Camel و شتر هر کلمه با حرف کوچک و سایر کلمات با حروف بزرگ نوشته می شود و بین هر کلمه از هیج کاراکتری (space ، - ، _ و ...) استفاده نمی شود. کاربرد در نامگذاری پارامترهای ارسالی به تابع، متغیر ها و کلیدها در json.

مانند: userId, deliveredAtTime

نام گذاری snake_case مار

در این شیوه نام گذاری snake یا مار هر کلمه با _ underline از کلمه قبلی جدا می شود. برای نامگذاری function, method, variable .

مانند: user_id, received_at

نام گذاری kebab-case

در این روش نام گذاری هر کلمه با - dash از کلمه قبلی جدا می شود. اسامی دیگه این سبک lisp-case, spinal-case, Train-Case. این نامگذاری تقریبا منسوخ شده است و برای query string در url مورد استفاده قرار می گیرد. سایر کاربرد های آن با نامگذاری snake case انجام می شود.

مانند: lazy-load, fox-name

در آخر باید به این نکته اشاره کنم که برای یک برنامه نویس، نظم و طبق یک اصول کار کردن بسیار مهم است. چرا که کد ها باید پیوسته و قابل رصد باشند. ممکن است در آینده به آن برگردید، باید روالی باشد که بتوانید آن را پیش بینی کنید.

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

تفاوت و حرفه ای بودن در همین جزییات مهم است.