termux/termux-app - 项目详情

项目介绍快速开始学习路径项目截图 3 贡献者 80 增长趋势代码统计生态关系项目时间线项目竞品依赖分析上榜历史

5分钟快速开始 Termux Android 终端

本指南将帮助你在 Android 设备上快速安装并启动 Termux 终端模拟器，体验 Linux 环境。

环境要求

支持的操作系统

Android 7.0 或更高版本

运行环境

Android OS >= 7.0 必需

所需工具

Android 设备

运行 Termux 应用

必需

操作步骤

下载 Termux APK

从 GitHub Releases 下载最新版本的 Termux APK 文件。

打开下载页面

在 Android 设备浏览器中访问：https://github.com/termux/termux-app/releases

预期结果：页面显示最新版本（如 v0.118.3）的发布信息，找到 Assets 部分。

建议下载 universal 版本（如 termux-app_v0.118.3+github-debug_universal.apk），兼容性更好。

安装 APK

在 Android 设备上安装下载的 APK 文件。

手动安装 APK

1. 打开文件管理器，找到下载的 APK 文件
2. 点击安装（可能需要允许“未知来源”安装）

预期结果：安装成功，应用列表中会出现 Termux 图标。

如果之前安装过其他来源的 Termux，请先完全卸载（包括所有插件），否则会因签名冲突导致安装失败。

启动 Termux

打开 Termux 应用，等待初始环境设置完成。

启动应用

点击 Termux 应用图标

预期结果：终端界面打开，显示类似 `~ $` 的提示符，并可能自动运行初始脚本。

首次启动可能需要一些时间解压引导文件（bootstrap），请保持网络连接。

运行第一个命令

验证基本环境并安装一个简单软件包。

更新软件包列表并安装 curl

pkg update && pkg install curl

预期结果：显示软件包更新和安装进度，最后提示安装成功。

如果遇到“repository is under maintenance”错误，请稍后重试或参考项目 README 中的 Package Management 链接。

验证安装

使用 curl 测试网络连接和基本功能。

检查 curl 版本

curl --version

预期结果：显示 curl 的版本信息，例如 `curl 7.86.0 (aarch64-unknown-linux-android) ...`。

现在你已经拥有了一个可工作的 Linux 终端环境！

验证成功

Termux 已成功安装并运行，你可以执行常见的 Linux 命令。

终端正常显示提示符（如 ~ $）

可以执行 pkg、curl 等命令

无错误提示并返回命令结果

快速提示

配置

使用 pkg search <keyword> 搜索软件包，pkg install <package> 安装。

性能

在 Android 12+ 上，系统可能会无故终止 Termux 进程，显示 [Process completed (signal 9)]。请参考项目 README 中的 Android 12+ 注意事项。

配置

Termux 支持插件（如 Termux:API、Termux:Widget），所有插件必须从同一来源安装（如全部从 GitHub 下载）。

常见问题

安装时提示“App not installed”或签名冲突错误。

完全卸载设备上所有 Termux 及插件（Termux:API 等），然后重新安装。不要混合不同来源（如 F-Droid 和 GitHub）的安装包。

运行 pkg update 时提示“repository is under maintenance or down”。

这是临时镜像问题。等待一段时间重试，或参考项目 README 中“Package Management”链接的解决方案。

启动后很快退出，提示 [Process completed (signal 9)]。

这常见于 Android 12+。系统限制了后台进程数量。参考项目 README 中关于 Android 12+ 的说明，或尝试禁用相关系统优化。

下一步

探索基本命令

尝试 ls、cd、cat、nano 等 Linux 命令，熟悉环境。

安装更多工具

使用 pkg install 安装 python、git、nodejs 等开发工具。

访问官方社区

加入 Gitter 或 Discord（链接在 README）获取帮助和最新信息。