Thonny编辑器安装Python模块遇报错：ERROR: Can not combine '--user' and '--target'

问题根源 #

Thonny执行pip安装时同时传递了--user和--target参数，这两个参数在pip中互斥，直接触发报错。另外你之前把模块装到了桌面Python的site-packages目录，而Raspberry Pi Pico用的是独立的MicroPython环境，根本识别不到桌面Python的模块。

解决方案 #

1. 修正Thonny的pip安装参数 #

• 打开Thonny，点击顶部菜单栏的工具 > 选项 > 解释器
• 在「包安装」区域的「安装选项」输入框里，检查是否有--user参数，直接删掉它
• 保存设置后，重新通过「Manage packages」安装所需模块

2. 给Pico的MicroPython环境直接装模块 #

• 确保Pico已连电脑，Thonny右下角已切换为「MicroPython (Raspberry Pi Pico)」解释器
• 打开「Manage packages」，搜索适配MicroPython的模块版本：
  • 若用CircuitPython环境，搜adafruit-circuitpython-ssd1306
  • 若用原生MicroPython环境，搜micropython-ssd1306
• 选对应版本安装，Thonny会自动把模块部署到Pico的文件系统里

3. 手动复制模块文件到Pico #

• 下载适配MicroPython的ssd1306.py模块文件
• 在Thonny左侧文件管理器里找到Pico的目录，创建lib文件夹（没有的话新建）
• 把下载的.py文件拖进Pico的lib目录，代码里就能正常导入使用

4. 用pip直接指定Pico目标目录安装 #

如果Pico被识别为电脑U盘盘符（比如E:），打开cmd执行以下命令：

pip install micropython-ssd1306 --target=E:\lib

执行前要确保Pico处于可写状态，且已创建lib目录

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