Kivy应用在Visual Studio Code运行显示黑屏无法正常加载问题求助

解决步骤 #

• 确认运行时工作目录
  运行pong.py前需先进入pong.py和pong.kv两个文件所在的文件夹，再执行启动命令，避免相对路径加载kv文件失败。如果使用编辑器运行脚本，需要在编辑器的运行配置中设置工作目录为pong.py所在目录。

• 修改kv文件加载逻辑为绝对路径
  将pong.py中Builder.load_file('pong.kv')替换为如下代码，避免相对路径受运行位置影响：

import os
# 获取当前py文件所在目录的绝对路径
current_dir = os.path.dirname(os.path.abspath(__file__))
kv_file_path = os.path.join(current_dir, 'pong.kv')
Builder.load_file(kv_file_path)

• 清理Kivy缓存
  Kivy的编译缓存损坏会导致样式渲染异常，删除缓存目录后重新运行即可恢复：
  Windows系统缓存路径为 C:\Users\你的用户名\.kivy\cache，直接删除整个cache文件夹。

• 校验Python环境一致性
  确认当前运行代码的Python环境和Visual Studio 2019使用的是同一个环境，若Kivy版本不一致或组件损坏，可执行命令重装Kivy：

pip uninstall kivy -y
pip install kivy

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