VSCode中使用Kivy（KV语言）启动异常：窗口空白无控件

核心排查点与解决方案 #

1. 严格遵循KV文件自动加载规则 #

Kivy的自动加载机制依赖文件名匹配和目录位置：

• 你的App类名为box，所以KV文件名必须是box.kv（全小写，与App类名完全一致）
• KV文件必须和Python脚本放在同一目录下，不能放在子文件夹中

2. 检查KV文件的语法结构 #

KV文件必须包含对应根组件的规则块，才能和Python代码中的Action类绑定。示例KV代码如下：

<Action>:
    BoxLayout:
        orientation: 'vertical'
        Label:
            id: lb
            text: '0'
        Button:
            text: '点击加1'
            on_press: root.sum()

• 必须用<Action>作为根规则（和你的Python类名一致）
• 内部组件的id要和Python代码中self.ids.lb完全匹配

3. 手动加载KV文件（自动加载失效时） #

如果自动加载不生效，直接在Python代码中手动指定加载路径，修改box类：

from kivy.lang import Builder  # 新增导入

class box(App):
    def build(self):
        Builder.load_file('box.kv')  # 替换为你的KV文件名
        return Action()

4. 确认VSCode的虚拟环境配置 #

确保VSCode使用的是安装了Kivy的虚拟环境：

• 打开命令面板（Ctrl+Shift+P）
• 选择Python: Select Interpreter
• 选中你创建的、安装了Kivy的虚拟环境

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