我之前在使用IDEA GUI Designer开发泛型Swing组件时，也碰到过这种无限显示“Loading”的问题，尤其是自定义的JFormattedTextField子类。结合你提供的最小复现案例，这个问题大概率是GUI Designer在解析泛型Swing组件时的类加载/反射兼容性问题，下面给你几个针对性的解决方案：

解决方案1：给自定义泛型组件添加设计时BeanInfo支持 #

IDEA GUI Designer依赖JavaBean规范来解析组件，泛型类的存在可能导致它无法正确识别组件的构造方法和属性。我们可以通过创建BeanInfo类来明确告诉设计器如何处理组件：

1. 在common.gui包下创建ValueFieldBeanInfo类：

import java.beans.SimpleBeanInfo;

public class ValueFieldBeanInfo extends SimpleBeanInfo {
    @Override
    public Class<?> getBeanClass() {
        return ValueField.class;
    }
}

这个类不需要任何复杂逻辑，只需要告诉GUI Designer组件的实际类型，帮助它绕过泛型解析的障碍。

2. 重启IDEA并重新打开GUI Designer面板，大部分情况下Loading状态会消失，组件能正常渲染。

解决方案2：调整IDEA GUI Designer的编译设置 #

有时候是IDEA的类路径配置导致设计时无法正确加载自定义组件：

• 打开IDEA的File > Settings > Build, Execution, Deployment > Compiler > GUI Designer
• 确保Enable GUI Designer已勾选
• 在Classpath for form compilation中，添加当前模块的编译输出路径（比如out/production/[你的模块名]）
• 点击Apply后，重新打开form文件

解决方案3：修改自定义组件的泛型声明（折中方案） #

如果上述方案都无效，可以尝试给ValueField添加一个非泛型的子类，专门用于GUI设计：

1. 创建一个非泛型的子类：

package common.gui;

public class DesignTimeValueField extends ValueField<Object> {
    // 直接继承泛型实例化后的类型，不需要额外代码
}

2. 在form文件中，将组件的class属性修改为common.gui.DesignTimeValueField，同时代码中对应的field声明改为DesignTimeValueField field;
3. 这样设计时GUI Designer能正常渲染，运行时你依然可以直接使用子类的API，完全不需要强转操作。

临时排查技巧 #

如果还是无法解决，可以尝试：

• 执行File > Invalidate Caches... > Invalidate and Restart，清理IDEA的缓存
• 在ValueField的无参构造中添加无头环境判断，避免设计时执行不必要的初始化：

  public ValueField() {
      // IDEA设计时处于无头环境，跳过复杂初始化
      if (GraphicsEnvironment.isHeadless()) {
          return;
      }
      // 你的正常初始化逻辑
  }
  

• 暂时降级到IDEA 2023.3版本：Java 8搭配IDEA 2024.1可能存在一些小兼容性问题，老版本对Java 8的GUI Designer支持更稳定

另外，你的代码中已经正确使用了custom-create="true"和createUIComponents方法，这是避免GUI Designer自动实例化组件异常的正确写法，保持这个习惯即可。