树莓派5运行Python脚本导入board模块报错求助

问题原因 #

树莓派5搭载的BCM2712芯片采用了新的GPIO控制架构，board模块依赖的Adafruit Blinka库需要通过libgpiod来访问GPIO。你的虚拟环境中缺少对应的Python绑定库，因此触发报错。而树莓派3使用传统的sysfs GPIO接口，所以脚本可以正常运行。

解决步骤 #

• 先安装系统级的libgpiod依赖：

  sudo apt update && sudo apt install -y libgpiod2 libgpiod-dev
  

• 激活你的Python虚拟环境：

  source /home/user/test_env/bin/activate
  

• 安装Python版的libgpiod绑定：

  pip install gpiod
  

• 重新执行import board，验证问题是否解决。

额外排查点 #

如果执行后仍报错，可检查：

• 虚拟环境是否正确激活，确保pip命令指向虚拟环境内的Python
• 系统更新是否完成，避免libgpiod版本不兼容问题

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