Naming Variables

Process of choosing names for the containers in your code that store values.

Details

Although it might seem simple, picking good variable names is often an underestimated aspects of programming. Clear and meaningful names make your code easier to read, understand, and maintain, while poor names can cause confusion and errors.

---

Naming is difficult because a variable’s name must describe what it stores while staying short and valid. In larger programs, vague names make it hard to trace data or understand a program’s purpose. Good names make code easier to read, debug, and share.

# Hard to understand
x = 120

# Clear and descriptive
playerScore = 120

---

Most programming languages follow similar basic rules for valid variable names:

• Use letters, numbers, and underscores only – Avoid special characters like #, $, or spaces.
• Start with a letter or underscore – Names can’t begin with a number.
• Case sensitivity – score and Score are treated as different variables.
• Avoid reserved keywords – Words like int, if, or for are part of the language and can’t be used.

# Valid
player_score = 100
user_name = "Alex"

# Invalid
2score = 100      # starts with a number
int = 50          # uses a reserved keyword

---

Beyond syntax rules, a good variable name requires thoughtful choice. Keep these best practices in mind:

• Be descriptive but concise – playerScore is clearer than x or temp.
• Avoid misleading names – The name should match the data’s meaning.
• Avoid abbreviations – Prefer user or value over usr or val.
• Reflect the type of data – Use isAlive for a boolean or scoreList for a collection.
• Use a consistent naming style – Follow your language’s naming convention and stick with a naming style across your project.
• Use singular or plural consistently – scores for multiple values, score for one.

isAlive = true;         // clear boolean
playerScore = 50;       // descriptive and concise
scores = [10, 20, 30];  // plural for multiple values

// Not recommended
val = 50;       // unclear
tempData = 50;  // vague

Related Concepts

• Uses: Variable

Related Actions

• Is mentioned: Declare a Variable