Kivy库安装问题求助：找不到kivy.examples模块

问题重现 #

运行python -m kivy.examples.main时触发错误：

ModuleNotFoundError: No module named 'kivy.examples'

已尝试的无效操作：

• 执行pip install kivy-examples
• 运行python -m kivy.examples.demo
• 运行python -m kivy.examples.__main__

有效解决步骤 #

1. 匹配Kivy与kivy-examples的版本 #

kivy-examples必须和已安装的Kivy主版本完全一致，否则会出现模块不兼容：

• 先查看当前Kivy版本：

  python -c "import kivy; print(kivy.__version__)"
  

• 安装对应版本的kivy-examples：

  pip install kivy-examples==<你的Kivy版本号>
  

  例：若Kivy版本为2.2.1，执行pip install kivy-examples==2.2.1

2. 检查并修正安装路径 #

部分场景下，pip会将kivy-examples安装到Python解释器无法识别的路径：

• 执行命令获取pip的用户安装目录：

  python -m site --user-site
  

• 查看该目录下是否存在kivy_examples文件夹（注意是下划线而非点），若存在，需将该路径添加到Python环境变量：

  # Windows系统
  set PYTHONPATH=%PYTHONPATH%;<上述获取的路径>
  
  # macOS/Linux系统
  export PYTHONPATH="$PYTHONPATH:<上述获取的路径>"
  

  也可在代码中临时添加路径：

  import sys
  sys.path.append("<上述获取的路径>")
  

3. 直接从源码获取示例文件 #

若以上方法无效，可手动从Kivy源码中提取示例：

• 下载与已安装Kivy版本一致的源码包，解压后找到examples文件夹
• 将examples文件夹复制到Python项目目录，或Python的site-packages/kivy目录下

4. 验证修复结果 #

完成操作后，运行以下命令测试：

python -m kivy.examples.main

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