Kivy ScrollView 子控件不显示的常见原因及解决方案

本文详解

kivy 中 scrollview 子控件（如 label、gridlayout）无法显示的根本原因：错误地创建了新 app 实例而非调用当前运行实例的方法，导致 ui 更新失效。

在 Kivy 开发中，ScrollView 是展示长内容的常用容器，但其子控件“莫名空白”是新手高频踩坑点。你提供的代码中，右侧 ScrollView 始终为空，看似布局或尺寸问题，实则根源在于 对象作用域与实例引用错误。

关键问题出在 SelectableLabel.apply_selection() 方法中这一行：

MyApp().display_info(self.data)  # ❌ 错误！每次新建一个 MyApp 实例

该语句每次都会构造一个全新的 MyApp() 对象——它独立于当前正在运行的 GUI 应用，其内部的 self.info_layout 是全新未挂载的空容器，对主窗口中的 ScrollView 完全无影响。因此，无论 print(data) 是否输出成功，display_info() 的 UI 操作都发生在“影子应用”中，真实界面自然毫无反应。

✅ 正确做法是获取当前正在运行的 App 实例，使用 Kivy 官方推荐的单例访问方式：

from kivy.app import App

# 替换原 apply_selection 中的错误调用：
def apply_selection(self, rv, index, is_selected):
    self.selected = is_selected
    if is_selected:
        App.get_running_app().display_info(self.data)  # ✅ 正确：获取真实运行实例

此外，还需确保 ScrollView 内部子控件能正确触发高度自适应。你已为 GridLayout 设置了 size_hint_y=None 和 height=500，这虽可临时生效，但更健壮的做法是绑定 minimum_height 并启用 scroll_type：

# 在 build() 中优化 info_layout 初始化：
self.info_layout = GridLayout(
    cols=1,
    size_hint_y=None,
    height=0,  # 初始高度设为 0，后续由 minimum_height 驱动
)
self.info_layout.bind(minimum_height=self.info_layout.setter('height'))

同时，在 KV 字符串中为 ScrollView 显式启用滚动行为（可选但推荐）：

ScrollView:
    size_hint_x: 0.65
    do_scroll_x: False
    do_scroll_y: True

⚠️ 注意事项：

• 永远避免在回调中通过 MyApp() 构造新实例操作 UI；统一使用 App.get_running_app()；
• ScrollView 要显示内容，其直接子控件必须设置 size_hint_y=None 且明确绑定 height（通常通过 minimum_height）；
• RecycleView 的 data 更新不会自动触发外部组件刷新，需显式调用业务逻辑（如本例的 display_info）。

修正后，点击左侧单词即可实时在右侧 ScrollView 中显示对应释义，UI 响应完全正常。这是 Kivy 事件驱动与对象生命周期管理的经典实践案例。