pydroid3 中文文档 下载 App

初始化 Python 解释器 —— 为什么第一次打开要等几秒

为什么不是「装完即开即用」

Pydroid 3 把一个完整的 CPython 发行版打包进了 APK(包括标准库、C 头文件、链接器等)。安装完 APK 后,这些文件处于压缩状态,App 第一次启动时需要把它们解压到 App 私有目录,配置好环境变量、生成必要的配置文件——这个过程就叫「解释器初始化」。

初始化具体做了什么

大致分为四步:

  1. 解压 CPython:把 APK 里打包好的 Python 可执行文件、标准库、site-packages 解压到 App 私有目录的某个子路径下
  2. 解压工具链:C/C++/Fortran 交叉编译器,包括 gcc、g++、gfortran、make、cmake 等,这些是 pip 编译原生扩展库的必要工具
  3. 配置 pip:设置 pip 默认索引指向 Pydroid 专属的 Android ARM 预编译 wheel 仓库,同时配置好 find-links 路径让 pip 优先查 wheel
  4. 设置 PATH 和环境变量:让终端模拟器和脚本运行器能找到 python、pip、gcc 等可执行文件

整个过程通常 5 到 30 秒,取决于设备的存储读写速度。老旧机型或存储紧张的设备可能需要更久。

初始化卡住了怎么办

极少数情况下初始化可能卡住不结束:

处理步骤:

  1. 强制关闭 App(系统设置 → 应用 → Pydroid 3 → 强制停止)
  2. 卸载重装,确认从 Play Store 完整下载
  3. 检查内部存储至少有 300MB 空闲
  4. 重装后再次启动,如果还是卡住可以尝试清理 App 缓存

初始化只有第一次安装后启动才会跑,后续更新 App 时如果解释器版本没变就不会重新解压。