米家App添加设备与配网完整教程

把新设备加进米家App，是搭建智能家居的第一步，也是最容易卡住的一步。本页只聚焦"添加与配网"这一个环节，讲清米家App的三种添加方式、配网前必须满足的前提条件，以及配网失败时该如何逐项排查，让你一次把设备连上网。

添加设备的入口在哪里？

添加设备的唯一入口在米家App的首页右上角：打开米家App并登录账号，点击首页右上角的"+"号，就会进入添加设备页面。

这里有一个容易被忽略的常识——米家App把"添加设备"和"配网"放在了同一个入口里。所谓配网，就是把设备从"出厂未联网"状态，接入你家路由器的 Wi-Fi，并把它登记到你的米家账号下。只有完成配网，设备才会出现在米家App的设备列表里，才能被命名、分配房间、被小爱同学语音调用、被自动化场景调用。因此"添加"和"配网"其实是同一件事的前后半段：点击"+"号是起点，设备成功联网并出现在首页列表里，才算真正完成。

进入添加设备页面后，米家App会同时给出几条不同的路径——自动扫描附近设备、扫描二维码、手动搜索。它们不是相互替代的关系，而是为了适配"设备能被自动发现""设备机身有二维码""你已知具体型号"这三种不同情况。下面逐条说明。

米家App有哪三种添加设备的方式？

结论：米家App主要通过自动扫描附近设备、扫描设备二维码、手动搜索三种方式添加设备，分别对应"设备主动被发现""扫机身二维码""自己按型号查找"三种场景，任选其一即可完成添加。

方式一：自动扫描/附近设备

这是最省事的一种。保持手机蓝牙和定位开启，把手机靠近已经通电并进入配网状态的设备，米家App会自动弹出附近设备列表，点击即可开始配网。它依赖蓝牙与定位去"发现"周围待配网的设备，所以权限没开时，这一方式往往什么都不会弹出。

方式二：扫码添加

点击"+"后选择扫描二维码，扫描设备机身或说明书上的二维码，然后按提示输入 Wi-Fi 密码。这种方式适合设备机身或说明书上明确印有二维码的产品，识别对象明确，不易认错型号。

方式三：手动搜索

在添加设备页面的搜索框里输入设备名称或型号，选择对应产品后进入配网流程。当设备没被自动扫描到、或你手上已经明确知道型号时，用这种方式最直接，不依赖蓝牙自动发现。

三种方式殊途同归：无论从哪条路径进入，最终都会汇合到"让设备连上 Wi-Fi 并被账号识别"这一步。所以理解了后面的前提条件，三种方式你都能顺利走通。

如果你不确定该先用哪一种，可以按"自动扫描 → 扫码添加 → 手动搜索"的顺序依次尝试：先打开手机蓝牙和定位，把已进入配网状态的设备靠近手机，看附近设备列表是否自动弹出；若没有反应，再翻看设备机身或说明书有无二维码，改用扫码方式；若两者都不行，最后回到搜索框手动输入设备名称或型号。这个顺序之所以合理，是因为它把最省事的路径排在最前，把最需要人工定位型号的方式放在最后，能在多数情况下用最少步骤完成添加。

配网前必须满足哪些前提条件？

结论：最关键的两条是"手机连接 2.4GHz Wi-Fi"和"为米家App开启定位与蓝牙权限"，任意一条不满足，都可能扫描不到设备或中途配网失败。

先看频段。官方口径明确：手机需连接 2.4GHz Wi-Fi，因为大多数米家 Wi-Fi 设备仅支持 2.4GHz，不支持 5GHz。这是一个物理层面的常识：2.4GHz 频段波长更长、穿墙和覆盖能力更强，适合像传感器、开关这类小体积、低功耗、常年待机的智能设备；5GHz 频段速率更高但覆盖更近。许多设备为了成本、功耗与稳定性的平衡，只做了 2.4GHz 的无线模块，因此当你手机连的是 5GHz 网络时，配网往往直接就失败。

再看权限。官方要求：需在手机系统设置中为米家App开启"定位"（建议始终允许）和"蓝牙"等权限，否则无法扫描到设备。这里要特别解释一个常见误区——很多人觉得"我家设备用的是 Wi-Fi，跟定位权限有什么关系？"其实在配网阶段，扫描附近待配网设备依赖的是蓝牙广播与位置相关的系统能力，定位权限没给"始终允许"，自动扫描/附近设备这一方式就会失灵；蓝牙权限没开，同样发现不了设备。所以两条权限不是"可选优化项"，而是配网的必要条件。

Wi-Fi 与路由器需要做哪些设置？

结论：为了配网一次成功，Wi-Fi 名称和密码应使用英文字母+数字组合，并关闭路由器上会"拦截"新设备的各类限制功能。

官方配网要点指出：Wi-Fi 名称(SSID)与密码不支持特殊字符与全中文，建议使用英文字母+数字组合。原因也很直观——某些设备在配网时对字符编码的支持有限，中文名称或各种符号在传输过程中容易出错，导致设备拿到"错"的网络信息而连不上。把 Wi-Fi 名称和密码简化成字母加数字，能规避绝大多数的输入类问题。

