如何在CircuitPython开发板上安装非Adafruit第三方功能库

核心问题说明：是否必须转换为.mpy格式 #

不需要强制转换：

• 纯Python实现的.py格式库文件可以直接放入/lib目录运行，适合开发调试阶段快速验证功能
• .mpy是CircuitPython专用的预编译字节码格式，优势是占用存储空间更小、加载速度更快，对微控制器有限的内存和存储资源更友好，建议正式部署时转换为该格式。

操作步骤 #

方式1：直接使用原生.py文件（无需转换） #

• 对simple-pid库：获取源码中的simple_pid完整文件夹，将整个文件夹复制到开发板的/lib目录下
• 对SH1106显示屏驱动库：获取源码中的sh1106.py文件，直接复制到开发板的/lib目录下
• 引用方式和树莓派环境完全一致，在主脚本开头添加以下代码即可调用：

from simple_pid import PID
import sh1106

方式2：转换为.mpy格式（推荐正式部署用） #

需要使用对应版本的mpy-cross编译工具，注意工具版本必须和你开发板上的CircuitPython版本一致，否则会出现加载报错：

• 单个文件编译：执行命令 mpy-cross xxx.py，运行完成后会在同目录生成同名.mpy文件
• 多文件包编译：像simple-pid这类多文件的库，需要将包内所有.py文件逐个编译为.mpy文件，保留原有的目录结构
• 将编译后的.mpy文件或者文件夹复制到开发板的/lib目录即可，引用方式和.py格式完全一致，无需修改业务代码。

注意事项 #

你提到的两个库均已适配CircuitPython环境，不需要修改源码即可直接运行，如果调用时出现内存不足的报错，优先转换为.mpy格式即可解决。

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