麒麟OS WiFi连接需按版本选择正确路径：V10-SP1及以上支持图形界面直连广播WiFi、专用入口连隐藏WiFi；老V10需控制中心新建连接；无桌面环境则用nmcli命令行直连。

您已在麒麟操作系统中插入无线网卡或确认内置网卡已启用，但任务栏网络图标未列出可用WiFi、点击后无信号列表、或输入密码后反复提示“连接失败”，这通常不是系统故障，而是连接路径未走对——麒麟OS对WiFi连接方式做了版本分层，V10-SP1与老V10的操作入口、隐藏网络处理逻辑完全不同。

图形界面直连广播WiFi（最常用）

该方法适用于路由器/手机热点正常广播SSID、在列表中能直接看到名称的场景，无需任何命令行操作。

单击任务栏右下角【网络连接】图标，打开网络面板。

确认【Wi-Fi】开关为蓝色开启状态；若呈灰色，点击一次将其激活——这一步常被忽略，关闭状态下系统不会扫描任何信号。

等待3～5秒，待列表刷新后，单击目标WiFi名称（如“Home-2.4G”或“iPhone热点”）。

若该网络启用了WPA/WPA2加密，会弹出密码框，请严格按大小写、空格、特殊字符输入密码；【密码必须不少于8位，且不能全为数字，否则麒麟OS会静默拒绝认证】。

点击【连接】按钮，系统将执行四次握手并请求DHCP地址；成功后右上角弹出“已连接到 XXXX”，网络图标显示满格信号。

图形界面连隐藏WiFi（V10-SP1及以上专用入口）

当手机设为“仅限已知设备”、路由器关闭SSID广播，或企业AP屏蔽探测帧时，该网络绝不会出现在扫描列表中——此时必须跳过自动发现，强制发起定向关联。

点击网络图标 → 底部选择【加入其他网络】。

在弹出窗口的【网络名称(SSID)】栏，一字不差输入隐藏网络的真实名称（例如“Office-Guest”，注意大小写与连字符）。

【安全性】下拉菜单中必须选与路由器完全一致的类型，90%以上情况是【WPA & WPA2 Personal】；选错会导致认证超时且无错误提示。

在【密钥】栏输入对应密码，再次核对长度是否≥8位；输完直接点【加入】，系统立即发送Probe Request帧，不等待扫描周期。

控制中心新建WiFi连接（老V10/需预设参数场景）

此方法适用于没有“加入其他网络”选项的老V10系统，或需要绑定特定无线网卡接口、设置IPv4手动地址、勾选“自动连接”的进阶需求。

第一步：点击【开始】→【设置】→左侧【网络】→右侧【网络设置】按钮，进入连接管理页。

第二步：点击【增加】→ 选择【Wi-Fi】→ 【新建】。

第三步：在【Wi-Fi】选项卡中，【连接名称】和【SSID】两栏必须填写完全相同的隐藏网络名；【设备】下拉菜单里选中实际工作的无线接口（如wlp6s0，可通过终端执行ip link show | grep wlan确认）。

第四步：切换至【Wi-Fi安全性】选项卡，安全类型选【WPA及WPA2个人】，密码栏输入密钥；【此处不勾选“隐藏网络”选项——老V10版无此勾选项，填对SSID即等效隐藏连接】。

第五步：点击【保存】，返回网络面板，找到刚建的连接名称，单击启用；若仍不连，打开终端执行nmcli connection up "连接名称"手动激活。

命令行直连已知WiFi（无桌面/远程SSH/批量部署）

当你通过SSH登录服务器版麒麟、或图形界面崩溃无法操作时，nmcli是唯一可靠路径，全程5条命令，30秒内完成。

执行nmcli device status，确认无线设备状态为“disconnected”且TYPE为“wifi”，记下IFNAME（如wlan0）。

运行nmcli device wifi rescan强制刷新信号缓存，避免依赖旧扫描结果。

执行nmcli device wifi list查看当前可探测的SSID列表，确认目标网络在其中（如“MyHome”）。

直接发起连接：nmcli device wifi connect "MyHome" password "Abc123456"；该命令会自动创建临时连接配置并激活。

连接后执行nmcli connection show --active，输出中出现该SSID即表示已成功获取IP并上线。