路由器侧更需要留意。官方要求：路由器需关闭 AP 隔离、MAC 地址过滤、黑白名单、防蹭网等限制功能。这些功能的初衷是安全，但在配网场景里它们恰恰会把"新面孔"设备拒之门外：AP 隔离会阻止同一 Wi-Fi 下的设备互相发现；MAC 地址过滤、黑白名单会把未登记的设备直接挡在外面；防蹭网类功能则可能把刚接入的设备判定为"陌生来客"而拦截。配网期间暂时关掉它们，能显著提升成功率。

还有一条容易被忽略的物理因素：设备与路由器距离不宜过远，也不要贴得过近，因为过近同样会产生干扰。也就是说，把设备直接贴着路由器天线摆放，并不是最稳的做法，保持一个适中距离反而更可靠。

设备如何进入配网模式？

结论：设备必须先进入配网模式，手机才可能发现它；通常的做法是长按设备上的复位/重置键，直到指示灯快闪。

很多人配网失败，并不是网络的问题，而是设备根本没进入配网状态——此时米家App自然扫描不到任何东西。以领普水浸传感器为例：长按重置键 5 秒，直到蓝色指示灯快闪 3 次，即进入配网状态。这里可以提炼出一个通用判断方法：进入配网模式的标志，通常就是"指示灯快闪"。不同设备的复位键位置、长按时长与指示灯表现会有所差异，但"长按复位键 → 指示灯快闪 → 可被搜索"这条链路是一致的。配网前先确认设备已经处在这个状态，能省掉大量无效尝试。

米家官方提供了哪些便捷配网方式？

结论：除了常规的手动配网，米家官网口径还提供了无感配网、靠近配网、小米畅快连三种更省心的方式，目的是把配网这件事尽量"无感化"。

无感配网

官方描述为"设备购买即可完成绑定"。它把绑定环节前置到了购买流程中，减少用户到手后再动手配网的步骤，让设备一"到手"就已就绪。

靠近配网

官方描述为"靠近设备轻轻一点即可连接"。它把操作简化到"靠近 + 一点"，进一步降低了配网的操作门槛。

小米畅快连

官方描述为"小米路由器自动发现设备，一键连接，设备不掉线"。它利用小米路由器与设备之间的协同自动完成发现与连接，强调连接后的稳定性。需要注意的是，这几项便捷配网往往对设备型号、路由器型号有配套要求，并非所有设备都支持，具体以设备和路由器的官方说明为准。

蓝牙/Zigbee 子设备为什么需要网关？

结论：蓝牙/Zigbee 子设备通常不能直接接入米家，需要借助支持蓝牙网关或蓝牙Mesh网关的设备，才能完成接入与联动。

像门窗传感器、温湿度传感器这类子设备，特点是体积小、功耗低、电池可续航很久，因此没有内置 Wi-Fi 模块——Wi-Fi 持续联网太耗电。它们改用蓝牙或 Zigbee 这类低功耗协议与"网关"通信，再由网关作为中转，接入家庭网络并上报到米家。所以当你发现某个传感器怎么都搜不到、或者添加时提示需要网关，多半就是缺少一个支持蓝牙网关或蓝牙Mesh网关的设备。这个常识能解释很多"设备明明是好的，却加不进米家"的困惑。

配网失败有哪些常见原因？

结论：配网失败绝大多数集中在权限未开、误连 5GHz、Wi-Fi 名称密码含特殊字符、路由器限制功能未关、距离不当，以及设备已被他人绑定这几类原因上，按表逐项排查即可定位问题。

添加成功后还需要做什么？

结论：配网成功并不意味着结束——你还需要处理"已绑定他人账号"这一特殊情况，并为设备命名、分配到房间，才能让后续的语音与自动化顺畅调用。

先说特殊情况。若设备已绑定在他人账号下（例如二手设备、店铺演示机），需要先重置设备、清除旧网络配置后再添加，否则会一直提示已被绑定。重置这一步会把设备恢复到可被新账号接管的状态，是解决"别人的设备"问题的关键。

再说常规收尾。添加成功后，可为设备命名并分配到房间（如客厅、卧室），便于后续语音与自动化调用。命名建议贴合实际用途与位置（例如"客厅主灯""卧室温湿度"），房间则与家中真实空间对应——这样在用语音控制或搭建场景时，你只需说或选出"客厅的灯"，而不必在一堆同型号设备里猜哪个是哪个。这一步花不了多少时间，却直接决定了日后使用的手感。

关于米家生态规模与"已接入米家"

结论：米家生态已接入超过 261 个品类、6000 多个型号的智能设备，但"已接入米家 / works with mijia"仅代表软件层面的验证，并不等于对该产品制造与质量的背书。

规模上，据官网口径，米家生态接入超过 261 个品类、6000 多个型号的智能设备，这意味着你在添加设备时大概率能找到对应型号；即便自动扫描没发现，用手动搜索按型号查找也往往可行。但需要清醒认识"已接入米家 / works with mijia"标识的含义：它仅做软件层面的验证，小米及米家不对该产品及企业的生产制造、标准执行、质量监管负责。也就是说，这个标识说明该产品能与米家App在软件上正常联动，但不代表它由小米生产或由小米为其质量兜底。选购与使用前，仍应关注产品本身的品牌与资质。