USB无线网卡在银河麒麟中不显示Wi-Fi列表且设备管理器显示“Unknown Device”，主因是系统识别到USB设备但未加载匹配驱动；需先用lsusb获取芯片ID（如0bda:8179），再依型号选择APT安装firmware-realtek、DKMS编译rtl8812au驱动或手动注入ko模块，并验证ip link是否出现wlan接口。
银河麒麟系统插上USB无线网卡后右下角网络图标里始终不出现Wi-Fi列表，设备管理器显示“Unknown Device”或“USB WLAN Adapter”带黄色感叹号，说明系统虽识别到USB设备但无法自动加载匹配驱动——这类情况多见于标称“免驱”的Realtek RTL8188EU、RTL8192EU、RTL8812AU等芯片网卡，实际需手动注入内核模块补丁才能激活。
确认网卡真实芯片型号
打开终端，执行：
lsusb | grep -i "wireless\|802.11"
重点看输出中冒号前后的十六进制ID，例如 0bda:8179 表示Realtek厂商（0bda）+ 8179型号芯片；0bda:f192 则是RTL8192FU。【必须拿到这组ID才能匹配正确补丁，仅凭网卡外壳写的“免驱版”三个字会装错驱动】
若命令无任何输出，先换插主板后置原生USB接口，前置USB口供电不足会导致设备根本无法枚举。
安装免驱补丁的三种路径
方法一：APT源直接安装通用固件（优先尝试）
执行：
sudo apt update && sudo apt install firmware-realtek wireless-tools
该操作会部署Linux内核已认证的Realtek固件集合，覆盖RTL8188EU/8192EU/8723BU等常见免驱芯片。安装完成后执行：
sudo modprobe -r 8188eu && sudo modprobe 8188eu
注意：如果网卡芯片是RTL8812AU或RTL8821CU，此方法无效，因为内核主线尚未收录其固件，必须走编译路线。
方法二：DKMS方式安装开源补丁（推荐用于8812AU/8192FU）
第一步：安装编译环境
sudo apt install build-essential dkms linux-headers-$(uname -r) bc git -y
第二步：拉取适配麒麟V10 SP3内核的镜像仓库
git clone https://gitcode.com/gh_mirrors/rt/rtl8812au-aircrack-dkms.git && cd rtl8812au-aircrack-dkms
第三步：启用DKMS注册并构建
sudo ./dkms-install.sh
这一步会自动将驱动绑定到当前内核版本，并在后续内核升级时触发重编译。【若执行时报错“no targets”或“Makefile not found”，说明当前目录结构异常，需删除后重新克隆】
方法三：手动注入模块补丁（适用于紧急恢复）
下载预编译的ko模块文件（如8188eu.ko），放入 /lib/modules/$(uname -r)/kernel/drivers/net/wireless/realtek/ 目录；
执行：
sudo depmod -a && sudo modprobe 8188eu
该操作绕过DKMS，不随内核更新自动适配，每次系统升级后需重复执行。仅建议在无法联网、无法运行git命令的离线环境中使用。
验证补丁是否生效
执行：
ip link show | grep wlan
若看到 wlan0 或 wlan1 接口，说明补丁已加载成功；
若仍无输出，立即执行：
dmesg | tail -20 | grep -E "8188|8812|firmware"
重点关注 “Direct firmware load failed” 报错——这表示固件文件缺失，需检查 /lib/firmware/realtek/ 目录下是否存在对应bin文件，例如 rtl8188eufw.bin。缺失则需从linux-firmware项目中单独提取并放入该路径。
