Zola 2026-04-07T00:00:00+00:00 https://orhan.cn/tags/flutter/atom.xml 2026-04-07T00:00:00+00:00 2026-04-07T00:00:00+00:00 menzil https://orhan.cn/posts/flutter-usb-debugging/ <h2 id="wen-ti">问题<a class="anchor" aria-hidden="true" href="#wen-ti" hidden="">#</a> </h2> <p>今天跑 <code>flutter devices</code> 想在真机上调试，结果只看到 macOS、Chrome 和 iPhone，Android 手机完全不见踪影。</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">$</span><span> flutter devices </span><span style="color:#bf616a;">Found</span><span> 3 connected devices: </span><span> </span><span style="color:#bf616a;">macOS</span><span> (desktop) </span><span style="color:#bf616a;">•</span><span> macos • darwin-arm64 </span><span> </span><span style="color:#bf616a;">Mac</span><span> Designed for iPad (desktop) </span><span style="color:#bf616a;">•</span><span> mac-designed-for-ipad • darwin </span><span> </span><span style="color:#bf616a;">Chrome</span><span> (web) </span><span style="color:#bf616a;">•</span><span> chrome • web-javascript </span></code></pre> <p>手机明明插着，开发者模式也开了，就是认不出来。</p> <h2 id="pai-cha-guo-cheng">排查过程<a class="anchor" aria-hidden="true" href="#pai-cha-guo-cheng" hidden="">#</a> </h2> <p>以为是 Android SDK 或者驱动的问题，跑了 <code>flutter doctor</code>，结果：</p> <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>[✓] Android toolchain - develop for Android devices (Android SDK version 36.1.0) </span></code></pre> <p>Android SDK 没问题。<code>adb devices</code> 也是空的。说明问题不在 Flutter 层面，而是 macOS 根本没识别到手机。</p> <h2 id="yuan-yin">原因<a class="anchor" aria-hidden="true" href="#yuan-yin" hidden="">#</a> </h2> <p>最后想起来——<strong>USB 调试没开</strong>。</p> <p>光开"开发者模式"不够，USB 调试是独立的选项，必须单独打开。</p> <h2 id="zheng-que-bu-zou">正确步骤<a class="anchor" aria-hidden="true" href="#zheng-que-bu-zou" hidden="">#</a> </h2> <p>正确顺序是这样的：</p> <ol> <li> <p><strong>打开 USB 调试</strong> 设置 → 开发者选项 → <strong>USB 调试</strong> → 打开</p> </li> <li> <p><strong>插入数据线</strong> 用支持数据传输的线（有些线只能充电）</p> </li> <li> <p><strong>在手机上授权</strong> 连接电脑后，手机会弹出对话框，勾选"始终允许来自此计算机"，点允许</p> </li> <li> <p><strong>（可选）切换 USB 模式</strong> 从通知栏下拉 → USB 选项 → 选择"传输文件（MTP）"</p> </li> </ol> <p>搞定之后再跑 <code>flutter devices</code>，Android 设备就出现了：</p> <pre data-lang="bash" style="background-color:#2b303b;color:#c0c5ce;" class="language-bash "><code class="language-bash" data-lang="bash"><span style="color:#bf616a;">$</span><span> flutter devices </span><span style="color:#bf616a;">Found</span><span> 4 connected devices: </span><span> </span><span style="color:#bf616a;">macOS</span><span> (desktop) </span><span style="color:#bf616a;">•</span><span> macos • darwin-arm64 </span><span> </span><span style="color:#bf616a;">... </span><span> </span><span style="color:#bf616a;">Pixel</span><span> 6a (mobile) </span><span style="color:#bf616a;">•</span><span> android-arm64 • Android 14 </span></code></pre> <h2 id="xiao-jie">小结<a class="anchor" aria-hidden="true" href="#xiao-jie" hidden="">#</a> </h2> <p>这是一个低级错误，但确实值得记录。开发者模式和 USB 调试是两回事，平时用得少真的会忘。下次遇到类似问题，先检查这三点：</p> <ul> <li>USB 调试开了没</li> <li>数据线支不支持数据传输</li> <li>授权弹窗点了没</li> </ul> <hr /> <p>题图：Flutter 调试界面</p>