Windows10下Kivy Hello World示例无法运行求助

检查显示后端与日志 #

Kivy在Windows默认用sdl2做显示后端，可能后端异常但未在终端报错。试试在代码开头添加以下配置，强制输出详细日志：

import os
os.environ['KIVY_LOG_MODE'] = 'verbose'
os.environ['KIVY_WINDOW'] = 'sdl2'

运行后查看终端，确认是否有SDL2依赖缺失之类的具体错误提示。

确认VSCode的Python环境 #

• 按下Ctrl+Shift+P，输入Python: Select Interpreter，选择安装了Kivy的Python3.10.4环境，避免选错解释器。
• 跳过VSCode终端，直接在CMD或PowerShell中运行脚本：

  python your_script.py
  

  如果原生终端能弹出窗口，说明VSCode的终端配置或环境变量存在问题。

调整Windows显示设置 #

• 右键点击Python.exe或VSCode.exe，选择「属性」→「兼容性」，勾选「替代高DPI缩放行为」，下拉选择「应用程序」，重启程序后重试。
• 若有多个显示器，检查窗口是否被渲染到未激活的屏幕上。

修复Kivy依赖 #

• 安装适配Python3.10的Kivy版本（2.1.0兼容性较好），执行重装命令：

  pip install kivy[base]==2.1.0 --no-binary kivy
  

• 补装Windows平台所需的依赖组件：

  pip install docutils pygments pypiwin32 kivy.deps.sdl2 kivy.deps.glew
  

测试最简代码 #

用以下极简代码测试，排除自身代码的逻辑问题：

from kivy.app import App
from kivy.uix.label import Label

class TestApp(App):
    def build(self):
        return Label(text='Hello World')

if __name__ == '__main__':
    TestApp().run()

若这段代码仍无法弹出窗口，聚焦排查环境问题；能弹出则说明原代码存在逻辑错误。

内容的提问来源于stack exchange，提问作者Júlio César E. Jr