命令核心功能
fastboot getvar 是 fastboot 工具中的一个核心命令,用于从连接设备的 fastboot 分区中读取变量信息。

(图片来源网络,侵删)
这些变量就像是设备的“身份证信息”或“系统状态报告”,包含了设备型号、固件版本、解锁状态、电池状态等关键数据,这个命令在刷机、解锁、故障排查等场景中非常有用。
基本语法
fastboot getvar <变量名>
<变量名>:你想要查询的特定变量名称。
主要参数(变量名)
getvar 命令的“参数”实际上就是它要查询的变量名,以下是常用且重要的变量名列表:
设备标识与基本信息
| 变量名 | 描述 | 示例输出 |
|---|---|---|
version |
fastboot 协议版本 |
4 |
version-bootloader |
Bootloader(引导加载程序)的版本号 | S1.30.20250323 release-keys |
version-baseband |
基带(调制解调器固件)版本 | M1G30_01.002.00.R |
product |
设备产品型号 | `` |
model |
设备市场型号(通常是最终用户看到的型号) | Pixel 7 Pro |
device |
设备代号 | cheetah |
serialno |
设备的序列号 | XXXXXXXXXXXXXXX |
secure |
Bootloader 的安全状态 | yes 或 no |
状态与标志位
| 变量名 | 描述 | 示例输出 |
|---|---|---|
unlocked |
Bootloader 是否已解锁 | yes 或 no |
unlocked_text |
unlocked 变量的文本描述 |
Device unlocked |
current-slot |
设备当前使用的 A/B 分区(仅支持 A/B 分区的设备) | a 或 b |
has-slot |
检查某个分区是否存在 | yes 或 no (fastboot getvar has-slot system_a) |
is-main-slot |
当前是否为主分区(A/B 分区相关) | yes 或 no |
is-secondary-slot |
当前是否为次要分区(A/B 分区相关) | yes 或 no |
电池与硬件信息
| 变量名 | 描述 | 示例输出 |
|---|---|---|
battery |
当前电池电量百分比 | 45 |
battery-voltage |
当前电池电压(毫伏) | 3725 |
battery-soc |
电池的荷电状态 | 45 |
max-download-size |
通过 fastboot 一次可以下载的最大数据大小(字节) |
134217728 (128MB) |
分区信息
| 变量名 | 描述 | 示例输出 |
|---|---|---|
partition-type |
指定分区的类型(raw, f, unknown) |
fastboot getvar partition-type system -> raw |
partition-size |
指定分区的大小(字节) | fastboot getvar partition-size system -> 1296394240 |
使用示例
示例 1:查询所有支持的变量
如果你想查看设备支持的所有变量,可以使用 all 作为变量名。
fastboot getvar all
输出示例:

(图片来源网络,侵删)
(bootloader) version: 0.4
(bootloader) version-bootloader: S1.30.20250323 release-keys
(bootloader) version-baseband: M1G30_01.002.00.R
(bootloader) product: cheetah
(bootloader) model: Pixel 7 Pro
(bootloader) device: cheetah
(bootloader) serialno: XXXXXXXXXXXXXXX
(bootloader) secure: yes
(bootloader) unlocked: yes
(bootloader) current-slot: a
(bootloader) has-slot: system_a
(bootloader) has-slot: system_b
(bootloader) has-slot: vendor_a
(bootloader) has-slot: vendor_b
(bootloader) has-slot: boot_a
(bootloader) has-slot: boot_b
(bootloader) is-main-slot: yes
(bootloader) is-secondary-slot: no
(bootloader) battery: 78
(bootloader) battery-voltage: 4101
(bootloader) battery-soc: 78
(bootloader) max-download-size: 134217728
(bootloader) partition-type: system
(bootloader) partition-type: vendor
(bootloader) partition-type: boot
(bootloader) partition-size: 1296394240
(bootloader) partition-size: 419430400
(bootloader) partition-size: 100663296
...
Finished. total time: 0.025s
示例 2:查询特定变量
如果你想只查询 Bootloader 版本:
fastboot getvar version-bootloader
输出示例:
(bootloader) version-bootloader: S1.30.20250323 release-keys
Finished. total time: 0.012s
示例 3:检查解锁状态
在刷机前,检查 Bootloader 是否解锁至关重要。
fastboot getvar unlocked
输出示例:

(图片来源网络,侵删)
(bootloader) unlocked: yes
Finished. total time: 0.012s
如果输出是 no,你需要先通过 fastboot oem unlock 命令解锁 Bootloader。
注意事项
- 设备需进入 Fastboot 模式:此命令仅在设备处于 Fastboot 模式下才能执行,通常通过关机后,长按
音量减+电源键进入。 - 需要驱动和
fastboot工具:确保你的电脑已正确安装手机的 USB 驱动,fastboot可执行文件在系统环境变量PATH中,或者你已导航到其所在目录。 - 变量可能因设备而异:不同品牌、不同型号、不同系统的设备,其支持的
getvar变量列表和具体含义可能有所不同。all是查看设备支持列表的最佳方式。 all的输出格式:fastboot getvar all的输出格式在不同设备上可能略有差异,但核心信息是类似的。
fastboot getvar 是一个功能强大且必不可少的工具,通过查询不同的“变量”,你可以快速了解设备的当前状态、硬件信息和软件版本,为后续的刷机、解锁等操作提供关键依据,掌握 fastboot getvar all 和几个核心变量的查询方法,是 Android 高级用户的必备技能。
