lombok-intellij-plugin

Plugin for IntelliJ IDEA to support Lombok annotations.

Provides support for lombok annotations to write great Java code with IntelliJ IDEA.

Last version (0.31) released on 06.09.2020

---

💥 Unfortunately the current IntelliJ 2020.2 version has a bug and lombok plugin can't be used normally. 💥

🛠️ Use previous IntelliJ version 2020.1 or update to IntelliJ IDEA 2020.2.1

💥 The latest IntelliJ IDEA versions still contains a BUG 🪲 for several plugins (including plugin for Lombok) were shown as incompatible with the updated version of the IDE. 💥

You can find the issue with a detailed explanation here: https://youtrack.jetbrains.com/issue/IDEA-237113 and https://youtrack.jetbrains.com/issue/IDEA-246822

🛠️ As of now, the workaround is to re-install the plugin in the IDE settings.

35th version of plugin released.

Install it automatically from IntelliJ Idea plugin repository.

Tested and supports IntelliJ versions: 2017.X, 2018.X, 2019.X, 2020.1 and 2020.2.1

Last support for IntelliJ 2016.2 and 2016.3 by plugin version 0.31!

Last support for IntelliJ 15.0.6 and 2016.1 by plugin version 0.19!

Last support for IntelliJ 14.1.7 by plugin version 0.14!

Last support for IntelliJ 11.1.5, 12.1.7, 13.1.6 by plugin version 0.11

Last support for IntelliJ 10.5.4 by plugin version 0.8.7

With this plugin your IntelliJ can recognize all of generated getters, setters and some other things from lombok project, so that you get code completion and are able to work without errors stating the methods don't exists.

Features / Supports

• @Getter and @Setter
• @ToString
• @EqualsAndHashCode
• @AllArgsConstructor, @RequiredArgsConstructor and @NoArgsConstructor
• @Log, @Log4j, @Log4j2, @Slf4j, @XSlf4j, @CommonsLog, @JBossLog, @Flogger, @CustomLog
• @Data
• @Builder
• @Singular
• @Delegate
• @Value
• @Accessors
• @With
• @SneakyThrows
• @val available from IntelliJ 14.1 (improved in 2016.2)
• @UtilityClass available from IntelliJ 2016.2
• lombok config files syntax highlighting
• code inspections
• refactoring actions (lombok and delombok)
• project configuration inspection (missing/out-of-date Lombok dependency, annotation processing disabled)

Many features of the plugin (including warnings) could be disabled through per-project settings.

Installation

Plugin Installation

• Using IDE built-in plugin system on Windows:
  • File > Settings > Plugins > Browse repositories... > Search for "lombok" > Install Plugin
• Using IDE built-in plugin system on MacOs:
  • Preferences > Settings > Plugins > Browse repositories... > Search for "lombok" > Install Plugin
• Manually:
  • Download the latest release and install it manually using Preferences > Plugins > Install plugin from disk...

Restart IDE.

Required IntelliJ Configuration

In your project: Click Preferences -> Build, Execution, Deployment -> Compiler, Annotation Processors. Click Enable Annotation Processing

Afterwards you might need to do a complete rebuild of your project via Build -> Rebuild Project.

Lombok project dependency

Make sure you have Lombok dependency added to your project. This plugin does not automatically add it for you.

Please Note: Using newest version of the Lombok dependency is recommended, but does not guarantee that all the features introduced will be available. See Lombok changelog for more details.

If you are using Gradle/Maven/Ivy, see example below:

Gradle

In your build.gradle:

repositories {
	mavenCentral()
}

dependencies {
	compileOnly 'org.projectlombok:lombok:1.18.12'
	annotationProcessor 'org.projectlombok:lombok:1.18.12'

	testCompileOnly 'org.projectlombok:lombok:1.18.12'
	testAnnotationProcessor 'org.projectlombok:lombok:1.18.12'
}

Maven

In your pom.xml:

<dependencies>
	<dependency>
		<groupId>org.projectlombok</groupId>
		<artifactId>lombok</artifactId>
		<version>1.18.12</version>
		<scope>provided</scope>
	</dependency>
</dependencies>

Ivy

In your ivy.xml:

<dependency org="org.projectlombok" name="lombok" rev="1.18.12" conf="build" />

IntelliJ and Eclipse compiler

If you're using Eclipse compiler with lombok, try this setup:

• install plugin
• make sure Lombok dependency is added to the project
• change compiler setting:
  • ... > Compiler > Java Compiler > Use Compiler: Eclipse
  • ... > Compiler > Annotation Processors > Enable annotation processing: checked (default configuration)
  • ... > Compiler > Additional build process VM options: -javaagent:lombok.jar

Developed By

@mplushnikov Michail Plushnikov

Contributors

• @adamarmistead adamarmistead
• @akozlova Anna Kozlova
• @alanachtenberg Alan Achtenberg
• @AlexejK Alexej Kubarev
• @bulgakovalexander Alexander Bulgakov
• @GingerGeek Zed Spencer-Milnes
• @jeromewaibel Jérôme Waibel
• @Jessevanbekkum Jesse van Bekkum
• @juriad Adam Juraszek
• @kuil09 Hwang, Geon Gu
• @krzyk Krzysztof Krasoń
• @Lekanich Aleksandr Zhelezniak
• @mg6maciej Maciej Górski
• @mlueders Mike Lueders
• @RohanTalip Rohan Talip
• @ruurd Ruurd Pels
• @Sheigutn Florian Böhm
• @siosio siosio
• @Siriah Iris Hupkens
• @tlinkowski Tomasz Linkowski
• @toadzky David Harris
• @twillouer William Delanoue
• @uvpoblotzki Ulrich von Poblotzki
• @vanam Martin Váňa
• @yiftizur Yiftach Tzur
• @sluongng Son Luong Ngoc
• @tagae Sebastián González
• @wyhasany Michał Rowicki
• @ocadaruma Haruki Okada
• @mackatozis Alexandros Efthymiadis

Supporters

YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

License

Copyright (c) 2011-2020 Michail Plushnikov. See the LICENSE file for license rights and limitations (BSD).