Menu
Coddy logo textTech
flag Ar iconالعربيةdown icon

قواعد التسمية

جزء من قسم Fundamentals في رحلة Lua على Coddy — الدرس 10 من 90.

تجعل اتفاقيات التسمية الجيدة الكود الخاص بك أسهل في القراءة والفهم والصيانة.

في لغة Lua، يجب أن تتبع أسماء المتغيرات قواعد معينة. يمكن أن تحتوي على أحرف وأرقام وشرطات سفلية، ولكن يجب أن تبدأ بحرف أو شرطة سفلية. أسماء مثل playerScore و health_points و _tempValue كلها صالحة، بينما 2players أو my-score ليست كذلك.

عند تسمية المتغيرات، اختر أسماءً وصفية توضح بوضوح ما يخزنه المتغير. بدلاً من استخدام أسماء غامضة مثل x أو data، استخدم أسماءً محددة مثل playerLevel أو gameScore. هذا يجعل الكود الخاص بك يوثق نفسه بنفسه ويسهل فهمه بشكل كبير لاحقاً.

بالنسبة لأسماء المتغيرات المكونة من عدة كلمات، يستخدم مبرمجو Lua عادةً إما camelCase (مثل playerHealth) أو الشرطات السفلية (مثل player_health). كلا الأسلوبين مقبولان - والمفتاح هو أن تكون متسقاً في جميع أنحاء التعليمات البرمجية الخاصة بك. اختر أسلوباً واحداً والتزم به في مشاريعك.

ورقة مرجعية

يجب أن تبدأ أسماء المتغيرات في Lua بحرف أو شرطة سفلية ويمكن أن تحتوي على حروف وأرقام وشرطات سفلية:

playerScore = 100     -- صالح
health_points = 50    -- صالح
_tempValue = 10       -- صالح
-- 2players = 5       -- غير صالح (يبدأ برقم)
-- my-score = 20      -- غير صالح (يحتوي على وصلة)

استخدم أسماء وصفية توضح بوضوح ما يخزنه المتغير:

-- تسمية جيدة
playerLevel = 5
gameScore = 1500

-- تسمية سيئة
x = 5
data = 1500

بالنسبة للمتغيرات المكونة من عدة كلمات، استخدم إما camelCase أو الشرطات السفلية بشكل متسق:

-- أسلوب camelCase
playerHealth = 100
maxSpeed = 50

-- أسلوب الشرطة السفلية (underscore)
player_health = 100
max_speed = 50

جرّب بنفسك

لا يتضمّن هذا الدرس تحدّيًا برمجيًا.

quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس Fundamentals