如何修复ModuleNotFoundError: No module named 'RPi'错误？

问题根源 #

报错说明Python找不到RPi.GPIO模块——这个模块是树莓派专属的GPIO硬件控制工具，出现问题要么是树莓派系统未安装该模块，要么是你在非树莓派系统（比如你的Windows环境）上运行代码。

树莓派系统下的解决步骤 #

如果是在树莓派原生Linux系统上运行：

• 先更新系统包索引：

  sudo apt update
  

• 用系统包管理器安装模块：

  sudo apt install python3-rpi.gpio
  

• 或用pip适配Python3安装：

  pip3 install RPi.GPIO
  

非树莓派系统（如Windows）下的解决步骤 #

RPi.GPIO仅适配树莓派硬件及对应系统，非树莓派环境无法直接使用，可选两种处理方式：

1. 切换到树莓派环境运行：使用树莓派实体机，或在虚拟机/容器中安装Raspbian等树莓派发行版。
2. 用模拟模块测试代码逻辑：若无需实际控制GPIO，仅测试代码结构，可安装fake_rpi模拟模块：
   • 安装命令：

     pip3 install fake_rpi
     

   • 修改代码导入部分：

     from tkinter import *
     from fake_rpi import RPiGPIO
     GPIO = RPiGPIO()
     

   这样既能避免模块找不到的报错，又能模拟GPIO的基础功能。

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