QPYPI 包管理——QPython 的第三方库安装入口

什么是 QPYPI

QPYPI 是 QPython 内置的第三方包管理功能。它的名字来自 Python 官方包索引 PyPI（Python Package Index），加了一个 Q 代表 QPython 的定制版本。

在 PC 上，Python 的包管理标准做法是用 pip install xxx 从 PyPI 拉取包。QPython 把这个流程做成了图形化界面，让手机用户可以在不敲命令的情况下浏览、搜索、安装第三方库。

QPYPI 和 pip / PyPI 的关系

也就是说，QPYPI 不是一套新的包管理体系，而是对 pip 的移动端 GUI 封装。它安装的包和 PC 上 pip 安装的包来自同一个 PyPI 仓库。

QPYPI 的界面功能

典型的 QPYPI 界面包含：

浏览推荐包

首次打开 QPYPI 会显示推荐包列表，通常按类别分组：

• 科学计算：numpy、scipy、matplotlib、pandas、scikit-learn
• Web 开发：django、flask、requests
• 数据处理：pillow、openpyxl、lxml
• 网络通信：websocket、urllib3
• AI / 机器学习：部分轻量 ML 库

推荐包列表会根据 QPython 版本更新。

搜索包

顶部搜索框可以输入包名或关键词，QPYPI 会去 PyPI 搜索匹配的包。比如搜 numpy 就能找到 NumPy 的安装条目。

已安装包管理

QPYPI 会显示当前 QPython 里已经安装了哪些包、各自的版本号、是否有更新可用。可以对已安装包执行升级或卸载。

为什么手机上需要图形化包管理

PC 上敲 pip install numpy 很简单，但手机上有几个现实问题：

• 输入法切换麻烦：敲英文包名需要切到英文输入法
• 容易打错字：触屏上敲错字母很常见
• 不知道装什么：新手不知道有哪些库可用，推荐列表能帮你发现

QPYPI 的图形化界面解决了这些问题——点一下就能装，不用敲命令。

和终端 pip 命令的关系

QPYPI 是 GUI 封装，底层调用的还是 pip。你也可以直接在终端里用 pip 命令：

!pip install numpy  # 在 REPL 或 Notebook 里
# 或
import subprocess
subprocess.run(["pip", "install", "numpy"])

两种方式的效果是一样的——包被安装到同一个位置，可以互相看到。

包安装的限制

需要注意的是，不是所有 PyPI 上的包都能在 QPython 里成功安装：

• 需要 C 扩展编译的包：某些包有 C 扩展代码，需要在安装时编译。手机上没有编译工具链，这类包安装会失败
• 系统依赖缺失：某些包依赖 PC 上才有的系统库，Android 上没有
• 架构不匹配：某些包只提供特定 CPU 架构的预编译 wheel，和手机 CPU 不匹配

一般来说，纯 Python 包（没有 C 扩展）安装成功率最高。预装在 QPython 里的包（科学计算库、Web 框架等）已经过适配，安装不会有问题。

小结

QPYPI 是 QPython 对 pip 的移动端图形化封装，解决了手机上敲命令不方便的问题。它的核心功能是浏览推荐包 + 搜索安装 + 管理已安装包。纯 Python 包基本都能装成功，有 C 扩展的可能因编译工具链缺失而失败。

接下来看 包安装的具体方法 和 科学计算库专项。