设置 > 关于手机 > 点按 版本号 七次 > 输入你的 PIN 码 （或图案）。你会看到“你已成为开发者”的提示。打开 开发者选项 并开启 USB 调试 或 无线调试 当你需要 adb、Android Studio，或在真机上运行 Capacitor 时。以下步骤在 Android 14、15 和 16 上相同；只是 版本号 路径会因品牌而异（见下表）。
开发者选项的作用（以及局限性）
开发者选项是一个隐藏的设置菜单，专为 App 开发者设计。开启它本身不会产生任何效果，只会显示如下开关：
- USB 调试：允许受信任的电脑运行
adb命令、安装 build 并读取 logs。 - 无线调试：通过 Wi-Fi 进行同样的操作 (Android 11+)。
- 保持唤醒：充电时屏幕保持常亮，测试时很方便。
- 动画缩放：加快或关闭系统动画，对 UI 测试很有用。
- 不保留活动：离开时销毁 Activity，是测试 Capacitor 应用状态恢复的好方法。
- 显示点按操作 / 指针位置：适合录制 Demo 和检查触摸目标。
需要 不会 需要开发者选项才能从浏览器或文件管理器安装 APK、使用大多数应用，或接收 OTA 更新。
按品牌开启开发者选项
| 品牌 | 连续点击 7 次的位置 | 随后菜单出现的位置 |
|---|---|---|
| Google Pixel / 原生 Android | 设置 > 关于手机 > 版本号 | 设置 > 系统 > 开发者选项 |
| 三星 (One UI) | 设置 > 关于手机 > 软件信息 > 版本号 | 设置 > 开发者选项 (列表底部) |
| 小米、Redmi、POCO (HyperOS) | 设置 > 关于手机 > 操作系统版本 | 设置 > 其他设置 > 开发者选项 |
| 小米 (旧版 MIUI) | 设置 > 关于手机 > MIUI 版本 | 设置 > 其他设置 > 开发者选项 |
| 一加 (OxygenOS) | 设置 > 关于设备 > 版本 > 版本号 | 设置 > 系统设置 > 开发者选项 |
| OPPO / realme（ColorOS / realme UI） | 设置 > 关于设备 > 版本 > 版本号 | 设置 > 其他设置 > 开发者选项 |
| 摩托罗拉 | 设置 > 关于手机 > 版本号 | 设置 > 系统 > 开发者选项 |
| 华为 / Honor (EMUI / MagicOS) | 设置 > 关于手机 > 版本号 | 设置 > 系统和更新 > 开发者选项 |
菜单可能会随系统版本变化。如果找不到“版本号”，请打开设置并使用搜索框：输入“版本号”。在几乎所有 Android 设备上，搜索都能直接找到它。
Google Pixel（Android 14、15、16）
- 打开 设置 并滚动到 关于手机.
- 滚动到底部并点击 版本号 点击七次。点几下后，你会看到一个倒计时 Toast。
- 输入您的 PIN 码、图案或密码。
- 返回到 设置 > 系统 > 开发者选项.
三星 Galaxy
- 打开 设置 > 关于手机 > 软件信息.
- 点击 版本号 连续点击七次，并输入您的 PIN 码进行确认。
- 开发者选项 现在会出现在设置主列表的最底部，位于“关于手机”下方。
小米、Redmi 和 POCO
- 打开 设置 > 关于手机.
- 点击 操作系统版本 (HyperOS) 或 MIUI 版本 (旧款设备) 七次。
- 前往 设置 > 其他设置 > 开发者选项.
小米还增加了两个开发时通常需要的额外开关： 通过 USB 安装 以及 USB 调试 (安全设置)。如果不开启“通过 USB 安装”， adb install 会报错： INSTALL_FAILED_USER_RESTRICTED. 开启这些选项可能需要登录小米账号并插入 SIM 卡。
OnePlus、OPPO 和 realme
- 打开 设置 > 关于设备 > 版本.
- 点击 版本号 七次。
- 打开 设置 > 系统设置 > 开发者选项 (OnePlus) 或 设置 > 其他设置 > 开发者选项 (OPPO、realme)。
华为与荣耀
- 打开 设置 > 关于手机.
- 点击 版本号 七次。
- 前往 设置 > 系统和更新 > 开发者选项.
如果 adb 如果通过 USB 无法识别华为设备，请将 USB 连接模式设置为 文件传输 插入设备时。
Build number 缺失或显示“此操作不可用”
在“关于手机”里找错行了。 点击 Android 版本 或 安全补丁级别 无法开启开发者模式。三星设备请使用 软件信息 > Build number。小米设备请使用 操作系统版本 或 MIUI 版本，而不是顶部的通用型号名称。
工作资料或受管设备。 受工作或学校策略管理的手机通常会禁用开发者选项。你可能会看到 此用户无法使用开发者选项 或 此操作不可用 点击版本号时。打开设置 > 账户 并确认当前是 个人 个人资料，而非工作资料。请联系 IT 获取专用测试设备，而不是绕过策略。
访客用户。 切换到你的主用户： 设置 > 系统 > 多用户 （路径可能不同），退出 访客，然后在所有者账号上重复这七次点击。
家长控制和受限配置文件。 Family Link 或受限的次要用户可能会隐藏“版本号”或阻止解锁手势。请使用不受限的所有者账号。
还是卡住了？ 重启设备，安装待处理的系统更新，然后在设置中搜索 版本号 ，再搜一次。如果设备是二手的且仍被锁定，前任所有者或运营商可能还留有企业管控。
开启 USB 调试
- 打开 开发者选项 并开启 USB 调试.
- 使用支持数据传输的 USB 线连接手机（许多廉价线缆仅支持充电）。
- 在手机上，接受 允许 USB 调试吗？ 对话框。勾选 始终允许来自此计算机 在你自己的电脑上。
- 在电脑上，检查连接情况：
adb devices你应该会看到：
List of devices attached
R5CT1234ABC deviceunauthorized 意味着你没有接受该 prompt。 offline 通常意味着数据线或接口有问题，或者 adb 来自旧版 SDK 的服务器。
adb 随 Android SDK Platform-Tools 一起提供。如果已安装 Android Studio，它位于 ~/Library/Android/sdk/platform-tools 在 macOS 上或 %LOCALAPPDATA%\Android\Sdk\platform-tools 在 Windows 上。将该文件夹添加到你的 PATH。刚接触 Android 工具链？我们的 Capacitor 应用的 Android 配置 有详细介绍。
开启无线调试（Android 11 及更高版本）
无线调试可以摆脱数据线。你的电脑和手机必须连接同一个 Wi-Fi 网络，部分公司或酒店网络会拦截设备间流量。
- 在 开发者选项，并开启 无线调试 并接受网络提示。
- 点击 无线调试 来打开它，然后 使用配对码 code 配对设备。请保持此屏幕打开。
- 在电脑上，使用配对对话框中显示的 IP 地址和端口进行配对：
adb pair 192.168.1.42:37145
# Enter pairing code: 482913- 使用无线调试主界面显示的 IP 和端口连接（端口与配对端口不同）：
adb connect 192.168.1.42:41827
adb devicesAndroid Studio 也提供 通过 Wi-Fi 配对设备 在设备管理器中，它会显示一个 QR code，从无线调试界面扫描即可。
每次无线调试重启，端口都会变，所以你需要重复 adb connect 重启后也一样。配对本身会被记住。
在 Android 10 及更早版本上，请使用旧方法：先通过 USB 连接一次，运行 adb tcpip 5555，拔掉线缆，然后 adb connect <phone-ip>:5555.
在设备上运行你的 Capacitor 应用
当设备出现在 adb devices列表中时，Capacitor CLI 可以直接 build 和 install：
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC为了更快迭代，请使用 live reload，让应用通过网络加载你的开发服务器：
bunx cap run android -l --external手机需要能访问你电脑的 IP，此功能才能生效。
要在应用运行时查看 native logs：
adb logcat | grep -i -E "capacitor|chromium"要调试 WebView，请打开 chrome://inspect 在 debug build 运行时，在桌面版 Chrome 中打开。Capacitor 应用的 debug build 默认启用 WebView 调试。
故障排除
连续点击版本号没有反应。 可能是你点错了字段（例如点了 Android 版本而不是版本号），或者设备由组织管理。部分小米设备需要点击“OS 版本”而不是“版本号”。
设备未出现在 adb devices.
adb kill-server
adb start-server
adb devices然后换一根数据线，直接插到电脑上的端口，不要用集线器。将 USB 模式通知切换为 文件传输.
Windows 无法识别手机。 请安装 OEM USB 驱动（三星、小米等厂商提供自有驱动），或从 SDK Manager 安装适用于 Pixel 设备的 Google USB Driver。
INSTALL_FAILED_UPDATE_INCOMPATIBLE. 已安装的应用是用不同密钥签名的（例如 Play Store 版本与你的 debug build 不同）。请先卸载它： adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED 在小米设备上。 启用 通过 USB 安装 在开发者选项中。
无线调试总是自动关闭。 切换 Wi-Fi 网络时，Android 会把它关掉。部分省电模式也会这样。长时间调试时，请让手机保持在同一网络并充电。
更新 Android Studio 后提示未授权。 adb key 在 ~/.android/adbkey 中已发生变化。请在开发者选项中点击 撤销 USB 调试授权，重新连接并再次接受 prompt。
如何关闭开发者选项
- 打开 开发者选项.
- 切换 使用开发者选项 (或 开发者选项 （在三星设备上）将顶部的开关关闭。
在某些设备上，该菜单可能仍然可见；即使开发者选项已关闭，各个开关也可能保留上次的值。要完全隐藏该菜单，请前往 设置 > 应用 > 设置 > 存储 并清除“设置”应用的存储空间。这也会重置其他设置偏好，因此通常不值得这么做。
在将测试机交给他人之前，还请点击 撤销 USB 调试授权 这样旧电脑就无法再连接了。
安全注意事项
- USB 调试允许授权计算机安装应用，并从可调试的 build 中读取应用数据。请勿在公共充电站或你不信任的计算机上接受 RSA 提示。
- 某些银行和支付应用在开启开发者选项或 USB 调试时会拒绝运行。使用完毕后，请在个人手机上将其关闭。
- 切勿发布带有以下内容的 release build：
android:debuggable="true". Capacitor release build 默认不可调试。
常见问题
没有 Build number 时，如何启用开发者选项？
每部 Android 手机都有 Build number，但部分品牌会重命名或移动其位置。在三星手机上，进入“设置” > “关于手机” > “软件信息”，然后连续点击“Build number”七次。在小米 HyperOS 上，点击“OS 版本”；在旧版 MIUI 上，点击“MIUI 版本”。如果仍找不到，请在设置搜索栏中输入“build number”。参见 找不到 Build number 适用于工作资料和受限用户。
在 Android 14 或 15 上需要连续点击几次版本号？
在……上连续七次 版本号 (或 操作系统版本 / MIUI 版本 （在小米手机上）。点击三四次后，Android 通常会显示倒计时提示。出现提示时输入设备的 PIN 码、图案或密码，然后 开发者选项 从设置中打开。
三星手机上的版本号在哪里？
设置 > 关于手机 > 软件信息 > 版本号。连续点击七次，确认 PIN 码，然后 开发者选项 在主设置列表底部找到。
如何配对无线调试？
开启 无线调试 在开发者选项中打开它，然后选择 使用配对码 code 配对设备。在电脑上运行 adb pair <ip>:<pairing-port>，输入六位数的 code，然后 adb connect <ip>:<debug-port> 使用无线调试主界面显示的地址（不是配对端口）。
我可以在工作手机上开启开发者选项吗？
通常需要 IT 部门批准。受管设备会阻止连续点按“版本号”的手势，或显示 此操作不可用。请使用个人手机或专用测试机进行 adb 以及 USB 调试。
