求助：IntelliJ未显示将POJO转换为Java Record的选项

我有100多个POJO类，想要自动转换为Java Record。当前使用Java 18（Amazon Corretto JDK）及IntelliJ 2022.1.4旗舰版（Build #IU-221.6008.13，2022年7月18日构建），已将corretto-18配置为模块默认VM。按照官方指引操作后，右键上下文菜单中并未出现预期的“Convert to a record”选项。

以下是排查和解决的具体步骤：

一、确认POJO符合转换前提 #

Record是为不可变数据类设计的，IntelliJ只会对符合条件的POJO提供转换选项：

• 必须是普通顶层类或静态内部类，抽象类、枚举、非静态内部类无法转换
• 类中字段为私有，且存在对应的getter方法（IntelliJ通过getter识别要作为Record组件的字段）
• 类中无复杂自定义逻辑，比如非标准构造方法、修改字段的业务方法（仅保留字段、getter、equals/hashCode/toString这类标准POJO结构）

二、检查IntelliJ的Java版本配置 #

除了模块VM，还要确保项目和模块的语言级别达标（Record从Java 16开始支持）：

1. 打开File → Project Structure → Project Settings → Project
   • 确认Project SDK选择的是corretto-18
   • 将Project language level设置为18或至少16 - Records, patterns, local enums and interfaces
2. 切换到Modules标签，选中目标模块进入Sources页签，同步将Language level设为16+

三、手动触发转换动作 #

如果右键菜单没选项，试试两种手动触发方式：

• 光标定位到类名上，按下Alt+Enter（Windows/Linux）或Option+Enter（Mac），查看弹出的动作列表里是否有转换选项
• 按Ctrl+Shift+A（Windows/Linux）或Cmd+Shift+A（Mac）打开动作搜索框，直接输入Convert to record，找到后执行

四、批量转换技巧 #

面对100多个类，单个转换效率太低，推荐用IntelliJ的结构搜索替换批量处理：

1. 打开Edit → Find → Replace Structurally
2. 配置搜索模板（示例适配单字段POJO，可扩展多字段）：

   public class $Class$ {
       private $Type$ $Field$;
   
       public $Type$ get$Field$() {
           return $Field$;
       }
   
       @Override
       public boolean equals(Object o) {
           // 标准equals逻辑
       }
   
       @Override
       public int hashCode() {
           // 标准hashCode逻辑
       }
   
       @Override
       public String toString() {
           // 标准toString逻辑
       }
   }
   

3. 设置替换模板为Record：

   public record $Class$($Type$ $Field$) {}
   

4. 调整变量匹配规则（比如让$Field$匹配多个字段），然后批量应用到所有符合条件的POJO文件

五、版本兼容性优化 #

IntelliJ 2022.1.x对Java 18的Record转换支持可能存在小瑕疵，如果允许的话，升级到IntelliJ 2022.2及以上版本，新版本对Java 18的兼容性更好，转换功能更稳定

内容的提问来源于stack exchange，提问作者mitchkman