Android手机怎么执行python脚本Termux
在Android手机上通过Termux执行Python脚本的完整实操教程,涵盖Termux版本获取、环境包安装、本地与共享存储脚本编写运行、依赖管理及后台防休眠技巧。
在 Android 手机上执行 Python 脚本,核心路径是通过 Termux 终端模拟器构建一个免 Root 的轻量 Linux 用户态环境,使用内置包管理器安装官方 Python 解释器,最后通过 python <脚本名>.py 命令发起执行。整个过程不改动手机系统底层,脚本既可以直接在终端内编写,也可以存放在手机常规存储目录中由 Termux 读取调用。
准备工作:获取可正常更新的 Termux 版本
在开始任何命令操作之前,必须明确安装正确的 Termux 应用安装包。很多初次接触的用户会习惯性地在 Google Play 商店或第三方应用市场下载 Termux,但因为 Google Play 强制的 API 等级限制,Google Play 上的 Termux 版本早已在 0.101 之后停止维护,其软件源地址已全部失效,执行更新时会出现大面积 404 Not Found 报错。
termux-app_v..._arm64-v8a.apk 或通用版)。只有这些官方维护构建版本才支持持续的软件源同步与 Python 安装。
步骤一:初始化环境与配置软件源
安装完成后打开 Termux,首先呈现的是一个黑底白字的命令行界面。Termux 本质上是一个独立的应用沙盒,在运行 Python 之前,需要先同步其内部的 Linux 基础依赖包索引。
输入以下命令同步包列表并升级底层库:
pkg update && pkg upgrade -y
执行过程中如果出现关于配置文件保留的交互提示(如问是否保留 default 配置文件),直接按回车确认即可。
如果手机网络连接国外官方源速度较慢,可以使用 Termux 官方集成的源切换命令快速切换至清华大学、中科大等国内镜像源:
termux-change-repo
在弹出的图形菜单中,先通过回车选择 Main Packages,再选择国内镜像站点(例如 Mirrors by Tsinghua),回车确认后会自动完成源文件重定向并刷新。
步骤二:在 Termux 中安装 Python
源配置正常后,安装 Python 只需一条命令。Termux 会自动拉取匹配手机 CPU 架构(绝大多数现代 Android 手机均为 aarch64 架构)的预编译 Python 二进制包及其核心动态库:
pkg install python -y
这条命令不仅会安装 Python 3 解释器本体,还会自动附带安装 pip(Python 包管理工具)和必要的构建链接文件。安装结束后,可以通过以下命令验证环境是否就绪:
python -V
pip -V
Python 3.11.8
pip 24.0 from /data/data/com.termux/files/usr/lib/python3.11/site-packages/pip (python 3.11)
若终端正确返回了版本号信息,说明解释器已在 Termux 沙盒内准备就绪。为方便在命令行中直接编辑代码,建议同步安装一个基础文本编辑器(如 nano):
pkg install nano -y
步骤三:编写并执行第一个测试脚本
在手机上执行 Python 脚本有两种常见文件存放方式:一种是直接在 Termux 自身的 Home 目录下新建文件;另一种是读取手机外部存储中的现成文件。我们先以 Termux 内部环境为例,确认最直接的执行机制。
在当前终端中执行以下命令,使用 nano 创建名为 main.py 的文件:
nano main.py
进入编辑器后,输入以下包含基本逻辑的测试代码:
import sys
import platform
print("=== Termux Python 运行测试 ===")
print("Python 版本:", platform.python_version())
print("系统架构:", platform.machine())
print("脚本参数:", sys.argv[1:] if len(sys.argv) > 1 else "无额外参数")
print("测试执行完毕。")
编辑完成后,按手机屏幕下方扩展功能键栏中的 Ctrl 键,再按键盘上的 O 键,回车保存;随后按 Ctrl + X 键退出 nano 编辑器。
退出后回到命令提示符,执行该脚本:
python main.py
=== Termux Python 运行测试 ===
Python 版本: 3.11.8
系统架构: aarch64
脚本参数: 无额外参数
测试执行完毕。
若需要传入命令行参数,直接在脚本名后追加即可,例如 python main.py task1 --debug,代码内的 sys.argv 即可直接接收参数数组。
步骤四:访问 Android 共享存储中的 Python 脚本
在手机虚拟键盘上用命令行敲击长篇代码并不方便。更多实用场景中,用户习惯使用手机上的代码编辑器(如 Acode、MT 管理器),或者直接把电脑上写好的 .py 脚本通过微信、QQ、USB 数据线拷贝到手机的“下载(Download)”或内部存储中。
默认情况下,Termux 运行在独立的私有沙盒中,无法读取手机的 /sdcard 目录。要访问手机公共文件,必须先执行存储权限桥接命令:
termux-setup-storage
执行该命令后,Android 界面会弹出一个系统权限申请对话框,提示“允许 Termux 访问照片和媒体内容”。点击“允许”后,Termux 内部会在用户的家目录下生成一个名为 storage 的软链接目录。
存储权限建立后,系统常见目录的对应关系如下:
| Termux 映射路径 | Android 手机实际绝对路径 | 典型用途 |
|---|---|---|
~/storage/shared |
/sdcard 或 /storage/emulated/0 |
手机内部存储主根目录 |
~/storage/downloads |
/sdcard/Download |
系统下载目录,适合存放电脑传输的脚本 |
~/storage/dcim |
/sdcard/DCIM |
相机胶卷与截图目录,适合图像批量处理脚本 |
假设你通过电脑或手机浏览器将一个爬虫脚本 crawler.py 放在了手机的“下载”文件夹内,在 Termux 中可以通过两种方式运行它:
方法一:直接通过完整相对路径指定文件执行:
python ~/storage/downloads/crawler.py
方法二:切换工作目录到目标文件夹后再执行:
cd ~/storage/downloads
python crawler.py
chmod +x script.py 后直接使用 ./script.py 运行)。在共享存储中运行脚本,必须始终明确带有 python 解释器前缀。
步骤五:安装第三方依赖库(pip)与常见排障
实际脚本通常依赖第三方库。Termux 提供了完整的 pip 工具,但根据库中是否包含 C/C++ 动态链接库,安装策略有所区别。
1. 纯 Python 模块的直接安装
对于纯 Python 实现的库(如 requests、beautifulsoup4、flask、click 等),可以直接使用常规 pip 命令安装:
pip install requests flask
2. 包含 C 扩展或数值计算库的编译问题
当安装涉及原生编译的包(如 cryptography、pillow、lxml 等)时,PyPI 官方通常没有为 Android 的 bionic C 库提供预构建的 arm64 架构二进制 wheel 包,pip 会尝试在手机本地通过源代码调用编译器构建。
如果未配置编译工具链,终端会报出类似以下错误:
error: command 'clang' failed: No such file or directory
Failed to build cryptography
ERROR: Could not build wheels for cryptography, which is required to install pyproject.toml-based projects
解决此问题的根本方法是在 Termux 中补齐本地构建所需的 C 编译器及开发头文件包:
pkg install clang make python-dev libffi-dev openssl-dev libxml2 libxslt -y
安装完成后,再重新执行 pip install <包名>,pip 便可调用本地 clang 编译器成功完成轮子编译。
针对 numpy、pandas、scipy 等编译极其繁重甚至依赖 Fortran 编译器的科学计算包,在手机本地完整编译耗时极长且容易因内存溢出被系统终止。Termux 官方社区维护了预编译源 tur-repo(Termux User Repository),推荐直接通过 pkg 安装社区预打包的二进制包:
pkg install tur-repo -y
pkg install python-numpy python-scipy -y
步骤六:保持脚本在后台持续稳定运行
很多实用脚本(例如定时提醒、自动化信息同步、本地微型 Web 接口或网络爬虫)需要长时间运行。但在 Android 系统中,当用户切换应用或关闭屏幕时,系统内核的休眠策略与各大手机厂商激进的“电池优化”机制会迅速挂起 CPU 或强制杀掉后台进程。
1. 唤醒锁(Wake Lock)防休眠
Termux 自带了电源唤醒锁工具。在需要长跑任务前,在命令行中输入:
termux-wake-lock
此时手机通知栏会常驻一条 Termux 服务的通知,标志着获取了 Android 系统的部分唤醒锁(PARTIAL_WAKE_LOCK),可有效防止手机息屏后 CPU 进入深度休眠导致脚本暂停。任务执行结束不需要常驻时,执行以下命令释放锁以节省电量:
termux-wake-unlock
2. 使用 nohup 挂起后台并输出日志
如果希望脚本在关闭 Termux 终端界面后依然运行,可以使用 Linux 标准的 nohup 命令,将脚本输入输出重定向到日志文件中:
nohup python -u app.py > app.log 2>&1 &
参数解释:
-u:强制 Python 的标准输出以无缓冲(unbuffered)模式输出,确保打印信息实时写入日志文件,不被滞留在内存缓冲区中;> app.log 2>&1:将标准输出(stdout)和错误输出(stderr)统一写入同级目录的app.log中;- 末尾的
&:将程序置于后台执行,终端立即恢复控制权。
查看正在后台运行的 Python 进程:
ps -ef | grep python
如果需要停止正在后台运行的脚本,使用 kill 加上查出来的进程 PID,或使用 pkill 按脚本名字精确终止:
pkill -f "python.*app.py"
3. 系统级电池优化设置
除了 Termux 内部的设置,还需要在 Android 系统设置中进行一项关键配置:
- 进入手机【设置】 -> 【应用管理】 -> 找到【Termux】;
- 进入【耗电详情】或【电池管理】页面;
- 将后台耗电策略由默认的“智能推荐/受限制”调整为“无限制”或“允许后台高耗电”;
- 有自启动权限开关的系统(如澎湃OS、OriginOS、ColorOS 等),开启“允许自启动”和“允许关联启动”。
总结:标准工作流与注意事项
在 Android 手机上利用 Termux 执行 Python 脚本,整体遵循“安装官方 Termux -> 初始化包环境 -> 安装 Python 与编辑工具 -> 关联手机存储 -> 运行与后台保活”这一清晰主线。
为了保证日常使用中的稳定性,请牢记以下三个核心建议:
- 环境干净度:尽量在 Termux 原生家目录(
~)中部署涉及大量小文件或虚拟环境的复杂工程,因为原生 Linux 文件系统在读写吞吐量和权限完整性上显著优于/sdcard共享存储; - 依赖安装顺序:遇到任何
clang报错,首先检查pkg install clang python-dev是否已经就绪; - 备份意识:如果手机系统升级或清理软件垃圾,切勿直接清理 Termux 的“应用数据”,否则沙盒内的所有脚本和安装的模块都会被清空。重要代码应当始终保管在
~/storage/shared或同步至远程 Git 仓库。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













