首次启动常见异常——Bootstrap 失败、菜单打不开、PATH 错
Bootstrap 安装失败
表现：引导界面停在「正在安装 Bootstrap」不动，或报错退出。
可能原因和处理：
| 原因 | 处理 |
|---|---|
| 安装过程中应用被切到后台 | 重新打开应用，保持前台直到完成 |
| 系统清理了 ZeroTermux 进程 | 给 ZeroTermux 开启电池优化豁免和后台运行权限 |
| 设备存储空间不足 | 卸载不常用应用，腾出 1 GB 以上 |
| 当前不是 Android 主用户 | 切换到主用户再装，工作资料夹/第二用户环境不支持 |
| 旧版 Termux 残留导致目录冲突 | 彻底卸载 Termux 和旧版 ZeroTermux 后重装 |
| 网络不稳定 | 切换源到国内镜像后重试 |
目录创建失败
表现：引导提示「无法创建 xinhao 目录」或子目录。
处理：
- 确认已授予存储权限
- 手动在文件管理器里创建
/sdcard/xinhao/目录再回到引导 - 如果
xinhao目录被系统权限锁死（部分厂商 Android 版本问题），清除 ZeroTermux 数据后重新引导
左右菜单打不开
表现：双击边缘或按音量键没有弹出侧边栏。
可能原因：
- 使用习惯设成了 Termux 风格：这种风格不支持边缘双击和音量键菜单。进入 ZT 设置把使用习惯切回 ZeroTermux 风格。
- 手势冲突：部分全面屏手机的边缘返回手势和 ZeroTermux 的菜单呼出冲突，尝试用音量键唤出。
- 侧边栏没展开：ZeroTermux 的侧边栏需要「从边缘向内滑」而不是点击边缘。
终端环境异常
表现：pkg update 报错、基础命令（ls、cd、apt）找不到、PATH 异常。
处理：
pkg update
pkg upgrade如果软件源连不上，先去「切换源」菜单换镜像再试。
系统语言与中文显示
如果界面菜单是英文但你希望显示中文：
- 进入 ZeroTermux 的「ZT 功能 → 语言切换」
- 选择中文
- 重启 ZeroTermux
注意：部分 Termux 原生组件（如 apt 错误提示）是英文的，不受 ZeroTermux 语言设置影响。
还没解决
如果以上排查都没用，截图错误信息到 ZeroTermux 社群（Diving Group）或项目 Issues 寻求帮助。