5 Tips for Writing Readable Code
Whether you are an absolute beginner just learning the basics of coding or a seasoned veteran working in huge, legacy codebases, you need to write readable code.
Consider each of the following as you practice naming classes, variables and methods:
To improve the readability, you could break out some of the logic into variables:
This code is more self-documenting and easier to follow. If you're fixing a bug or changing functionality, you only need to pay attention to one line.
1. Consistently format your code
"Code Formatting" means organizing your code, line breaks and spacing in a consistent and meaningful way.
Formatting is extremely important because it makes code more readable to humans. And humans are the ones reading & writing code. You are one of those humans and taking the time to format your code properly will start saving you headaches immediately.
I have often noticed that the new programmers who neglect to format their code are the most likely to get stuck and encounter bugs they don't understand. When code is indented inconsistently, logic bugs are easy to miss.
I strongly recommend using an automatic formatter for your code. Most development environments already know how to format code and everyone should memorize that hotkey by heart.
Try it now: Configure your environment to "Format on save". Most IDEs can be configured to automatically format your code when you save a file. This is a great way to always keep your formatting consistent and spot errors sooner.
2. Make naming your first priority
If you give things great names, you will find that your code is much easier to work with. Naming is probably the most important and the most challenging skill in all of software development. A good name can capture deep meaning and a bad name can mislead readers.
Consider each of the following as you practice naming classes, variables and methods:
- One name per concept, one concept per name
Each term you use should have a single, unique meaning. Avoid cases where important names are accidentally shared by different concepts. This makes it much easier to know at a glance what something represents and makes it easier to find with "Find All"/grep - Be consistent in your naming schemes
There are many common naming principles and different codebases have adopted different best practices. Always understand the best practices in your current codebase and be ruthlessly consistent. - Verb methods
Always start your method names with a single verb. A method does something. "add numbers", "fetch data", "sort list", etc. This is a well-established pattern and one you should always follow - If you can't think of a concise, meaningful name, refactor
If you need to name a method or variable but it does too many things to capture in a meaningful way, that's a big sign you need to refactor your code. This often happens when one method is doing too many different things. Think about how you can split a complex method up into smaller, well-named methods.
As you write more code and read more code, you'll start to notice good names and bad names. Pay attention and learn as you go. These concepts will help you become better at naming only through consistent practice and reading.
3. Keep similar things together
The closer together you keep related code, the easier it will be to follow. When you are writing functionality, think about how to split it up in a way that keeps the most-related parts close to each other in the code base. Think about how each part of the code will be used.
Don't be afraid to refactor your code as you go. If you find that your current structure isn't ideal, you should be able to move your code around. Refactoring your code is a big part of a software engineer's job and often one of the most rewarding.
4. Comment, but don't overdo it
Comments are useful ways to explain why your code does what it does. Comments are also very useful as "Documentation" for methods & parameters. But you really don't need to comments to explain what each line of code does.
If your preferred language has a standard format for documenting classes and methods, learn it! Most IDEs will show doc-comments in their code-help tooltips
See this JavaScript example using JSDoc comments in VSCode:![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABBsAAAF8CAYAAACOi7OBAAAgAElEQVR4Aey93W8UR77///tLWuMYYzwZY2xjHD9gvDbGDxgbxg+B9Ql2joH462RZTpYsiJAcFohlngIEWGMWpDxIYY9QTnIWbZRVNkiR2F0F7UpIkSxtlJtc5o673OX9U3VXdVd3V/d0j8dP8L6wZjzTU/2pT72quj7vrvr0/2dZFvhHH5ABMkAGyAAZIANkgAyQATJABsgAGSADpWLg/ytVQSyHUJIBMkAGyAAZIANkgAyQATJABsgAGSADggGKDVzZwZUtZIAMkAEyQAbIABkgA2SADJABMkAGSsoAxQYCVVKgqGJSxSQDZIAMkAEyQAbIABkgA2SADJABig0UGyg2kAEyQAbIABkgA2SADJABMkAGyAAZKCkDFBsIVEmBooJJBZMMkAEyQAbIABkgA2SADJABMkAGKDZQbKDYQAbIABkgA2SADJABMkAGyAAZIANkoKQMUGwgUCUFigomFUwyQAbIABkgA2SADJABMkAGyAAZoNhAsYFiAxkgA2SADJABMkAGyAAZIANkgAyQgZIyQLGBQJUUKCqYVDDJABkgA2SADJABMkAGyAAZIANkgGIDxQaKDWSADJABMkAGyAAZIANkgAyQATJABkrKAMUGAlVSoKhgUsEkA2SADJABMkAGyAAZIANkgAyQAYoNFBsoNpABMkAGyAAZIANkgAyQATJABsgAGSgpAxQbCFRJgaKCSQWTDJABMkAGyAAZIANkgAyQATJABig2UGyg2EAGyAAZIANkgAyQATJABsgAGSADZKCkDFBsIFAlBYoKJhVMMkAGyAAZIANkgAyQATJABsgAGaDYQLGBYgMZIANkgAyQATJABsgAGSADZIAMkIGSMkCxgUCVFCgqmFQwyQAZIANkgAyQATJABsgAGSADZIBiA8UGig1kgAyQATJABsgAGSADZIAMkAEyQAZKygDFBgJVUqCoYFLBJANkgAyQATJABsgAGSADZIAMkAGKDRQbKDaQATJABsgAGSADZIAMkAEyQAbIABkoKQMUGwhUSYGigkkFkwyQATJABsgAGSADZIAMkAEyQAYoNlBsoNhABsgAGSADZIAMkAEyQAbIABkgA2SgpAxQbCBQJQWKCiYVTDJABsgAGSADZIAMkAEyQAbIABmg2ECxgWIDGSAD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)
See this JavaScript example using JSDoc comments in VSCode:
As I type, VSCode will show me basic comments about my method and it's parameters (that I added). This is very useful when you're working in large code bases because you don't have to remember all the context.
Try it now: Look up how to write doc comments in your preferred language and try using them on your next project.
5. Don't try to be clever
The most readable code is frequently the simplest code. On the other hand, the most bug-prone, hard-to-read code is usually very complex.
Aim to make each line simple. Try to avoid nested if-statements and loops. Don't worry about optimizing for performance (until you actually encounter a performance problem).
There is a common principle in programming called "Don't repeat yourself" (DRY). The idea is that if you're writing the same code many times, it should be extracted into a common function. This is generally good practice, but don't go overboard. Some engineers are too eager to try to minimize repetition so much they write complex code. Aim to remove most repetition but always weigh the complexity of your approach before committing.
Along these lines, it can be very helpful to break up long statements into a series of smaller statements. Don't be afraid to define new, well-named variables to hold intermediate values. Having better linear flow can make debugging easier too.
Example: A long if statement (these are very common):
return typeof input === "string"
&& matchesFirstName(input) && matchesLastName(input)
&& address !== null && isNearby(address, LOCATION);
To improve the readability, you could break out some of the logic into variables:
Rewrite:
const doesNameMatch = typeof input === "string" && matchesFirstName(input) && matchesLastName(input);
const isAddressNearby = address !== null && isNearby(address, LOCATION);
return doesNameMatch && isAddressNearby;
This code is more self-documenting and easier to follow. If you're fixing a bug or changing functionality, you only need to pay attention to one line.
In Conclusion
Programs should first and foremost prioritize human readability. This article shared five key ways to write more readable code.
Programming is an art as well as a science. You will learn to write better code through extensive practice and reading other's code too. Supplement your practice with regular learning through blogs like this, find a mentor or get code reviews from someone you respect.
Comments
Post a Comment