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。
✅ 正确使用步骤如下：
-
安装示例资源（注意：仅需安装一次）：
pip install kivy-examples
-
定位示例根目录（根据你的环境调整路径）：
- 虚拟环境中通常位于：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
-
进入任一示例子目录并运行主程序：
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 示例入手，熟悉其结构后再基于其模板开发自己的应用。
