Termux 中 termux-usb 卡死无响应怎么办？USB 设备访问排障完整指南
【免费下载链接】termux-appTermux - a terminal emulator application for Android OS extendible by variety of packages.项目地址: https://gitcode.com/GitHub_Trending/te/termux-app
如果你在 Termux 终端里敲下termux-usb -l却永远等不到输出，或者启动 Termux:API 服务时看到Not found; no service started，本文教你 3 步定位并修复。以 Termux 0.118.1 + Termux-API 0.58.0-1 组合出现的"命令挂起"问题为例，根因几乎都不是 USB 驱动或 SELinux，而是一个容易被忽略的事实：Termux:API 由两部分组成，你只装了其中一半。
一、先照着做：3 步恢复 termux-usb 命令
1. 装齐"另一半"：Termux:API 插件应用
终端里的termux-usb只是客户端，真正持有 USB 访问能力的是 Android 端的 Termux:API 插件应用。请先确认应用列表里同时存在Termux和 **Termux:API** 两个应用（插件应用从官方渠道获取，与 Termux 主体配套）。只装了termux-api终端包而没有装插件应用，是termux-usb挂起最常见的原因。
2. 给两侧授权并确认服务可拉起
关键的一步是确认插件侧服务能正常启动。回到 Termux 终端，先运行termux-usb -l确认是否已有输出；若仍无响应，检查通知栏中是否出现 Termux:API 服务的启动提示，必要时在 Android 系统设置中允许 Termux 应用与 USB 设备交互。授权完成后，设备列表应能正常打印。
3. 必要时打开外部应用调用开关
如果插件命令被策略拦截，需要确认 Termux 的 properties 配置（~/.termux.properties，常量定义见 TermuxConstants.java）中允许外部应用调用。校验逻辑可参考 TermuxPluginUtils.checkIfAllowExternalAppsPolicyIsViolated()，报错信息会直接提示你补全该配置项。
二、根因定位：缺的不是权限，是插件端
把日志特征串起来看：
termux-usb -l执行后终端无输出、无报错，光标一直等待——命令进入"有去无回"的阻塞状态；- 尝试启动 Termux:API 服务时报
Not found; no service started； - 系统日志中 SELinux 权限检查通过，但服务实际没有跑起来。
很多人会误判为权限问题。但第 3 条恰好排除了它：SELinux 都放行了，缺的却是"被调用的对象"本身。按现象倒推：
- 权限拦截 → 应该看到明确的拒绝报错，而不是静默挂起；
- 服务找不到（
no service started）→ 说明 Android 端根本不存在可被拉起的服务组件。
结论：用户只安装了终端部分的命令行工具，对应的 Android 插件应用缺失。termux-usb发出了请求，却没有任何进程接收，于是永久等待，表现为"命令卡死"。
三、原理拆解：终端 + 插件的双组件架构
要理解为什么"装一半"必然失败，得先明白 Termux 的两层分工：
- 终端侧：
termux-usb等命令，运行在 Termux 应用受限的沙盒进程里，本身拿不到 USB 这类敏感系统能力； - Android 插件侧：Termux:API 插件应用充当"替终端跑腿的中间人"，它才是被系统认可的 USB 请求发起方。
两者之间的通信走 Android 进程间通信（IPC，即两个独立进程互相发消息的机制）。在源码中，这条通道由本地 socket 层实现，客户端与服务器端分别见 LocalClientSocket.java 与 LocalServerSocket.java，统一管理逻辑在 termux-shared 的 socket 模块；插件命令的执行与结果回传则由 TermuxPluginUtils 处理。
对照到本次故障，失效环节非常具体：
| 环节 | 正常情况 | 本次故障 |
|---|---|---|
| 插件应用 | 存在并可启动服务 | 缺失，no service started |
| 本地 socket 通道 | 两端建立连接 | 客户端连不上对端 |
| USB 请求 | 插件转发给系统 | 请求无人接收 |
| 终端命令 | 拿到结果并打印 | 阻塞等待，终端挂起 |
一句话：IPC 的"另一端"不存在，termux-usb自然无响应。这套架构同时兼顾了安全（敏感能力收敛在插件侧）与可用（终端侧只管发指令）。
四、预防与优化：避免再踩同一个坑
- 两侧版本配套：更新 Termux 时同步更新 Termux:API 插件应用，避免 0.118.1 主体配旧版插件这类版本错位；
- 用前自检：运行
termux-usb -l确认输出，确认插件服务已正确启动后再进行复杂 USB 交互； - 善用错误通知：插件命令失败时，Termux 会通过系统通知（含报告页）展示错误详情，收到通知先点开看，比盲猜快得多；
- 自动化连接流程：对频繁使用的 USB 场景，把"启动服务 → 列设备 → 附加设备"写成脚本，减少手动步骤；
- 环境管理：用
pkg upgrade等命令统一升级，更多用法可参考 Termux 官方文档。
完成"装全插件应用 + 授权 + 服务确认"这三步后，termux-usb -l即可正常列出 USB 设备，问题即告解决。
【免费下载链接】termux-appTermux - a terminal emulator application for Android OS extendible by variety of packages.项目地址: https://gitcode.com/GitHub_Trending/te/termux-app
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
