避坑指南在Ubuntu 22.04上为CH341模块手动编译安装驱动解决usbserial缺失问题当你兴奋地连接CH341 USB转串口模块到Ubuntu 22.04系统准备开始硬件开发时却发现设备列表中空空如也——这种场景对物联网开发者和硬件爱好者来说再熟悉不过了。本文将带你深入排查问题根源并提供两种经过验证的解决方案从内核模块动态加载到源码编译安装确保你的CH341模块重获新生。1. 问题诊断与原因分析首先确认你的CH341模块是否被系统识别。在终端执行lsusb | grep CH341正常情况应显示类似输出Bus 001 Device 004: ID 1a86:7523 QinHeng Electronics CH341 serial converter如果设备未被识别检查物理连接如果已识别但未创建/dev/ttyUSB*设备节点继续执行dmesg | grep ch341典型错误可能包括usbserial: Unknown symbol usb_serial_generic_register (err -2)ch341: module verification failed: signature and/or required key missingusbserial: module is from the staging directory, the quality is unknown根本原因通常有三类内核模块未自动加载常见于较新内核版本预装驱动版本不兼容特别是LTS系统的长期维护内核安全启动导致模块签名验证失败提示Ubuntu 22.04默认启用的安全启动会阻止未签名模块加载可通过mokutil --sb-state检查状态临时解决方案是进入BIOS禁用安全启动或手动签名模块。2. 解决方案一动态加载内核模块对于大多数用户这是最快捷的解决方法。依次执行以下命令sudo modprobe usbserial sudo modprobe ch341验证模块是否加载成功lsmod | grep -E usbserial|ch341为确保重启后自动加载创建配置文件echo -e usbserial\nch341 | sudo tee /etc/modules-load.d/ch341.conf常见问题排查表现象可能原因解决方案modprobe: FATAL: Module usbserial not found模块未编译进内核安装linux-modules-extra-$(uname -r)Operation not permitted安全启动限制禁用安全启动或签名模块dmesg显示权限错误用户组权限不足将用户加入dialout组sudo usermod -aG dialout $USER3. 解决方案二手动编译安装最新驱动当动态加载无效时需要从源码编译安装。以下是详细步骤3.1 准备编译环境安装必备工具链sudo apt update sudo apt install build-essential git linux-headers-$(uname -r)3.2 获取驱动源码官方维护的驱动源码位于git clone https://github.com/juliagoda/CH341SER.git cd CH341SER3.3 编译与安装执行编译make遇到常见错误及解决方法错误1/lib/modules/5.15.0-xx-generic/build: No such file解决sudo apt install linux-headers-$(uname -r)错误2implicit declaration of function ‘usb_serial_generic_register’解决修改ch341.c在#include linux/usb/serial.h后添加#include linux/usb/serial_generic.h编译成功后安装sudo make install sudo depmod -a3.4 验证与测试重新加载模块sudo modprobe -r ch341 sudo modprobe ch341检查设备节点ls /dev/ttyUSB*4. 高级配置与优化4.1 固定设备节点名称为防止设备号随插拔变化创建UDEV规则echo SUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, SYMLINKttyCH341 | sudo tee /etc/udev/rules.d/99-ch341.rules重新加载规则sudo udevadm control --reload-rules sudo udevadm trigger4.2 性能参数调整优化串口通信参数stty -F /dev/ttyUSB0 115200 cs8 -parenb -cstopb常用参数组合场景波特率数据位校验停止位Arduino1152008无1工业设备96007偶1GPS模块48008无14.3 内核编译选项可选对于需要自定义内核的用户确保配置中包含CONFIG_USB_SERIALy CONFIG_USB_SERIAL_CH341y CONFIG_USB_SERIAL_GENERICy检查当前配置zcat /proc/config.gz | grep -E USB_SERIAL|CH3415. 跨平台解决方案参考虽然本文聚焦Ubuntu但其他系统的解决方法也值得了解Windows直接安装官方驱动[CH341SER.EXE]树莓派需禁用蓝牙占用串口sudo raspi-configMacOS使用WCH官方驱动在最近的一个智能家居网关项目中我们遇到批量设备突然失联的情况。最终发现是Ubuntu自动更新后内核模块兼容性问题通过锁定驱动版本sudo apt-mark hold linux-modules-extra-$(uname -r)解决了稳定性问题。
避坑指南：在Ubuntu 22.04上为CH341模块手动编译安装驱动（解决`usbserial`缺失问题）
发布时间：2026/5/21 19:34:58
避坑指南在Ubuntu 22.04上为CH341模块手动编译安装驱动解决usbserial缺失问题当你兴奋地连接CH341 USB转串口模块到Ubuntu 22.04系统准备开始硬件开发时却发现设备列表中空空如也——这种场景对物联网开发者和硬件爱好者来说再熟悉不过了。本文将带你深入排查问题根源并提供两种经过验证的解决方案从内核模块动态加载到源码编译安装确保你的CH341模块重获新生。1. 问题诊断与原因分析首先确认你的CH341模块是否被系统识别。在终端执行lsusb | grep CH341正常情况应显示类似输出Bus 001 Device 004: ID 1a86:7523 QinHeng Electronics CH341 serial converter如果设备未被识别检查物理连接如果已识别但未创建/dev/ttyUSB*设备节点继续执行dmesg | grep ch341典型错误可能包括usbserial: Unknown symbol usb_serial_generic_register (err -2)ch341: module verification failed: signature and/or required key missingusbserial: module is from the staging directory, the quality is unknown根本原因通常有三类内核模块未自动加载常见于较新内核版本预装驱动版本不兼容特别是LTS系统的长期维护内核安全启动导致模块签名验证失败提示Ubuntu 22.04默认启用的安全启动会阻止未签名模块加载可通过mokutil --sb-state检查状态临时解决方案是进入BIOS禁用安全启动或手动签名模块。2. 解决方案一动态加载内核模块对于大多数用户这是最快捷的解决方法。依次执行以下命令sudo modprobe usbserial sudo modprobe ch341验证模块是否加载成功lsmod | grep -E usbserial|ch341为确保重启后自动加载创建配置文件echo -e usbserial\nch341 | sudo tee /etc/modules-load.d/ch341.conf常见问题排查表现象可能原因解决方案modprobe: FATAL: Module usbserial not found模块未编译进内核安装linux-modules-extra-$(uname -r)Operation not permitted安全启动限制禁用安全启动或签名模块dmesg显示权限错误用户组权限不足将用户加入dialout组sudo usermod -aG dialout $USER3. 解决方案二手动编译安装最新驱动当动态加载无效时需要从源码编译安装。以下是详细步骤3.1 准备编译环境安装必备工具链sudo apt update sudo apt install build-essential git linux-headers-$(uname -r)3.2 获取驱动源码官方维护的驱动源码位于git clone https://github.com/juliagoda/CH341SER.git cd CH341SER3.3 编译与安装执行编译make遇到常见错误及解决方法错误1/lib/modules/5.15.0-xx-generic/build: No such file解决sudo apt install linux-headers-$(uname -r)错误2implicit declaration of function ‘usb_serial_generic_register’解决修改ch341.c在#include linux/usb/serial.h后添加#include linux/usb/serial_generic.h编译成功后安装sudo make install sudo depmod -a3.4 验证与测试重新加载模块sudo modprobe -r ch341 sudo modprobe ch341检查设备节点ls /dev/ttyUSB*4. 高级配置与优化4.1 固定设备节点名称为防止设备号随插拔变化创建UDEV规则echo SUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, SYMLINKttyCH341 | sudo tee /etc/udev/rules.d/99-ch341.rules重新加载规则sudo udevadm control --reload-rules sudo udevadm trigger4.2 性能参数调整优化串口通信参数stty -F /dev/ttyUSB0 115200 cs8 -parenb -cstopb常用参数组合场景波特率数据位校验停止位Arduino1152008无1工业设备96007偶1GPS模块48008无14.3 内核编译选项可选对于需要自定义内核的用户确保配置中包含CONFIG_USB_SERIALy CONFIG_USB_SERIAL_CH341y CONFIG_USB_SERIAL_GENERICy检查当前配置zcat /proc/config.gz | grep -E USB_SERIAL|CH3415. 跨平台解决方案参考虽然本文聚焦Ubuntu但其他系统的解决方法也值得了解Windows直接安装官方驱动[CH341SER.EXE]树莓派需禁用蓝牙占用串口sudo raspi-configMacOS使用WCH官方驱动在最近的一个智能家居网关项目中我们遇到批量设备突然失联的情况。最终发现是Ubuntu自动更新后内核模块兼容性问题通过锁定驱动版本sudo apt-mark hold linux-modules-extra-$(uname -r)解决了稳定性问题。
