安装serial与pyserial遇不同报错，求解决方法

算力阿峰

2026-6-26

问题解决思路与步骤

核心问题

你混淆了两个名称相似但完全不同的Python包：

serial：一个无关的第三方包，不包含serial.tools模块，完全不是你需要的。
pyserial：真正实现串口通信功能的包，脚本中import serial和import serial.tools.list_ports依赖的都是它。

解决步骤

清理错误安装的包
先卸载无用的serial包，避免和pyserial冲突：
```
pipenv uninstall serial
```
重新安装正确的pyserial包
彻底卸载并重装pyserial，确保安装的是最新兼容版本：
```
pipenv uninstall pyserial
pipenv install pyserial
```
验证pyserial版本与模块可用性
运行以下命令确认版本及模块是否正常加载：
```
pipenv run python -c "import serial; import serial.tools.list_ports; print('pyserial版本:', serial.__version__)"
```
如果能正常输出版本号，说明模块导入问题已解决。
解决set_buffer_size属性错误
出现这个错误通常有两种原因：
- 版本过低：set_buffer_size方法在pyserial 3.4及以上版本才支持，若输出的版本低于3.4，强制安装指定版本：
```
pipenv install pyserial==3.5
```
- 平台兼容性限制：在M1芯片的macOS上，部分串口设备可能不支持set_buffer_size调用。此时可以修改脚本：
  - 若脚本中调用set_buffer_size是非必需的，直接注释掉该代码行；
  - 若必须调整缓冲区，尝试在初始化Serial对象时传入write_timeout或timeout参数替代，或者使用serial.Serial的buffer_size属性（注意是属性而非方法）。
串口权限验证
确保当前用户有权限访问/dev/cu.usbmodem21401，macOS下可通过添加用户到wheel组解决：
```
sudo dscl . append /Groups/wheel GroupMembership $(whoami)
```
执行后重新登录生效。