Kivy 示例程序运行指南：正确启动 kivy-examples 中的演示应用

安装 kivy 后无法通过 python -m kivy.examples.main 运行示例，是因为 kivy-examples 并非可导入的 python 模块，而是独立的示例项目集合，需手动进入对应目录并直接执行主脚本。

安装 kivy 后无法通过 python -m kivy.examples.main 运行示例，是因为 kivy-examples 并非可导入的 python 模块，而是独立的示例项目集合，需手动进入对应目录并直接执行主脚本。

Kivy 官方提供的示例（kivy-examples）本质上是一组完整的、自包含的演示应用，而非设计为可导入的 Python 包。因此，kivy.examples 在 Python 导入系统中并不存在——它不是模块路径，自然会触发 ModuleNotFoundError: No module named 'kivy.examples'。

✅ 正确操作流程如下：

1. 安装示例集（注意：不是 pip install kivy-examples 的常规用法，而是官方推荐方式）：

   pip install kivy[base,examples]

   或（若已安装 kivy）仅安装示例资源：

   JoinMC智能客服

   JoinMC智能客服，帮您熬夜加班，7X24小时全天候智能回复用户消息，自动维护媒体主页，全平台渠道集成管理，电商物流平台一键绑定，让您出海轻松无忧！

   下载

   pip install --force-reinstall --no-deps kivy-examples

2. 定位示例文件路径：
   安装后，示例文件被解压到 Python 环境的共享数据目录中。可通过以下命令快速查找：

   import kivy
   print(kivy.__file__)
   # 然后上溯至 site-packages 所在目录，查找 share/kivy-examples/ 子目录
   # 或更直接地：
   import os
   from kivy import examples_dir
   print(examples_dir)  # ✅ 推荐！Kivy 2.0+ 内置属性

   ? 提示：Kivy 2.0 及以上版本提供 kivy.examples_dir 属性，返回绝对路径（如 /path/to/venv/share/kivy-examples）。

3. 运行具体示例：
   进入任一子目录（如 demo/showcase），找到入口文件（通常是 main.py 或 showcase.py），然后直接运行：

   cd $(python -c "from kivy import examples_dir; print(examples_dir)")/demo/showcase
   python main.py

⚠️ 注意事项：

• 不要尝试 python -m kivy.examples.demo 或 python -m kivy.examples.__main__ —— 这些路径在 Python 包结构中根本不存在；
• 部分示例依赖额外资源（如图片、字体、KV 文件），务必在示例所在目录下执行，否则可能报 FileNotFoundError；
• 若使用虚拟环境，请确保 pip install 和 python 命令指向同一环境（可通过 which python 和 pip show kivy 验证）；
• Windows 用户注意路径分隔符，建议统一使用正斜杠 / 或 os.path.join()。

? 总结：kivy-examples 是“可运行的项目集合”，不是“可导入的模块”。掌握 kivy.examples_dir 这一内置路径接口，并养成在示例根目录下直接执行 python main.py 的习惯，即可高效调试与学习所有官方示例。