1. 板子里的代码怎么完整落到本地:adb pull 的适用场景
调板子上的程序时,最怕的不是编译报错,而是源码只留在设备里:改完一版、跑通了,回头想把整个工程目录拷回电脑归档,用文件管理器拖拽经常漏掉隐藏文件,目录层级一深还容易断。adb 这个命令行工具就是干这个的,而 adb pull 是其中专门负责“从设备往本地拉”的子命令。它不需要板子额外装应用,只要调试通道通,一条命令就能把设备上的目录按原结构复制到本地。适合手里有调试权限的板子、需要批量导出工程或日志的开发者,也适合想把导出动作脚本化的人。真正容易翻车的不是命令本身,而是前面的设备识别和路径确认。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. adb 调试通道先打通:设备识别与路径确认
adb pull 能不能跑起来,取决于主机和板子之间的桥有没有通。很多人一上来就敲 pull,报错了才回头查 USB,这是最浪费时间的顺序。比较稳的做法是先把“设备可见”和“源路径存在”这两件事确认掉,再谈传输。
2.1 adb 是什么,pull 在整条链路里的位置
adb 全称 Android Debug Bridge,是主机和 Android 设备之间的一条调试桥。它大致由三部分组成:主机上的 adb 客户端、主机上后台运行的服务端、以及设备上的 adbd 守护进程。终端里敲的每一条 adb 命令,先由客户端把请求交给服务端,服务端再通过 USB 或网络通道和板子上的 adbd 通信。adb pull 属于文件传输类子命令,方向是从设备到主机;反方向是 adb push。
把方向搞清楚很关键。下面这张表是我自己在用的一组常用子命令,放在一起看更容易理解 pull 的位置:
| 子命令 | 方向 | 典型用途 |
|---|---|---|
adb devices |
查询 | 列出当前已连接设备及其状态 |
adb shell |
主机到设备 | 在设备上执行命令,比如看目录 |
adb push |
主机到设备 | 把本地文件推到设备 |
adb pull |
设备到主机 | 把设备文件或目录拉到本地 |
从表里能看出来,adb push 和 adb pull 是镜像关系,参数顺序也一致:第一个位置参数是源,第二个位置参数是目标。只是 pull 的源在板子上、目标在本地,push 反过来。很多“拉不下来”的问题,根子不在 pull 这一层,而在 adb devices 那一步设备状态就不对。
提示:如果板子同时连着多台设备,后面所有命令都可以加
-s 序列号来指定目标,例如adb -s 0123456789ABCDEF pull ...,避免命令打到别的设备上。
2.2 让电脑认出板子:adb devices 的三种返回
先执行最简单的设备查询:
bash复制# 列出当前连接的设备,确认板子被识别
adb devices
正常输出类似下面这样:
text复制List of devices attached
0123456789ABCDEF device
这里第二列的状态决定了能不能继续往下走。常见状态有三种:
device:通道正常,可以执行 pull、shell 等命令。unauthorized:设备已经连上,但主机没有拿到授权,pull 会被拒绝。offline:设备在列表里,但 adbd 没有正常响应,传输会卡住或直接失败。
如果列表是空的,说明连“识别”这一步都没过。先排查 USB 线是不是只供电不传数据、板子上的开发者选项和 USB 调试有没有打开、主机的设备驱动有没有装好。状态是 unauthorized 时,看板子屏幕有没有弹出 RSA 授权框,勾选“始终允许”再确认;如果没有弹窗,可以在开发者选项里撤销 USB 调试授权,重新插拔再试。状态是 offline 时,先重启 adb 服务:
bash复制# 重启 adb 服务端,清掉可能卡死的旧连接
adb kill-server
adb start-server
adb devices
这三条命令不改变板子上的任何文件,只是把主机侧的服务端重新拉起来,是排查连接问题的常规动作。做完之后再回到 adb devices,确认状态回到 device。
2.3 先在板子上确认源路径存在
adb pull 的第一个参数是设备上的源路径。这个路径必须是板子上的绝对路径,写错层级、大小写不对,都会在传输开始前就报 remote object does not exist。与其猜,不如先用 adb shell 看一眼。下面用 /sdcard/project 作为设备端工程目录的示例路径,实际换成你自己的绝对路径:
bash复制# 在设备上列出目标目录的内容,确认路径存在且有读权限
adb shell ls -l /sdcard/project
-l 会列出权限、大小和名称,能顺便看出当前 shell 用户有没有读权限。如果这里就报 Permission denied,后面 pull 必然也拉不动,先解决权限比反复试 pull 有效得多。如果提示目录不存在,就逐级往上退,比如先 adb shell ls /sdcard,再定位到实际目录名。路径里带空格或特殊字符时,在 adb shell 里加引号,避免被主机 shell 提前拆开。
这一步还有一个容易被忽略的价值:确认你要拉的是“目录”还是“目录里的内容”。adb shell ls /sdcard/project 看到的是目录下的文件,而 pull 的源写 /sdcard/project 拉的是整个目录;源写 /sdcard/project/ 末尾带斜杠时,不同版本行为可能不一致。我一般统一不带尾斜杠,源和目标都写完整名称,行为最可预期。
3. 把 adb pull 用对:源路径、目标路径与执行细节
设备状态正常、源路径也确认存在之后,pull 本身只有两个位置参数要填。但这两个参数的写法直接决定文件落在哪里、目录结构保不保留,值得单独拆开看。
3.1 命令骨架与两个位置参数
adb pull 的基本形式是:
bash复制# 语法骨架:第一个参数是设备上的绝对路径,第二个参数是本地的目标路径
adb pull [板子上的文件夹的绝对路径] [本地上的文件夹的绝对路径]
换成具体示例:
bash复制# 把设备上的 /sdcard/project 整个目录拉到本地 ./backup/project
adb pull /sdcard/project ./backup/project
第一个参数 /sdcard/project 是源,必须写设备上的绝对路径,不能写主机上的相对路径,也不能写 ~ 这类只在主机 shell 里有意义的写法。第二个参数 ./backup/project 是目标,可以是相对路径,相对的是你当前终端所在目录。执行时 adb 会递归复制源目录下的所有文件和子目录,目录层级保留。
如果第二个参数省略,只写 adb pull /sdcard/project,文件会拉到当前目录下。这个写法看着省事,实际很容易把工程散落在终端当前目录里,尤其是终端刚好开在桌面或用户主目录时,事后清理很麻烦。我一般强制自己把目标路径写全,哪怕只是多敲几个字符。
第二个参数还有一层语义需要说清楚:adb 把它当作“目标目录”处理。当目标路径已经存在且是目录时,源目录会被放到这个目标目录下面;当目标路径不存在时,adb 会按你给的名字创建它。这个差异会在第 4 章展开,先记住结论:目标写全路径,执行前先建好父目录。
3.2 路径写法:绝对路径、空格与中文目录
源路径必须绝对,这一点没有例外。目标路径可以是相对,也可以是绝对,但建议和源路径一样写清楚,避免依赖终端当前目录。路径里出现空格时,不管源还是目标,都要用引号包起来:
bash复制# 源路径和目标路径都带空格时,分别加引号
adb pull "/sdcard/project space/app" "./backup/app"
不加引号时,shell 会把空格当成参数分隔符,adb pull 收到的参数数量就变了,报错信息往往指向“多余的参数”,而不是空格本身,排查时容易绕远。
中文目录是另一个值得提前规避的点。设备端的目录名可能是中文,pull 到本地后在某些终端编码下会显示成乱码,后续脚本处理也麻烦。比较稳的习惯是:设备端源路径保持原样,本地目标路径用英文和数字命名,比如把设备上的 项目备份 拉到本地的 ./backup/project。这样既不影响拉取,也避免后续路径处理踩坑。
还有一类路径是符号链接。/sdcard 在很多设备上本身就是一个指向实际存储的链接,pull 时按你写的路径走通常没问题,但如果源路径中间某一级是链接,建议先用 adb shell ls -l 看清它指向哪里,再决定是拉链接路径还是真实路径。这个细节不常遇到,一旦遇到就是“明明 ls 能看到,pull 却说找不到”的典型来源。
3.3 执行后的验证:文件数、目录结构与大小
pull 执行完,终端会逐条打印被复制的文件路径,最后给出一个传输统计。但终端输出滚得快,不能只看“命令没报错”就认为拉全了。我习惯做两层验证:先比文件数,再看关键文件。
文件数对比可以分别在设备端和本地统计。设备端用 adb shell 执行 find:
bash复制# 统计设备端源目录下的普通文件数量
adb shell find /sdcard/project -type f | wc -l
本地在目标目录下执行同样的统计:
bash复制# 统计本地目标目录下的普通文件数量
find ./backup/project -type f | wc -l
两个数字一致,基本可以认为没有漏文件。需要说明的是,find 和 wc 依赖设备系统里的 toybox 工具集,绝大多数 Android 设备都带,但极少数精简系统可能没有。如果设备端执行 find 报“not found”,可以退回 adb shell ls -R /sdcard/project 粗略看目录结构,或者直接在本地用文件管理器核对顶层目录。
关键文件验证更直接:挑几个你确定存在的源文件,比如主程序文件、配置文件,在本地用 ls -l 看大小是否非零。空文件是传输中断的典型残留,尤其是大工程拉到一半磁盘满或连接断开时,会留下 0 字节文件,光看目录结构发现不了。
bash复制# 检查本地关键文件是否存在且大小正常
ls -l ./backup/project/main.c ./backup/project/config.ini
如果条件允许,还可以对单个关键文件做一次校验和对比,设备端用 adb shell md5sum,本地用 md5sum,两边一致说明内容没有在传输中被截断。这个动作在拉取大文件时尤其值得做,比逐个打开看要快。
4. adb pull 避坑排查:五类现场与对应处理
pull 报错的信息不算多,但每一条背后对应的原因差别很大。下面这五类是我在实际导出里反复遇到的,按“现象 → 原因 → 解决”整理,遇到时可以直接对号入座。
4.1 设备没连上:no devices、offline、unauthorized
现象一:执行 adb pull 直接报 error: no devices/emulators found,adb devices 列表为空。
原因:adb 服务端根本没有识别到设备。常见来源是 USB 线只供电不传数据、板子上的 USB 调试没打开、主机驱动没装好,或者 adb 服务端本身卡死。
解决:先换一根确定能传数据的线,再确认板子开发者选项里的 USB 调试处于打开状态。然后重启服务端并重新查询:
bash复制# 重启服务端后重新确认设备状态
adb kill-server
adb start-server
adb devices
如果仍然为空,换一个 USB 口,避开前置面板或扩展坞,直接插主机后置口再试。
现象二:adb devices 能看到设备,但状态是 unauthorized,pull 报 device unauthorized。
原因:主机和设备之间没有完成 RSA 授权。第一次连接时板子会弹授权框,没点确认或者点了拒绝,就会停在这个状态。
解决:看板子屏幕有没有授权弹窗,勾选“始终允许”再确认。没有弹窗时,在开发者选项里撤销 USB 调试授权,拔插数据线重新触发。授权完成后 adb devices 的状态会变成 device。
现象三:设备状态是 offline,pull 卡住不返回或报连接错误。
原因:adbd 进程异常,或者 USB 连接不稳定。和 unauthorized 不同,offline 说明设备在列表里但通道没有真正建立。
解决:先重启 adb 服务端,再拔插数据线;仍然 offline 就重启板子。如果是通过网络连接的设备,检查网络是否中断。
4.2 路径与权限:does not exist、Permission denied
现象四:adb: error: remote object '...' does not exist,但你觉得路径明明是对的。
原因:源路径写错层级、大小写不匹配、用了主机上的相对路径,或者路径里的通配符被主机 shell 提前展开成了别的名字。还有一个隐蔽来源是路径中间某一级是符号链接,实际指向和显示名称不一致。
解决:退回到 adb shell ls -l 逐级确认,从根目录开始一段一段往下看,确保每一级都存在。源路径统一写设备上的绝对路径,带空格或特殊字符时加引号。怀疑是链接时,用 ls -l 看箭头指向,改用真实路径再 pull。
现象五:adb: error: failed to copy ... : remote Permission denied,目录能列出来,但拉到一半被拒绝。
原因:源目录对当前 adb shell 用户不可读。/sdcard 下的普通目录一般可读,但系统保护目录、应用私有目录通常不行。能 ls 看到目录名,不代表能读目录里的内容。
解决:优先把要导出的工程放到 /sdcard 下的可读目录再拉。如果确实需要读系统保护目录,常规做法是在调试版系统上切到 root 再执行,普通量产设备上这条路走不通,不要在这上面耗时间。判断方法很简单:adb shell ls 能列出文件名但 adb pull 报 Permission denied,基本就是读权限问题。
4.3 本地目标:目录不存在、覆盖与磁盘空间
现象六:adb pull /sdcard/project ./backup 执行完,文件散落在 ./backup 下,而不是你以为的 ./backup/project 下。
原因:adb 把第二个参数当作目标目录。目标 ./backup 不存在时,它按这个名字创建,然后把源目录的内容放进去;目标已存在且是目录时,源目录会被放到该目录下面,变成 ./backup/project。同一个命令,目标目录存不存在,结果不一样,这是最容易翻车的地方。
解决:目标路径写全,并且执行前先建好父目录:
bash复制# 先建好本地父目录,再把源目录完整拉到指定名称下
mkdir -p ./backup
adb pull /sdcard/project ./backup/project
这样无论 ./backup 原来存不存在,结果都落在 ./backup/project。如果目标目录里已有同名旧文件,pull 会覆盖同名文件但不会删除旧目录里多出来的文件,想得到干净副本就先清空目标再拉。
现象七:pull 中途中断,本地目录里出现 0 字节文件。
原因:本地磁盘空间不足,或者传输过程中 USB 连接断开。adb 不会在中断后自动回滚已经复制的部分文件。
解决:拉取前先看本地剩余空间,大工程按子目录分批拉,比如先拉源码目录、再拉资源目录。中断后不要直接在原目标上重拉,先删掉这次产生的残缺目录,再重新执行,避免新旧文件混在一起掩盖问题。
5. 把导出做成固定动作:批量拉取与校验的小习惯
单次 adb pull 谁都会敲,真正省时间的是把它固化成一条可重复的流程,尤其是需要反复导出、或者同时连着多台板子的时候。我后来把常用动作收进一个小脚本,参数只留序列号和源路径,其余全部写死,减少手滑空间:
bash复制#!/usr/bin/env bash
set -euo pipefail
# 第一个参数是设备序列号,第二个参数是设备上的源目录
SERIAL="$1"
SRC="${2:-/sdcard/project}"
DST="./backup/project"
# 先确认设备在线,状态不是 device 就直接退出
STATE="$(adb -s "$SERIAL" get-state 2>/dev/null || true)"
if [ "$STATE" != "device" ]; then
echo "设备状态异常: $STATE"
exit 1
fi
# 预建父目录,目标写全,避免落到意外位置
mkdir -p "$(dirname "$DST")"
adb -s "$SERIAL" pull "$SRC" "$DST"
# 拉完立即比对文件数
REMOTE_COUNT="$(adb -s "$SERIAL" shell find "$SRC" -type f | wc -l | tr -d ' ')"
LOCAL_COUNT="$(find "$DST" -type f | wc -l)"
echo "设备端文件数: $REMOTE_COUNT"
echo "本地文件数: $LOCAL_COUNT"
set -euo pipefail 让脚本在任意一步失败时立即停下,不会带着错误继续往下拉。adb -s "$SERIAL" get-state 先把设备状态卡一道,状态不是 device 就直接退出,比 pull 报错后再回头查要快。mkdir -p "$(dirname "$DST")" 只建父目录,目标名由 pull 自己创建,配合完整目标路径,落点就是确定的。最后的文件数比对是后悔药:数字对不上,说明中途有文件没拉过来,回头单独补拉那个子目录就行。
脚本里用到的 get-state、-s 和 find 都是 adb 与设备系统自带的常规能力,不需要额外装工具。唯一需要留意的是设备端 find 是否可用,前面提过,极少数精简系统没有这个命令,遇到时把统计那两行换成 adb shell ls -R 人工核对。
从那以后我每次导出板子代码,都强制按“adb devices 看状态 → adb shell ls 看源路径 → mkdir -p 建本地父目录 → adb pull 写全目标 → 比对文件数”这五步走一遍,哪怕只是拉一个几 MB 的小工程也不跳过。看起来多花了半分钟,实际省下的是“以为拉全了、结果少一个配置文件”那种反复排查的时间。希望帮到你。
