Avoid Common Python Pitfalls: Better Loops, List Comprehensions, and Performance Tips

Iteration

Python beginners often misuse range for simple iteration, assuming it is the natural way to loop over a sequence. This leads to off‑by‑one errors because range includes the start value but excludes the stop value, similar to Java's substring. Use direct iteration over the sequence or enumerate when an index is needed.

Common reasons for using range and better alternatives:

Need an index – replace with enumerate.

Iterating two sequences together – use zip.

Iterating a slice – iterate the slice directly and add a comment explaining the intent.

When dealing with very large sequences, slicing can be costly; consider using xrange (Python 2) or generator expressions for memory‑efficient iteration.

Proper Use of List Comprehensions

Instead of a multi‑line loop, rewrite simple transformations with a list comprehension for cleaner, more Pythonic code.

Advantages:

Avoids errors in list initialization.

Produces concise, readable code.

When a comprehension needs nested loops or conditional logic, embed them directly:

Remember that the order of loops in a multi‑loop comprehension mirrors the order of nested for statements.

Performance Pitfalls

Checking membership in a list is O(n); using a set or dict provides O(1) average‑case look‑ups. Build the set or dict once before the loop to amortize the creation cost.

Creating a set incurs linear time, but the constant‑time membership checks usually outweigh this cost when the set is reused many times.

Variable Scope and Leakage

Python’s variable scope is broader than many other languages. A variable defined inside a loop remains accessible after the loop ends, which can cause unexpected NameError if the loop never executes.

Use a sentinel value (commonly None) before the loop to detect the “no‑iteration” case, or initialize the variable with a distinct placeholder.

Global variables should be avoided unless truly necessary; when reading a global you do not need the global keyword, only when assigning to it.

Code Style – PEP 8

Follow the PEP 8 style guide for consistent formatting. Test containers for emptiness with a simple truthy check instead of len(x) > 0. Use bool(x) to store the result if needed.

Check for None explicitly when you need to distinguish it from other falsy values:

These patterns help write Python code that is readable, efficient, and less error‑prone.