1. 問(wèn)題現(xiàn)象與根因定位1.1 典型癥狀我先說(shuō)說(shuō)最典型的畫面從 Spring Initializr 新建一個(gè) Spring Boot 項(xiàng)目開(kāi)發(fā)工具里勾選或者手動(dòng)在 pom.xml 里寫入了 Lombok 依賴然后信心滿滿地給實(shí)體類加上Data緊接著去寫user.getName()這種 getter 調(diào)用結(jié)果 IDE 直接在方法名上畫紅線說(shuō)找不到方法。點(diǎn)編譯控制臺(tái)報(bào)一堆java: cannot find symbol符號(hào)位置就在那些本該由 Lombok 生成的 getter/setter 上。但更詭異的是Slf4j注入的log對(duì)象卻能正常使用Data的toString()好像也能用其實(shí)這種情況往往是 IDE 層面的 Lombok 支持沒(méi)生效或者編譯時(shí)注解處理器沒(méi)跑起來(lái)。還有一小部分情況是依賴沖突或者 JDK 版本太新導(dǎo)致 Lombok 處理器被編譯器直接忽略。1.2 為什么會(huì)自動(dòng)創(chuàng)建卻無(wú)效很多人的第一反應(yīng)是我是不是漏了依賴然后反復(fù)檢查 pom.xml甚至把依賴刪了重新加。但這里的關(guān)鍵在于IDEA 里新建 Spring Boot 項(xiàng)目時(shí)即使你在依賴列表里勾選了 Lombok那也只是往 pom.xml 里寫了依賴坐標(biāo)。Lombok 不是一個(gè)普通的庫(kù)它屬于“注解處理器”需要在編譯階段介入把注解變成真實(shí)的 Java 代碼。這個(gè)過(guò)程有兩個(gè)岔路如果使用 Maven 命令行編譯那么依賴?yán)锉仨毎⒔馓幚砥鞫?Lombok 在 Maven 編譯時(shí)默認(rèn)就能通過(guò)provided作用域生效這個(gè)沒(méi)問(wèn)題。如果使用 IDEA 的編譯功能也就是直接點(diǎn)綠色錘子那么 IDEA 自身的編譯器需要能識(shí)別 Lombok 注解。這就依賴兩個(gè)東西一是 IDEA 里安裝了 Lombok 插件新版 IDEA 內(nèi)置了但可能沒(méi)啟用二是 IDEA 的 Annotation Processing注解處理開(kāi)關(guān)要打開(kāi)。這兩個(gè)條件缺一個(gè)就會(huì)出現(xiàn)依賴在 pom 里躺得好好的但代碼就是編譯不過(guò)的局面。你可以理解成Lombok 是一個(gè)需要“翻譯官”的庫(kù)Maven 自己帶了翻譯官但 IDEA 的編譯流程必須要額外配置才能請(qǐng)到這位翻譯官。1.3 必須先明白的檢查順序網(wǎng)上很多教程一上來(lái)就讓重裝插件但其實(shí)步驟是有先后邏輯的。我推薦的排查順序是先看插件是否存在且啟用再看 annotation processing 開(kāi)關(guān)然后才去折騰依賴和 JDK 兼容性。因?yàn)椴寮烷_(kāi)關(guān)是 IDEA 層面的依賴是項(xiàng)目層面的按這個(gè)順序能快速定位問(wèn)題不會(huì)盲目浪費(fèi)時(shí)間。2. 從零到一的完整解決路徑2.1 檢查并啟用 IDEA 的 Lombok 插件首先打開(kāi) IDEA 設(shè)置界面File - SettingsWindows或IntelliJ IDEA - PreferencesmacOS然后進(jìn)入Plugins搜索框輸入 “Lombok”。如果你用的是 2020.1 及以后的 IDEA 版本Lombok 插件其實(shí)是和 IDE 捆綁在一起的但默認(rèn)可能沒(méi)有勾選啟用。你要在已安裝插件列表里找到Lombok確認(rèn)它的勾選框是否打勾。如果沒(méi)有勾選上然后重啟 IDEA。如果你用的是社區(qū)版Community Edition同樣可以裝這個(gè)插件。但要注意社區(qū)版對(duì) Spring Boot 項(xiàng)目支持本來(lái)就受限制不過(guò) Lombok 插件本身是完全可用的。如果你聯(lián)網(wǎng)困難可以參照后面的離線安裝方法。提示部分新版本 IDEA 已經(jīng)將 Lombok 插件標(biāo)記為“Bundled捆綁”不需要手動(dòng)從插件市場(chǎng)安裝。但不要把“已安裝”誤認(rèn)為“已啟用”這是兩回事。2.2 啟用 Annotation Processing注解處理這是最容易忽略的一步。IDEA 默認(rèn)不會(huì)主動(dòng)運(yùn)行 Lombok 這類注解處理器除非你手動(dòng)開(kāi)啟。路徑是File - Settings - Build, Execution, Deployment - Compiler - Annotation Processors這里有很關(guān)鍵的一個(gè)復(fù)選框Enable annotation processing。默認(rèn)是不勾選的。勾選后你可以順手把下面的Obtain processors from project classpath也勾上。這個(gè)選項(xiàng)表示從項(xiàng)目的依賴路徑中自動(dòng)獲取注解處理器換句話說(shuō)就是讓 IDEA 去 classpath 里找 Lombok 的處理器類。如果你不勾有的項(xiàng)目配置下 IDEA 可能不會(huì)自動(dòng)識(shí)別雖然大部分情況不影響但勾上更穩(wěn)妥。另外這里的配置分兩種級(jí)別Project 級(jí)別和 Module 級(jí)別。如果你只對(duì)某個(gè)模塊開(kāi)啟就在右側(cè)的模塊列表里單獨(dú)操作。我建議先直接在最頂層的 Project 設(shè)置里開(kāi)啟省得到時(shí)候每個(gè)模塊都要配一遍。完成設(shè)置后點(diǎn)擊Apply和OK然后最好重啟一下 IDEA。2.3 確認(rèn) pom.xml 依賴正確很多時(shí)候問(wèn)題出在依賴聲明不完整。Lombok 的正確依賴寫法如下dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency注意optional標(biāo)簽標(biāo)記為 true 意味著這個(gè)依賴不會(huì)傳遞到下游模塊這是標(biāo)準(zhǔn)寫法。如果你用的是 Spring Boot 的spring-boot-starter-parent作為父工程那么 Lombok 的版本號(hào)由父工程統(tǒng)一管理不需要手動(dòng)指定上面的寫法就夠了。但如果你沒(méi)有使用 Spring Boot 的父依賴或者版本管理混亂建議手動(dòng)指定版本號(hào)例如dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId version1.18.30/version scopeprovided/scope /dependency這里使用provided作用域表示編譯時(shí)和測(cè)試時(shí)需要但打成的 jar 包中不包含 Lombok 的類因?yàn)檫\(yùn)行期不需要它的代碼。如果誤用compile作用域雖然多數(shù)時(shí)候也能工作但可能造成包體變大或者在部署時(shí)有一些意想不到的類沖突。還有一種情況是 Lombok 版本太老。很多舊教程還在用1.16.x甚至1.14.x那些版本對(duì)新的 JDK比如 Java 17、Java 21支持得很差甚至完全無(wú)法工作。你需要在 pom.xml 中點(diǎn)中l(wèi)ombok依賴名看右側(cè) Maven 窗口顯示的依賴版本或者直接在本地倉(cāng)庫(kù)里檢查。老版本請(qǐng)直接升級(jí)到 1.18.20 以上。2.4 解決 JDK 與 Lombok 的兼容性問(wèn)題很多人在完成前面兩步后依然看到這樣一條編譯報(bào)錯(cuò)java: You arent using a compiler supported by lombok, so lombok will not work.這句話的字面意思就是當(dāng)前使用的編譯器或者 JDK 版本不在 Lombok 支持列表里。Lombok 是通過(guò)修改編譯器內(nèi)部行為來(lái)實(shí)現(xiàn)在編譯時(shí)生成方法的它極度依賴編譯器版本。如果你用的 JDK 是剛發(fā)布的新版本而 Lombok 還沒(méi)來(lái)得及適配就會(huì)觸發(fā)這個(gè)異常。解決辦法有幾種升級(jí) Lombok 到最新版本。Lombok 官方對(duì) JDK 的支持更新還算勤快比如 JDK 21 出來(lái)后需要 Lombok 1.18.30 及以上版本。如果項(xiàng)目對(duì) Lombok 版本有強(qiáng)約束例如公司統(tǒng)一規(guī)定那就把開(kāi)發(fā)環(huán)境的 JDK 切換到項(xiàng)目期望的版本比如 11 或 17。IDEA 里可以通過(guò)Project Structure - Project SDK和Project Structure - Modules - Language level調(diào)整。確認(rèn) IDEA 使用的編譯器是javac而不是 Eclipse。IDEA 默認(rèn)編譯方式是javac但如果你改成了 Eclipse 編譯器Lombok 的兼容性可能會(huì)有別的幺蛾子建議在Settings - Build, Execution, Deployment - Compiler - Java Compiler里選擇Javac。2.5 最后一步清理緩存并重啟這個(gè)動(dòng)作看起來(lái)像玄學(xué)但確實(shí)管用。IDEA 的緩存可能會(huì)導(dǎo)致插件、注解處理器狀態(tài)沒(méi)有被正確加載。操作路徑是File - Invalidate Caches...在彈出的窗口中選擇Invalidate and Restart。這會(huì)清理 IDEA 的本地索引和緩存同時(shí)自動(dòng)重啟。重啟后IDEA 會(huì)重新索引項(xiàng)目加載插件此時(shí)再嘗試編譯大多數(shù)問(wèn)題都會(huì)消失。如果清理后還不行那大概率是更底層的配置問(wèn)題比如 Maven 的settings.xml里鏡像或倉(cāng)庫(kù)配置有問(wèn)題導(dǎo)致 Lombok 依賴實(shí)際上沒(méi)有下載完整。這種時(shí)候建議檢查一下本地 Maven 倉(cāng)庫(kù)~/.m2/repository/org/projectlombok/lombok路徑下的 jar 文件是否存在并且大小正常。如果 jar 有問(wèn)題手動(dòng)把整個(gè)lombok文件夾刪掉然后重新刷新 Maven 依賴。3. 實(shí)操演示完整走一遍可復(fù)現(xiàn)的示例3.1 新建項(xiàng)目與基礎(chǔ)配置我用一個(gè)最簡(jiǎn)單的場(chǎng)景帶大家走通全流程。假設(shè)你已經(jīng)準(zhǔn)備好 IDEA并且打算新建一個(gè) Spring Boot 項(xiàng)目。打開(kāi) IDEA選擇New Project左側(cè)選Spring Initializr。填寫項(xiàng)目名稱、坐標(biāo)、包名。在Dependencies面板里搜索并勾選Spring Web和Lombok。點(diǎn)擊完成項(xiàng)目創(chuàng)建后先等右下角的 Maven 導(dǎo)入完成。然后打開(kāi)pom.xml確認(rèn) Lombok 依賴已經(jīng)存在。按照前面說(shuō)的步驟先檢查插件和 Annotation Processing 設(shè)置這里假設(shè)都已經(jīng)配置好。3.2 編寫實(shí)體類和使用 Lombok創(chuàng)建一個(gè)User類放在com.example.demo.entity包下package com.example.demo.entity; import lombok.Data; Data public class User { private Long id; private String name; private Integer age; }然后寫一個(gè)簡(jiǎn)單的測(cè)試接口在 Controller 里直接使用 Lombok 生成的方法package com.example.demo.controller; import com.example.demo.entity.User; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; RestController RequestMapping(/user) public class UserController { GetMapping(/test) public String testLombok() { User user new User(); user.setId(1L); user.setName(張三); user.setAge(18); return user.toString(); } }如果你用了Data那User類中不應(yīng)該手動(dòng)寫 getter/setter也不要手動(dòng)寫toString。只要 IDEA 編譯通過(guò)運(yùn)行后訪問(wèn)http://localhost:8080/user/test就能看到類似User(id1, name張三, age18)的輸出這就說(shuō)明 Lombok 生效了。3.3 通過(guò)編譯后的 class 文件二次確認(rèn)有一種最直觀的方式確認(rèn) Lombok 是否真的工作找到編譯輸出的target/classes目錄找到User.class文件在 IDEA 的Project視圖里展開(kāi)點(diǎn)擊這個(gè) class 文件IDEA 會(huì)自動(dòng)反編譯。你會(huì)看到源碼中并沒(méi)有寫出來(lái)的getId、setId、toString等方法并且它們都帶有一個(gè)Generated by Lombok標(biāo)記?？吹竭@個(gè)標(biāo)記說(shuō)明 Lombok 處理器確實(shí)執(zhí)行了。如果你看不到可能是 IDEA 的反編譯插件沒(méi)裝。這種情況下可以打開(kāi)View - Tool Windows - Maven在Lifecycle里雙擊compile讓 Maven 來(lái)編譯一次然后手動(dòng)用外部工具比如javap查看 class 文件javap -p target/classes/com/example/demo/entity/User.class如果輸出中出現(xiàn)了public java.lang.String getName()等結(jié)果同樣說(shuō)明 Lombok 在 Maven 環(huán)境下有效。但如果 IDEA 自己的運(yùn)行配置還是報(bào)找不到符號(hào)那就是 IDEA 編譯環(huán)境仍然有問(wèn)題回頭檢查第 2 節(jié)里面的設(shè)置。3.4 驗(yàn)證過(guò)程中的常見(jiàn)干擾我實(shí)操過(guò)幾次發(fā)現(xiàn)在運(yùn)行 Spring Boot 項(xiàng)目時(shí)如果只是代碼在編輯器里顯示紅色下劃線但項(xiàng)目編譯運(yùn)行都正常這是純提示層面的問(wèn)題往往是 IDEA 的編輯緩存和編譯結(jié)果不一致。可以先執(zhí)行一次Build - Rebuild Project如果構(gòu)建成功紅色波浪線可能還是會(huì)殘留一會(huì)這時(shí)不要急著改配置先等 IDEA 的索引刷新或者重啟一下窗口。還有就是多模塊項(xiàng)目的干擾。假設(shè)你的父工程和子模塊都用到了 Lombok但只在父工程里聲明了依賴子模塊沒(méi)有顯式聲明。這種情況在 Spring Boot 多模塊架構(gòu)里很常見(jiàn)子模塊也能編譯通過(guò)但有時(shí) IDEA 的注解處理器會(huì)找不到對(duì)應(yīng)的類路徑導(dǎo)致某些模塊報(bào)錯(cuò)。建議在每個(gè)需要用到 Lombok 的子模塊中顯式引入依賴。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 編譯報(bào) “java: You arent using a compiler supported by lombok”這個(gè)報(bào)錯(cuò)我已經(jīng)提過(guò)但值得再展開(kāi)細(xì)說(shuō)。它的觸發(fā)條件不一定是 JDK 版本太新如果你的項(xiàng)目配置了特殊的--release參數(shù)或者用了老版本的 Lombok也會(huì)觸發(fā)。具體的排查方法先看 JDK 版本java -version。再看 Lombok 版本在 pom.xml 里定位或者使用 Maven 的 dependency 插件查看。mvn clean compile -X這條命令會(huì)把編譯過(guò)程完整打印出來(lái)搜索片段path-to-lombok可以看到 IDEA 實(shí)際使用的是哪個(gè) Lombok jar。如果這里顯示的lombok-1.16.x.jar那就不用糾結(jié)了直接升版本。如果確實(shí)要保留低版本 Lombok可以將項(xiàng)目的 Language Level 調(diào)到 8 或 11JAVA 版本也降到匹配的范圍因?yàn)槔习姹?Lombok 對(duì)高版本的 class 文件格式是不兼容的。但天天腰疼還不如升級(jí)。4.2 更新 IDEA 后 Lombok 突然失效這種事件很常見(jiàn)。IDEA 升級(jí)后舊版本的 Lombok 插件可能因?yàn)榧嫒菪詥?wèn)題被自動(dòng)禁用了。你可以在Settings - Plugins - Installed里看到Lombok項(xiàng)它的啟用勾選框可能變成了未勾選狀態(tài)重新勾選并重啟即可。另外新版 IDEA 里 Lombok 插件已經(jīng)和 Spring 插件整合有些版本修改了插件的配置方式。如果你看到的是Lombok Plugin被標(biāo)記為Bundled那不需要額外安裝但你要檢查Enable annotation processing是否在升級(jí)過(guò)程中被重置了。因?yàn)槲矣龅竭^(guò)好幾次IDEA 升級(jí)后默認(rèn)配置被恢復(fù)Annotations Processors 的勾選被撤掉了。4.3 依賴標(biāo)紅或 Maven 導(dǎo)入失敗的解法如果 pom.xml 中 Lombok 依賴下方出現(xiàn)紅色波浪線說(shuō)明依賴還沒(méi)有成功進(jìn)入 IDEA 的 classpath。先在右側(cè) Maven 工具欄點(diǎn)擊刷新按鈕一個(gè)循環(huán)圖標(biāo)。如果刷新后還是紅色打開(kāi)Settings - Build, Execution, Deployment - Build Tools - Maven檢查L(zhǎng)ocal repository路徑確認(rèn)是不是路徑寫錯(cuò)了。也可以嘗試手動(dòng)執(zhí)行一段命令強(qiáng)制更新mvn -U idea:idea這會(huì)在命令行生成 IDEA 的項(xiàng)目文件雖然現(xiàn)代 IDEA 已經(jīng)很少需要但在特殊情況下能重新生成.iml文件和依賴信息。還有一個(gè)冷門但真實(shí)的問(wèn)題Lombok jar 包損壞或下載不完整。解決辦法是刪除本地倉(cāng)庫(kù)里org/projectlombok整個(gè)目錄然后重新mvn clean install或者讓 IDEA 重新導(dǎo)入。這個(gè)操作會(huì)強(qiáng)制觸發(fā)下載耗時(shí)不長(zhǎng)。4.4 為什么 Maven 命令行正常IDEA 運(yùn)行卻報(bào)錯(cuò)這個(gè)問(wèn)題通常有兩個(gè)原因。第一個(gè)原因是 IDEA 內(nèi)置編譯器和 Maven 使用的 JDK 版本不一致。Maven 配置的是JAVA_HOME環(huán)境變量指向的 JDK而 IDEA 的項(xiàng)目 SDK 可能是另一個(gè)版本。比如 Maven 用 Java 8 編譯完全沒(méi)問(wèn)題IDEA 卻用的是 Java 21Lombok 老版本就扛不住了。這種情況在本地同時(shí)裝了好幾個(gè) JDK 時(shí)特別容易發(fā)生。檢查方法Settings - Build, Execution, Deployment - Build Tools - Maven - Runner這里的JRE選項(xiàng)會(huì)影響 Maven 運(yùn)行時(shí)用的 JDKProject Structure - Project SDK決定 IDEA 編譯器用的 JDK。把這兩處統(tǒng)一到同一個(gè)版本問(wèn)題就能解決。第二個(gè)原因是 IDEA 之前緩存了舊的編譯錯(cuò)誤。明明配置已經(jīng)修正但點(diǎn)運(yùn)行還是報(bào)同樣的錯(cuò)。這時(shí)不要糾結(jié)直接Build - Rebuild Project如果還是不行就Invalidate Caches。4.5 完全沒(méi)有網(wǎng)絡(luò)時(shí)怎么裝 Lombok 插件有些公司開(kāi)發(fā)環(huán)境是不允許外網(wǎng)的IDEA 默認(rèn)的插件市場(chǎng)連不上。這時(shí)你可以用離線安裝。先在能上網(wǎng)的機(jī)器上從 JetBrains 插件市場(chǎng)頁(yè)面下載 Lomobok 插件的 zip 包。注意要選和你 IDEA 版本匹配的版本IDEA 插件市場(chǎng)會(huì)按你的 IDEA 版本過(guò)濾。下載后拷貝到離線機(jī)器在 IDEA 里打開(kāi)Settings - Plugins點(diǎn)擊右上角的齒輪按鈕選擇Install Plugin from Disk...選中 zip 包后安裝重啟即可。如果你用的 IDEA 是 2020.1 及以上版本那么 Lombok 插件本身就在 IDEA 安裝目錄的plugins子目錄里。去安裝目錄下找找有沒(méi)有l(wèi)ombok或lombok-plugin文件夾。如果有說(shuō)明插件存在只是沒(méi)有被啟用直接在插件列表里啟用就行不需要下載。5. 一些容易踩的深層坑5.1 注解處理器配置錯(cuò)誤導(dǎo)致其他注解也失效有人為了讓 Lombok 生效手動(dòng)修改了注解處理器設(shè)置結(jié)果導(dǎo)致 Spring Boot 的ConfigurationProperties或者ComponentScan處理器也出了問(wèn)題。因?yàn)锳nnotation Processors配置里可以自定義處理器路徑如果你誤加了其他不相關(guān)的處理器編譯器會(huì)發(fā)生沖突。我個(gè)人推薦的做法勾選Enable annotation processing和Obtain processors from project classpath就夠了不要手動(dòng)在處理器列表里添加任何全限定類名。Lombok 的處理器類一般是lombok.launch.AnnotationProcessorHider$AnnotationProcessor它會(huì)在 classpath 中自動(dòng)被發(fā)現(xiàn)。除非你有非常特殊的自定義處理器否則保持默認(rèn)就是最穩(wěn)的。5.2 多個(gè) Lombok 版本同時(shí)存在如果你的本地 Maven 倉(cāng)庫(kù)中既有 1.18.22 又有 1.18.30且項(xiàng)目依賴沖突導(dǎo)致 IDEA 選擇了錯(cuò)誤版本也會(huì)出現(xiàn)奇怪現(xiàn)象。比如明明項(xiàng)目 pom 里寫了 1.18.30但 IDEA 的編譯日志里顯示使用的是另一個(gè)版本。這種情況需要檢查依賴樹mvn dependency:tree -Dincludesorg.projectlombok:lombok看到輸出后確認(rèn)項(xiàng)目最終解析出來(lái)的版本是什么。如果發(fā)現(xiàn)是舊的傳遞依賴可以在 pom.xml 中對(duì)直接聲明的依賴強(qiáng)制指定版本。有時(shí)候 Spring Boot 父依賴管理的 Lombok 版本可能比最新版低但默認(rèn)是相對(duì)穩(wěn)定的。如果確實(shí)遇上 JDK 新版本兼容問(wèn)題可以在properties中顯式覆蓋properties lombok.version1.18.30/lombok.version /properties5.3 在 Java 模塊化項(xiàng)目里使用 Lombok如果你在用 Java 9 以上的模塊化項(xiàng)目module-info.java里需要聲明requires lombok;嗎不需要也不應(yīng)該。Lombok 只在編譯期工作它不進(jìn)入運(yùn)行模塊圖。如果在模塊描述文件里增加 Lombok 依賴反而可能導(dǎo)致模塊解析異常。正確的做法是在模塊描述文件中忽略 Lombok保持它在requires之外并且依賴作用域設(shè)置為provided。在 Spring Boot 的實(shí)際場(chǎng)景中絕大多數(shù)項(xiàng)目沒(méi)有使用模塊化所以這個(gè)問(wèn)題并不常見(jiàn)但如果你在搞一些比較新的工程結(jié)構(gòu)可以留個(gè)印象。5.4 編譯時(shí) Lombok 生效但運(yùn)行時(shí)報(bào) NoSuchMethodError還有一種少見(jiàn)但讓人頭疼的情況代碼編譯通過(guò)了運(yùn)行期啟動(dòng) Spring Boot 時(shí)某個(gè)類報(bào)NoSuchMethodError提示找不到getXXX方法。這種多半是目標(biāo) class 文件沒(méi)有真正包含編譯期生成的方法但 IDEA 編譯時(shí)又沒(méi)有報(bào)錯(cuò)。我遇到過(guò)一次是因?yàn)槟K編譯順序問(wèn)題一個(gè)模塊里的target/classes沒(méi)有及時(shí)更新導(dǎo)致運(yùn)行時(shí)加載的 class 是舊版本。解決辦法是把項(xiàng)目徹底mvn clean一次然后重新 compile。在 IDEA 里可以執(zhí)行Build - Rebuild Project清理所有模塊的編譯輸出避免臟 class 遺留。6. 繞不開(kāi)的 IDE 版本差異6.1 社區(qū)版 vs 商業(yè)版對(duì) Lombok 的支持差異很多初學(xué)者用的 IDEA Community 版擔(dān)心是不是因?yàn)樯鐓^(qū)版導(dǎo)致 Lombok 失效。其實(shí)不是。Lombok 插件對(duì)社區(qū)版和商業(yè)版的底層支持是一樣的。但社區(qū)版不支持 Spring Initializr 項(xiàng)目向?qū)Ю锏哪承┕δ鼙热缧陆?xiàng)目時(shí)自動(dòng)加入 Spring Boot 相關(guān)依賴這會(huì)導(dǎo)致你無(wú)法在向?qū)е兄苯庸催x Lombok。如果你用了社區(qū)版那么可以在創(chuàng)建完普通項(xiàng)目后手動(dòng)在 pom.xml 中添加依賴。其他步驟不變。所以不要再懷疑是社區(qū)版的問(wèn)題了Lombok 本身和 IDE 版本無(wú)關(guān)JVM 和編譯器才相關(guān)。6.2 IDEA 2023/2024 版本的新改動(dòng)在最新幾個(gè)版本里JetBrains 把 Lombok 插件邏輯整合到了Dependencies的分析中。如果你打開(kāi)Project Structure - Facets可能會(huì)看到 Spring 和 Lombok 的標(biāo)識(shí)。這些改動(dòng)或許會(huì)帶來(lái)一些 UI 上的陌生感但核心設(shè)置路徑基本沒(méi)變。在 2024.1 及以后版本中Compiled classes output的路徑結(jié)構(gòu)有所調(diào)整但注解處理的開(kāi)關(guān)位置仍然在原來(lái)的菜單里。如果你找不到可以直接在設(shè)置窗口左上角搜索框輸入 “Annotation”會(huì)快速定位。6.3 有些所謂的“IDEA 破解版”也會(huì)導(dǎo)致 Lombok 失效這里我必須強(qiáng)調(diào)一句不要使用非官方渠道的激活方式。且不談版權(quán)問(wèn)題破解版的 IDEA 往往修改了核心 jar 包插件加載機(jī)制可能被破壞導(dǎo)致 Lombok 插件無(wú)法正確注冊(cè)為編譯器插件。很多人遇到“怎么設(shè)置都沒(méi)用”的疑難雜癥最后發(fā)現(xiàn)是因?yàn)橛昧瞬灰?guī)范的 IDEA 安裝包。我建議直接去 JetBrains 官網(wǎng)下載官方安裝包社區(qū)版就完全免費(fèi)。實(shí)在需要付費(fèi)功能的可以評(píng)估一下是否真的需要商業(yè)版或者使用開(kāi)源替代品。在你的開(kāi)發(fā)工具上穩(wěn)定性和可維護(hù)性永遠(yuǎn)是最優(yōu)先的。7. 最后再分享兩個(gè)小技巧第一個(gè)技巧是如果你在 IDEA 里怎么折騰都搞不定但 Maven 命令行編譯是正常的那就別再死磕 IDEA 編譯按鈕了。可以在Settings - Build, Execution, Deployment - Build Tools - Maven - Runner中勾選Delegate IDE build/run actions to Maven。這樣 IDEA 的構(gòu)建和運(yùn)行操作會(huì)直接轉(zhuǎn)交給 Maven 處理相當(dāng)于繞開(kāi)了 IDEA 內(nèi)置編譯器。在這個(gè)模式下只要 Maven 能編譯過(guò)IDEA 里運(yùn)行 Spring Boot 項(xiàng)目也就沒(méi)問(wèn)題。這個(gè)技巧尤其適合那些 IDEA 內(nèi)置編譯器就是和 Lombok 八字不合的極端環(huán)境。第二個(gè)技巧是使用 Lombok 時(shí)盡量讓實(shí)體類保持簡(jiǎn)潔。Data雖然把 getter/setter/toString/equals/hashCode 全包了但在某些復(fù)雜業(yè)務(wù)場(chǎng)景下equals和hashCode的生成規(guī)則可能會(huì)拖垮性能。如果你只需要簡(jiǎn)單的賦值和取值可以用Getter和Setter如果你不想生成 equals 和 hashCode可以單獨(dú)用Getter Setter ToString而不要無(wú)腦Data。這和本次的報(bào)錯(cuò)主題無(wú)關(guān)但既然是聊 Lombok順手提醒一下開(kāi)發(fā)者們養(yǎng)成習(xí)慣避免在長(zhǎng)期維護(hù)的項(xiàng)目里給自己留坑。我這個(gè)環(huán)境里實(shí)際操作過(guò)太多次遇到的案例五花八門從最簡(jiǎn)單的沒(méi)開(kāi)注解處理到復(fù)雜的 JDK 版本不匹配再到因?yàn)?IDEA 插件國(guó)服鏡像問(wèn)題導(dǎo)致插件安裝失敗。但只要按照插件優(yōu)先、注解處理其次、依賴版本兜底的思路走一遍百分之九十九的問(wèn)題都能在當(dāng)前環(huán)境內(nèi)消化掉。剩下那百分之一直接使用Delegate IDE build/run actions to Maven這個(gè)終極大招就可以安心回代碼邏輯本身了。如果你現(xiàn)在正被這個(gè)問(wèn)題卡著推進(jìn)度照著這篇把Settings一步一步走下來(lái)基本十分鐘內(nèi)就能看到編寫區(qū)里的紅色波浪線消失編譯也順利通過(guò)。要是還不行請(qǐng)把報(bào)錯(cuò)日志再讀一遍看看是不是出現(xiàn)了ServiceConfigurationError或UnsupportedClassVersionError那些是另一個(gè)維度的問(wèn)題但本文里提到的排查思路依然適用。