已安装库仍报错：Thonny中CircuitPython无法导入adafruit_ads1x15

算力阿峰

2026-7-19

排查ADS1115 CircuitPython导入错误的原因

检查库的安装路径是否正确
CircuitPython要求第三方库必须放在树莓派Pico的lib文件夹内。打开Thonny的文件管理器，查看Pico设备下的lib目录，确认存在adafruit_bus_device和adafruit_ads1x15两个文件夹。如果通过Thonny安装时误将库装到了本地电脑的Python环境，而非Pico的文件系统，就会出现导入错误。
确认CircuitPython版本与库版本兼容
adafruit-circuitpython-ads1x15库对CircuitPython版本有特定要求，部分新版本库仅支持CircuitPython 7.0及以上版本。可以查看Pico根目录下的boot_out.txt文件获取当前CircuitPython版本，再对照库的版本要求，确保二者匹配。若版本不兼容，可选择升级CircuitPython或安装对应版本的库。
检查库文件结构是否正确
确认lib/adafruit_ads1x15目录下存在ads1115.py和analog_in.py文件。部分情况下下载的库可能存在嵌套文件夹问题（比如解压后路径为lib/adafruit-circuitpython-ads1x15/adafruit_ads1x15），这种结构会导致Python无法找到模块，需将内层的adafruit_ads1x15文件夹直接移动到lib目录下。
确认Thonny的运行目标设备
查看Thonny窗口右下角的解释器选择，确保当前运行目标是CircuitPython (Raspberry Pi Pico)，而非本地电脑的Python环境。若选错目标，脚本会在本地运行，自然无法读取Pico中的库文件。