Ubuntu系统下Eric6 IDE运行串口代码提示No module named 'serial'报错问题

Eric6 导入serial模块报错解决方案 #

出现该问题的核心原因是Eric6绑定的Python解释器和终端执行python3命令用到的解释器不属于同一个环境，系统层面安装的pyserial包仅对终端对应的解释器生效。解决步骤如下：

• 终端执行 which python3 命令，复制输出的Python3解释器绝对路径
• 打开Eric6，依次进入 设置 -> 首选项 -> Python -> 解释器 配置页
• 在Python3解释器选择栏，粘贴刚才复制的路径，或者在下拉列表中选中对应路径的解释器，不要使用Eric6默认绑定的嵌入式解释器
• 保存配置后重启Eric6，重新运行代码即可解决模块找不到的问题

如果是在虚拟环境中安装的pyserial，上述步骤中选择解释器时需要选中虚拟环境目录下bin/python3的路径即可。

终端运行无报错但无串口列表输出解决方案 #

Ubuntu默认限制普通用户对串口设备的访问权限，没有权限的情况下扫描串口会返回空列表，不会抛出报错。解决步骤如下：

• 先确认串口扫描代码逻辑正确，标准实现参考：

import serial.tools.list_ports

port_list = serial.tools.list_ports.comports()
for port in port_list:
    print(f"串口设备：{port.device}, 描述：{port.description}")

• 执行命令将当前用户加入串口设备所属的dialout用户组：sudo usermod -aG dialout $USER
• 执行完上述命令后，注销当前系统用户重新登录，或者直接重启设备，权限配置即可生效
• 重新运行代码即可返回识别到的串口设备列表

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