Lesson 3: The Aesthetics of Structure
The visual layout of your code is the first impression. Just like architecture, good code structure guides the eye and reduces visual stress. This is pure Code Aesthetics.
Indentation: The Visual Hierarchy
Indentation defines blocks of execution. Inconsistency here is a major vibe killer.
- Tabs vs. Spaces: While the debate rages, consistency is the only Vibe rule. Most modern teams agree on 4 spaces (or 2 spaces in languages like JavaScript/CSS). Pick one and stick to it.
Misaligned Blocks
When indentation is wrong, the structure appears broken, even if the compiler accepts it.
python
Bad Vibe
def calculate_total(items): total = 0 for item in items: total += item.price return total # Error prone due to misalignment
Strategic Use of Whitespace (Vertical and Horizontal)
Whitespace acts like punctuation in code, separating logical ideas.
- Vertical Whitespace: Use blank lines to separate logical chunks of code within a function. This is critical for breaking up a long function into 'paragraphs'.
javascript // Good Vibe: Separation of concerns within the function function authenticateUser(credentials) { // 1. Validate input structure if (!credentials || !credentials.username) { throw new Error('Invalid input'); }
// 2. Fetch user from database
const user = DB.findUser(credentials.username);
if (!user) {
return false;
}
// 3. Compare passwords and return result
return passwordService.verify(credentials.password, user.hash);
}
- Horizontal Whitespace: Use single spaces around operators (
=,+,==) and after commas. Avoid unnecessary spaces inside parenthesis or brackets.
- Bad Vibe:
x=(y+z)*3; - Good Vibe:
x = (y + z) * 3;
Line Length Limits
Restrict line length (commonly 80 or 120 characters). Long lines force horizontal scrolling, breaking concentration and destroying the reading flow.