IntelliJ IDEA Tips & Tricks

Turbocharge Lombok annotations with IntelliJ IDEA

If you’re a professional Java developer, you probably use IntelliJ IDEA as your IDE and Lombok as the framework that handles the Java boilerplate. What you probably didn’t know is that not only do these 2 technologies work well on their own, but when combined, they’re even more efficient than when used individually

IntelliJ IDEA Ultimate comes bundled with the Lombok plugin which makes Lombok even more useful and convenient. In fact, it’s so highly valued that in the past, when the plugin was not bundled, many users would not upgrade until the plugin was compatible with the newer version of IntelliJ IDEA.

Today, let’s explore Lombok support in IntelliJ IDEA and see how they make a project cleaner, less verbose, easier to maintain, and more pleasant to work with.

Getting started

Let’s start by cloning the canonical spring-petclinic project.

Then, make sure that the Lombok plugin is enabled:

Lombok on the Plugins setting page

Now, let’s add Lombok to the project dependencies. We can do that either through the build script, or we can just start using Lombok annotations, and IntelliJ IDEA will suggest adding the missing dependency.

Quick-fix to add the missing Lombok dependency

Basic features

Now that we’ve made sure that the plugin is enabled and the dependency is on the classpath, let’s look at the features.

There are plenty of trivial accessor methods in our project, so let’s start by replacing them. Whenever IntelliJ IDEA recognizes that a member can be replaced with a Lombok annotation, it suggests a quick-fix:

Quick-fix suggesting replacing trivial accessor method

The same works for ubiquitous loggers, trivial equals() and hashCode() implementations, constructors, and more.

Setter code generated with the quick-fix

Because IntelliJ IDEA knows the corresponding bytecode will be generated at compilation, the Lombok code is not red. All the essential features, like navigation and rename refactoring, also work well with such code.

For example, we can search for the usages of a backing field whose accessor methods were replaced with Lombok annotations. Accessor calls are found just as if the boilerplate was in place:

Find Usages provides relevant results even though the code is physically missing.></p>
<p>All this also works well with advanced annotations, such as Builder, SuperBuilder, and Accessors with prefixes.</p>
<p><img decoding=

Static warnings

If there’s a conflict between the annotations, or another Lombok-related problem, IntelliJ IDEA will detect the issue right away. This is handy because otherwise such an error would not be visible until compile-time, which increases the feedback loop and consequently wastes your time.

Warning about setter generation shown in the editor

These checks are implemented in the form of a dedicated inspection set, which you can adjust according to your preferences:

Lombok inspection settings

Lombok configuration files

If your project uses the Lombok Configuration System to customize Lombok features and behavior, then IntelliJ IDEA will help you configure this as well:

Code completion in Lombok configuration files

You can use basic code intelligence features, such as code completion within lombok.config files.

Automatic conversion to Lombok and back

Are you new to Lombok? Do you want to quickly evaluate how your project will look with Lombok annotations? It’s easy with the Lombok action, which you can invoke for an entire class.

Lombok action in Find Action dialog

IntelliJ IDEA will then suggest which annotations are available for this class:

A popup with annotation suggestions

On the other hand, if you want to remove Lombok annotations from your project, this is also possible through the Delombok action. This saves you time and averts potential human error when removing the annotations and trying to preserve the semantics of the original code.

Delombok action in Find Action dialog


We hope that this post helped you learn more about Lombok support in IntelliJ IDEA. As we’ve just seen, Lombok can make your project cleaner, less verbose, and easier to maintain, while IntelliJ IDEA adds the essential features like refactoring, navigation, and static analysis.

As always, we’d love to hear your feedback. You can leave a comment below or use our issue tracker for feature requests.

Happy developing!