Writing code that works is one thing. Writing code that is clean, readable, and easy to maintain is what separates junior developers from seniors.
When I first started writing code, I focused only on getting the logic right. But as projects grew, maintaining that "spaghetti code" became a nightmare. Over time, I adopted a few habits that completely transformed the way I write software.
Here are 5 essential clean code habits you should start practicing today.
1. Name Things with Clear Intent
Stop using single-letter variables like x, temp, or vague names like data1. Your variable and function names should clearly explain why it exists and what it does.
Bad:
JavaScript
const d = new Date();
const el = getUsr(123);
Good:
JavaScript
const currentDate = new Date();
const userAccount = getUserById(123);
2. Keep Functions Small and Single-Purpose
A function should do one thing, and do it well (Single Responsibility Principle). If your function is over 20-30 lines long, it's probably doing too much.
Tip: If you need to use comments like // Step 1: Validate input and // Step 2: Save to DB inside a function, break those steps into separate helper functions instead!
3. Don't Repeat Yourself (DRY)
Duplicating code is one of the biggest sources of bugs. If you find yourself copying and pasting the same block of logic in two different places, refactor it into a reusable function or component.
4. Write Meaningful Comments (Or Better: Self-Documenting Code)
Comments shouldn't explain what the code does (the code itself should be readable enough to show that). Use comments to explain why you made a specific non-obvious decision or workaround.
Bad: // Increments i by 1
Good: // Workaround for API rate-limiting issue in version 2.1
5. Format Consistently with Linter & Prettier
Don't waste time manually formatting your code. Set up automated tools like ESLint and Prettier in your code editor to enforce standard formatting across your project. Clean code should look consistent regardless of who wrote it.
🎯 Conclusion
Writing clean code is a discipline that takes practice. You don't have to overhaul your entire coding style overnight—start by applying just one or two of these habits in your next project!
💡 What's your #1 rule when it comes to writing clean code? Let me know in the comments below!
If you found this helpful, feel free to follow me for more practical web development and tech insights!
Top comments (0)