Kivy 官方示例并非可直接导入的 Python 模块，而是独立的演示项目集合；安装后需手动进入对应目录，找到主程序（如 main.py）并以普通脚本方式运行。

kivy 官方示例并非可直接导入的 python 模块，而是独立的演示项目集合；安装后需手动进入对应目录，找到主程序（如 `main.py`）并以普通脚本方式运行。

Kivy 是一个功能强大的开源 Python GUI 框架，常用于开发跨平台桌面与移动应用。官方提供了丰富的示例程序（如 demo, touchtracer, camera, pong 等），但这些示例不是 Python 包中的子模块（即不存在 kivy.examples.main 这样的可导入路径），因此执行 python -m kivy.examples.main 或 python -m kivy.examples.__main__ 会报错：

ModuleNotFoundError: No module named 'kivy.examples'

这是因为 kivy-examples 并非一个可导入的 Python 包，而是一个资源集合包（data-only distribution），其内容被安装到环境的共享数据目录中（如 venv/share/kivy-examples/），而非 site-packages。

✅ 正确使用步骤如下：

1. 安装示例资源（注意：仅需安装一次）：

   pip install kivy-examples

2. 定位示例根目录（根据你的环境调整路径）：

   • 虚拟环境中通常位于：venv/share/kivy-examples/
   • Conda 环境中可能在：envs/your-env/share/kivy-examples/
   • 全局安装可尝试查找：

     python -c "import kivy; print(kivy.__file__)"
     # 然后向上推导 share 目录，或使用：
     find $(python -c "import sys; print(sys.prefix)") -name "kivy-examples" 2>/dev/null

3. 进入任一示例子目录并运行主程序：

   cd venv/share/kivy-examples/demo/showcase
   python main.py  # ✅ 正确方式：作为独立脚本运行

   ? 大多数示例的入口文件是 main.py，少数为 app.py 或 demo.py，请先查看目录内容（ls）确认。

⚠️ 注意事项：

• 不要尝试 import kivy.examples 或 python -m kivy.examples.xxx —— 这在任何 Kivy 版本中均不支持；
• 示例依赖当前环境中已安装的 kivy（确保 pip install kivy 已成功）；
• 部分示例（如 camera）需要额外系统依赖（如 GStreamer、OpenCV），运行前请查阅对应 README.md；
• 若遇到 OpenGL 或窗口初始化错误，请检查显卡驱动及是否启用 --no-sandbox（Linux Wayland 下可能需切换至 X11）。

? 总结：Kivy 示例是“可运行的演示工程”，而非“可导入的模块”。理解这一设计差异，是顺利上手 Kivy 生态的关键一步。建议初学者从 showcase 或 pong 示例入手，熟悉其结构后再基于其模板开发自己的应用。