UnboundLocalError in Python: Causes and Fixes with Simple Examples

 What is UnboundLocalError in Python?

An UnboundLocalError in Python occurs when you try to use a local variable before assigning a value to it inside a function.

In simple words, Python is saying:

“You are using a variable before giving it a value.”

This error usually happens due to variable scope confusion, especially when working inside functions.

---

Understanding Variable Scope in Python

Python has two main variable scopes:

• Local scope — variables defined inside a function

• Global scope — variables defined outside a function

If Python detects a variable is being assigned inside a function, it treats it as local, even if a global variable with the same name exists.

---

Common UnboundLocalError Message

UnboundLocalError: local variable 'x' referenced before assignment

---

Example 1: Using a Variable Before Assignment

❌ Incorrect Code

def show_number():
    print(number)
    number = 10

show_number()

❌ Error

UnboundLocalError: local variable 'number' referenced before assignment

✔ Why this happens

Python thinks number is local because it is assigned inside the function, but it is used before assignment.

---

Example 2: Global vs Local Variable Conflict

❌ Incorrect Code

count = 5

def update_count():
    count = count + 1

update_count()

❌ Error

UnboundLocalError: local variable 'count' referenced before assignment

✔ Why this happens

Python treats count as a local variable inside the function.

---

✔ Correct Code Using global Keyword

count = 5

def update_count():
    global count
    count = count + 1

update_count()
print(count)

---

Example 3: Fix by Initializing the Variable

❌ Incorrect Code

def calculate():
    total += 5
    print(total)

✔ Correct Code

def calculate():
    total = 0
    total += 5
    print(total)

---

Example 4: Fix by Passing Variable as Parameter

✔ Correct Code

def add_value(total):
    total += 5
    return total

print(add_value(10))

---

How to Debug UnboundLocalError Easily

✔ Check if the variable is assigned before use
✔ Avoid naming conflicts between global and local variables
✔ Use global only when necessary
✔ Initialize variables inside functions
✔ Pass variables as function arguments

---

How to Avoid UnboundLocalError in Python

• Always initialize variables before using them

• Avoid modifying global variables inside functions

• Use different variable names for clarity

• Understand variable scope clearly

• Keep functions small and simple

---

Difference Between UnboundLocalError and NameError

Error	Meaning
NameError	Variable does not exist
UnboundLocalError	Variable exists but not assigned locally

---

Summary

UnboundLocalError happens when Python finds a local variable that is used before being assigned a value.

Understanding variable scope is the key to fixing and avoiding this error.

This error is common for beginners — mastering it will improve your Python coding skills.

---

❓ Frequently Asked Questions (FAQ)

Q1: Is UnboundLocalError the same as NameError?

No. It happens due to local variable scope issues.

Q2: Can I fix it without using global?

Yes. You can pass variables as function parameters.

Q3: Is UnboundLocalError common?

Yes, especially when learning functions.

---

📌 Final Tip

Always assign variables before using them inside functions.