树莓派4 Raspbian10环境Python3无法导入gi.repository问题求助

前置系统依赖安装 #

首先退出虚拟环境，执行系统级依赖安装命令，确保底层依赖完整：
apt update && apt install -y python3-gi python3-gi-cairo gir1.2-glib-2.0 gir1.2-gio-2.0

虚拟环境适配方案 #

gi.repository 属于系统级Python绑定包，默认虚拟环境不会继承系统site-packages资源，按你的场景选对应方案即可：

• 方案1：新建虚拟环境时开启系统包继承
  执行命令创建虚拟环境：
  python3 -m venv --system-site-packages 你的虚拟环境目录名
  激活虚拟环境后再次执行导入测试即可正常使用。
• 方案2：已有虚拟环境无需重建的适配操作

1. 激活现有虚拟环境
2. 执行命令获取系统gi包路径：
   python3 -c "import gi; print(gi.__path__)"
   通常返回路径为 /usr/lib/python3/dist-packages/gi
3. 将路径写入虚拟环境的pth配置文件，注意替换命令中的Python版本号（Raspbian 10默认Python版本为3.7，可执行python3 -V查看实际版本替换3.x）：
   echo "/usr/lib/python3/dist-packages/gi" > 你的虚拟环境目录/lib/python3.x/site-packages/gi.pth
4. 重启虚拟环境后即可正常导入gi.repository相关模块。

• BLE服务开发可放弃原生BlueZ+gi的底层实现，改用bleak纯Python库，无需依赖gi相关组件，直接通过pip即可安装，API封装度高，实现BLE外设服务的代码量比原生方案减少60%以上。
• GPIO控制直接使用gpiozero库，无需手写底层寄存器操作，点亮/熄灭LED仅需3行核心代码：

from gpiozero import LED
led = LED(17) # 17为对应BCM编码的GPIO引脚号
led.on() # 点亮
# led.off() # 熄灭

• 逻辑层可直接将GPIO操作封装为BLE特征值的读写回调，Flutter端仅需读写对应特征值即可触发树莓派的硬件操作，无需额外开发中间转发层。
• 若必须使用BlueZ原有技术栈，可使用bluez-peripheral封装库，已内置gi相关调用逻辑，无需手动编写GLib底层交互代码，直接调用封装好的类即可快速创建BLE服务。

内容的提问来源于stack exchange，提问作者Antonio Del Cogliano