Ubuntu 使用终端手动连接无线网络（wlan0）完整流程 + 故障排查记录
在某些场景下（如 Ubuntu GUI 网络管理器不可用、使用轻量级桌面环境、或远程配置 Jetson Nano 等嵌入式设备），我们可能需要通过终端命令手动连接无线网络。本文记录一次真实的操作流程和排查过程，供自己和有需要的小伙伴参考。
🛠 环境说明
- 设备：Jetson 或其他带无线网卡的设备
- 系统：Ubuntu（带 NetworkManager）
- 无线网卡名称：wlan0
📜 操作步骤 & 记录
1️⃣ 启动无线网卡接口
sudo ifconfig wlan0 up
验证接口已激活：
ifconfig
输出中应包含 wlan0，状态标志中有 <UP,BROADCAST,MULTICAST>。
2️⃣ 尝试扫描 Wi-Fi
sudo nmcli device wifi rescan
⚠️ 如果遇到错误：
Error: Scanning not allowed while unavailable or activating.
说明网卡可能未被 NetworkManager 正确管理。
3️⃣ 将设备设为 managed 模式
sudo nmcli device set wlan0 managed yes
然后重启 NetworkManager：
sudo systemctl restart NetworkManager
再次尝试扫描：
sudo nmcli device wifi rescan
4️⃣ 查看可用 Wi-Fi 列表
sudo nmcli device wifi list
正常的话应该会显示附近的 Wi-Fi 列表。此时你可以选择连接目标网络。
✅ 网络连通性测试
可以尝试 ping 局域网内其他设备，确认网络已连接：
ping 192.168.1.120
输出如下表示网络通畅：
64 bytes from 192.168.1.120: icmp_seq=1 ttl=64 time=0.3 ms
⚠️ 错误排查日志记录
[警告] GPIO 驱动相关错误
WARNING: CPU: 0 PID: 200 at drivers/gpio/gpiolib.c:3146 gpiod_set_raw_value+0x64/0x70
这通常是驱动相关的问题，与无线连接关系不大。
[错误] USB 网卡驱动 ax88179_178a 报错
ax88179_178a eth1: Failed to write reg index 0x0002: -19
这类报错说明 USB 网卡初始化失败，若你没有使用它，可以忽略；如果你是通过 USB 网卡联网，可能需要重新插拔或更换驱动。
🧩 可能遇到的问题总结
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无法扫描 Wi-Fi | wlan0 没被管理 | nmcli device set wlan0 managed yes |
| 没有 IP 地址 | 未连接网络或 DHCP 未响应 | 使用 nmcli device wifi connect 主动连接 |
| ping 不通 | 网络配置或路由问题 | 检查网关、路由表，或尝试重连 |
| 驱动报错 | 内核模块或 USB 网卡不兼容 | 查看 dmesg、更新驱动或更换设备 |
📌 小结
这次我们通过命令行完成了 Ubuntu 系统下无线网络的开启、扫描、连接，并通过 ping 测试验证了网络通畅，同时记录并分析了可能遇到的系统日志报错。希望这篇笔记能在你下次配置无线连接时帮上忙！