Figma Mirror 连不上怎么办：手机真机预览不显示、卡住、图片丢失的排查清单
Figma Mirror 连不上、手机上一直不显示画框、切换画框后卡住或图片不显示？按账号、权限、选中对象、App 版本、网络和浏览器镜像几个方向逐项排查，附 iOS 与安卓的专属处理办法。
搜「figma mirror」的人，十有八九是遇到了这几种情况：手机上的 Mirror 一直显示空白或提示选择画框、桌面端切换画框后手机不跟着变、画面变成一团像素块，或者文字和形状都在、图片却全不见了。这篇文章不重复讲 Mirror 的基础用法（基础步骤见本站的 Figma Mirror 真机预览指南），只讲Figma Mirror 连不上、不显示时怎么一步步排查，按出现频率从高到低排列，照着顺序走一遍，大部分问题都能在几分钟内解决。
先弄清楚：现在的 Mirror 在哪里 #
很多老教程里说的「Figma Mirror」是一个独立 App。现在镜像功能已经并入 Figma 官方移动 App，在 App 底部的 Mirror 标签里。官方帮助中心对系统版本的要求是：
- iOS：iOS 16 或更高版本（iPad 也可用）
- Android：Android 8 或更高版本
- 不支持 iOS 或 Android 的测试版（beta）系统
如果你的手机还装着很早以前下载的旧版应用，或者系统是开发者测试版，先别往下查了，换正式版系统、从 App Store / Google Play 安装最新的 Figma App 再试。设备不满足要求时，可以直接跳到下文的「用手机浏览器镜像」这个备用方案。
第一步：检查三个最常见的原因 #
官方帮助中心列出的排障清单里，最常见的三条其实都不是 bug，而是操作条件没满足。
1. 两端是不是同一个账号 #
Mirror 的连接方式是账号绑定，不是局域网直连。桌面端（客户端或浏览器）和手机 App 必须登录同一个 Figma 账号。很多人电脑上登的是公司邮箱，手机上登的是个人 Google 账号，结果手机永远等不到画面。
处理办法：在手机 App 里点头像确认当前邮箱，和桌面端右上角头像里的邮箱对比。不确定的话，两边都退出登录再重新登录一次，这也是官方建议的做法。
2. 你对这个文件有没有编辑权限 #
官方说明里写得很清楚：从桌面端镜像画框，需要对文件有 can edit 编辑权限。如果别人只给了你查看权限（can view），Mirror 标签不会显示你在桌面上选中的画框。这种情况可以向文件所有者申请编辑权限，或者让对方给你一个原型链接，改用「在手机上打开原型」的方式预览（见下文）。
3. 选中的是不是「顶层画框」 #
Mirror 只认顶层画框（top-level frame），也就是直接放在画布上、不被其他画框或分组包住的 Frame。下面这些情况都会导致手机上没反应：
- 选中的是画框里的某个图层、分组或嵌套画框
- 选中的是一个分组（Group），而不是画框
- 什么都没选，只是打开了文件
处理办法：在桌面端左侧图层面板里，点击最外层的画框名称，确认右侧属性面板显示的是 Frame。不清楚 Frame 和 Group 区别的，可以查本站 术语表。
第二步：画面卡住、不跟着切换 #
典型症状是：手机第一次显示了画框 A，之后在桌面上点画框 B，手机还停在 A。
这个问题在 Figma 官方论坛上被多人反馈过，官方工作人员确认是 Mirror 标签卡在第一个画框不实时更新的问题，并已经推送了修复。修复后官方给出的处理顺序是：
- 强制退出 Figma 手机 App（如果是在手机浏览器里用
figma.com/mirror，就刷新页面） - 重新打开，回到 Mirror 标签
- 在桌面端选择另一个画框，看手机是否自动更新
如果强制退出后仍然卡住，检查手机 App 和桌面客户端是不是都已更新到最新版本。桌面客户端一般在菜单的帮助里检查更新，浏览器版刷新页面即可拿到最新版。客户端下载渠道见 Figma 下载与安装。
第三步：图片不显示、画面变成像素块 #
这类问题和前面不同：连接正常，但渲染内容不对。官方论坛上的典型案例有两种：
- 图片全部消失：文字、形状都正常，只有图片填充不见了，在多个文件、多台手机上都能复现
- 画面变成一团像素块：只在某个特定画框出现，比如把一个带抽屉弹层的画框放进主画框后才变成色块
官方支持人员给出的排查方向可以整理成下面这张表：
| 检查项 | 做法 |
|---|---|
| App 状态 | 强制退出后重开 |
| 版本 | 手机 App 与桌面端都更新到最新，必要时卸载重装 |
| 账号 | 确认两端登录同一账号 |
| 选中对象 | 确认是顶层画框，不是嵌套图层或分组 |
| 画框内容 | 是否用了混合模式、特效或图片填充，换一个简单画框对比测试 |
最后一行很实用：复制一个出问题的画框，逐个删掉图层再镜像，很快就能定位到是哪一层的效果或图片导致渲染异常。如果确认是某类效果在手机上渲染出错，记录下手机型号、系统版本、App 版本（在 App 设置里能看到）和桌面端版本，到 Figma 官方论坛 (opens new window) 或官方支持提交，信息越完整处理越快。
第四步：网络和平台专属问题 #
不需要同一个 Wi-Fi #
官方明确说明，Figma 手机 App 用 Wi-Fi 或蜂窝数据都能工作，两端不需要连同一个 Wi-Fi。所以不必折腾路由器或局域网设置。但两端都必须能正常连上 Figma 的服务，如果桌面端打开文件就很慢、频繁提示重连，手机镜像大概率也会受影响。这时可以先试着把手机从 Wi-Fi 切到蜂窝数据（或反过来），排除单一网络的问题。
安卓：App 一打开就闪退 #
官方给出的处理办法是：
- 在应用商店把 Android System WebView 更新到最新版本
- 重启手机
- 再打开 Figma App
iPhone：开了「锁定模式」 #
如果 iPhone 开启了 锁定模式（Lockdown Mode），用浏览器访问 Figma 时可能报错。按官方说明，需要在系统设置里把 figma.com 加入锁定模式的排除列表，具体步骤参考 Apple 官方文档。
备用方案：用手机浏览器镜像 #
如果 App 实在用不了，或者设备不在支持范围内，官方推荐用浏览器镜像，效果和 App 的 Mirror 标签基本一致：
- 在电脑上用客户端或浏览器打开要预览的文件
- 手机浏览器访问
figma.com/mirror - 用和桌面端相同的账号登录
- 在桌面端选中一个顶层画框，手机浏览器就会显示它
需要注意，浏览器本身的地址栏和工具栏会占掉一部分屏幕，看移动端 App 设计时尺寸感会有偏差，更适合临时检查。
换个思路：直接在手机上看原型 #
如果你的目的是给别人演示或做可用性测试，Mirror 并不是唯一选择。把文件的原型链接分享到手机上，在 Figma App 或手机浏览器里打开，就能全屏点击交互。这种方式不依赖桌面端的实时选中，也不要求查看者有编辑权限，更适合发给同事和客户。如果画框本身就是原型的一部分，用 Mirror 时也可以直接点击跳转到连线的其他画框。
另外，新版移动 App 除了镜像设计画框，还支持镜像代码图层（code layer），可以在手机上试用代码图层里的交互。近期 Figma 的相关更新可以在本站 Figma 中文更新日志 里查看。
排查顺序速览 #
- 系统和 App 版本是否满足要求（iOS 16+ / Android 8+，非测试版系统）
- 两端是否同一账号，必要时退出重登
- 对文件是否有编辑权限
- 桌面端是否选中了顶层画框
- 卡住就强制退出 App 或刷新
figma.com/mirror - 图片或渲染异常就更新版本、拆画框定位问题图层
- 安卓闪退更新 WebView，iPhone 检查锁定模式
- 都不行就改用浏览器镜像或原型链接
更多真机预览与原型相关的中文教程，可以从 Figma 中文指南 开始看；常用操作的快捷键整理在 快捷键速查。
参考来源 #
- View prototypes on a mobile device – Figma Help Center (opens new window)
- Guide to the Figma mobile app – Figma Help Center (opens new window)
- Figma Mirror doesn't display different artboard in the same page – Figma Forum (opens new window)
- Figma Mirror does not display images on mobile devices – Figma Forum (opens new window)
- Mirror Issues, Weird Pixel Blob – Figma Forum (opens new window)