自定义GTK Widget（带UI模板）无法显示的问题求助

以下是针对你遇到的问题的常见排查方向和解决方法：

• 检查自定义Widget的尺寸处理逻辑
  自定义Widget如果是GtkWidget子类，必须正确处理尺寸请求。如果你的MyWidget没有重写get_preferred_width()和get_preferred_height()虚函数，也没有给内部的GtkLabel设置合适的尺寸或让它自动展开，AdwOverlaySplitView会认为这个Widget尺寸为0，导致视觉上不可见。可以尝试在my-widget.c的初始化函数中给MyWidget设置最小尺寸：gtk_widget_set_size_request(GTK_WIDGET(self), 200, 50);，或者确保子控件被正确添加到容器并能填充空间（比如用GtkBox作为MyWidget的基类，调用gtk_box_append()添加Label并设置expand=True）。

• 确认UI文件与代码的绑定是否正确
  检查my-widget.ui的根控件是否正确，比如如果MyWidget是GtkBin子类，UI文件的根应该是对应的容器。同时在my-widget.c中，要确保通过GtkBuilder加载UI文件后，正确获取到内部的GtkLabel，并将其添加到MyWidget实例中。例如：

  GtkBuilder *builder = gtk_builder_new_from_resource("/com/example/my-widget.ui");
  GtkWidget *label = GTK_WIDGET(gtk_builder_get_object(builder, "my-label"));
  gtk_container_add(GTK_CONTAINER(self), label);
  g_object_unref(builder);
  

  如果这一步遗漏，MyWidget内部没有子控件，自然不会有视觉输出。

• 验证自定义Widget的GType注册是否正确
  确保my-widget.c中正确注册了MyWidget的GType，比如在my_widget_class_init()中设置了正确的父类（比如GTK_TYPE_BOX或GTK_TYPE_WIDGET），并且在应用启动时调用了g_type_ensure(MY_TYPE_WIDGET)来确保类型被加载。如果类型注册失败，UI文件中的MyWidget实例化会有问题，即使Inspector能识别，也无法正确渲染。

• 检查AdwOverlaySplitView的配置
  打开app-window.ui，确认AdwOverlaySplitView的content属性确实绑定了MyWidget，格式应该类似：

  <object class="AdwOverlaySplitView">
    <property name="content">
      <object class="MyWidget"/>
    </property>
  </object>
  

  同时确认AdwOverlaySplitView本身的visible属性为True，并且已经被正确添加到AdwApplicationWindow的子控件中。

• 用GTK Inspector深入排查
  既然Inspector能识别到MyWidget，右键它查看Allocated Width和Allocated Height：

  • 如果这两个值都是0，说明尺寸计算逻辑有问题，回到第一步检查尺寸处理；
  • 如果有尺寸但看不到，检查MyWidget和内部Label的visible属性是否为True，或者查看样式（比如是否背景色与文字色一致，导致看不见文字）。

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