Android手机怎么执行python脚本Termux

半杯拿铁
半杯拿铁
发布时间:2026-11-19 | 12人浏览过
原创

在Android手机上通过Termux执行Python脚本的完整实操教程,涵盖Termux版本获取、环境包安装、本地与共享存储脚本编写运行、依赖管理及后台防休眠技巧。

在 Android 手机上执行 Python 脚本,核心路径是通过 Termux 终端模拟器构建一个免 Root 的轻量 Linux 用户态环境,使用内置包管理器安装官方 Python 解释器,最后通过 python <脚本名>.py 命令发起执行。整个过程不改动手机系统底层,脚本既可以直接在终端内编写,也可以存放在手机常规存储目录中由 Termux 读取调用。

Android手机怎么执行python脚本Termux
图 0:Android 宿主环境、Termux 终端沙盒与 Python 执行层的协同调用关系

准备工作:获取可正常更新的 Termux 版本

在开始任何命令操作之前,必须明确安装正确的 Termux 应用安装包。很多初次接触的用户会习惯性地在 Google Play 商店或第三方应用市场下载 Termux,但因为 Google Play 强制的 API 等级限制,Google Play 上的 Termux 版本早已在 0.101 之后停止维护,其软件源地址已全部失效,执行更新时会出现大面积 404 Not Found 报错。

版本提醒:请务必从 F-Droid 官网或 Termux 官方 GitHub Releases 页面下载安装包(通常为 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
Android手机怎么执行python脚本Termux
图 1:Termux 部署并运行 Python 脚本的四个核心阶段

步骤三:编写并执行第一个测试脚本

在手机上执行 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 的软链接目录。

Android手机怎么执行python脚本Termux
图 2:Termux 私有沙盒路径与 Android 共享存储映射机制

存储权限建立后,系统常见目录的对应关系如下:

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
存储权限特点:Android 共享存储(/sdcard)底层文件系统受系统 FUSE 机制管控,不支持 Linux 的可执行权限位标记(即无法通过 chmod +x script.py 后直接使用 ./script.py 运行)。在共享存储中运行脚本,必须始终明确带有 python 解释器前缀。

步骤五:安装第三方依赖库(pip)与常见排障

实际脚本通常依赖第三方库。Termux 提供了完整的 pip 工具,但根据库中是否包含 C/C++ 动态链接库,安装策略有所区别。

Android手机怎么执行python脚本Termux
图 3:pip 依赖库类型判断与底层编译链排障流程

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 或强制杀掉后台进程。

Android手机怎么执行python脚本Termux
图 4:Termux 脚本运行的三种工作模式与熄屏保活方案

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 系统设置中进行一项关键配置:

  1. 进入手机【设置】 -> 【应用管理】 -> 找到【Termux】;
  2. 进入【耗电详情】或【电池管理】页面;
  3. 将后台耗电策略由默认的“智能推荐/受限制”调整为“无限制”或“允许后台高耗电”;
  4. 有自启动权限开关的系统(如澎湃OS、OriginOS、ColorOS 等),开启“允许自启动”和“允许关联启动”。

总结:标准工作流与注意事项

在 Android 手机上利用 Termux 执行 Python 脚本,整体遵循“安装官方 Termux -> 初始化包环境 -> 安装 Python 与编辑工具 -> 关联手机存储 -> 运行与后台保活”这一清晰主线。

为了保证日常使用中的稳定性,请牢记以下三个核心建议:

  • 环境干净度:尽量在 Termux 原生家目录(~)中部署涉及大量小文件或虚拟环境的复杂工程,因为原生 Linux 文件系统在读写吞吐量和权限完整性上显著优于 /sdcard 共享存储;
  • 依赖安装顺序:遇到任何 clang 报错,首先检查 pkg install clang python-dev 是否已经就绪;
  • 备份意识:如果手机系统升级或清理软件垃圾,切勿直接清理 Termux 的“应用数据”,否则沙盒内的所有脚本和安装的模块都会被清空。重要代码应当始终保管在 ~/storage/shared 或同步至远程 Git 仓库。
相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表