QPython 第三方库安装——图形化 QPYPI 与终端 pip 双路径
方式一：QPYPI 图形化界面（推荐）
这是最省心的方式，不需要敲命令。
操作步骤
- 打开 QPython 主界面，找到 QPYPI 入口（通常在扩展区或底部）
- 在推荐列表里直接点「安装」，或者搜索包名找到目标包
- 点击包名进入详情页，查看描述、版本号、依赖
- 点「安装」按钮，等待下载和安装完成
- 安装成功后，QPYPI 会在已安装列表里显示
整个过程不需要切输入法，也不需要记任何命令。
安装过程中发生了什么
点击「安装」后，QPython 执行以下步骤：
- 通过网络从 PyPI 搜索目标包
- 找到适配当前 Python 版本和 Android 架构的 wheel 文件（如果有）或源码包
- 下载到临时目录
- 调用 pip 执行安装（写入到 App 内部的 Python 库目录）
- 清理临时文件，更新 QPYPI 的已安装列表
推荐 vs 搜索
推荐列表里的包是 QPython 官方确认过能在 Android 上正常安装和运行的。搜索结果里的包可能包含不兼容的，遇到安装失败很正常——不是你的操作问题，是包本身不支持移动端。
方式二：终端里用 pip 命令
如果你习惯命令行，或者 QPYPI 界面不方便时，可以在 REPL 或终端里直接敲 pip 命令。
在 REPL 中
import subprocess
subprocess.run(["pip", "install", "numpy"])或者在某些版本里可以用 shell 形式：
!pip install numpy在独立终端窗口
部分 QPython 版本提供单独的 shell 终端，在里面直接敲：
pip install numpy
pip install flask django
pip install --upgrade numpy
pip uninstall numpy
pip list # 列出所有已安装包从 requirements.txt 批量安装
如果你有一个 requirements.txt 文件（记录项目所有依赖）：
import subprocess
subprocess.run(["pip", "install", "-r", "requirements.txt"])安装常见问题排查
包下载超时或失败
手机网络不稳定或流量不够时容易失败。解决：
- 换 Wi-Fi 环境重试
- 用流量监控确认下载确实在进行
- 多次重试——pip 有缓存，成功过一次下次会快很多
安装后 import 报错
QPYPI 显示安装成功，但代码里 import xxx 还是报错：
- 确认包确实在已安装列表里
- 重启 QPython App——有时候新安装的包需要重启才能被 Python 运行时识别
- 检查包名和导入名是否一致——
pip install Pillow但代码里是from PIL import Image
有 C 扩展的包编译失败
这类包在 Android 上没有编译工具链，会报类似 error: command 'gcc' not found 的错误。解决：
- 换一个功能类似但纯 Python 实现的替代包
- 看看有没有预编译好的 wheel 文件（.whl 格式），如果有可以手动下载安装
- 放弃——这不是你的问题，是包本身不支持 Android
版本冲突
如果 A 包依赖 B 包的旧版本，而 C 包依赖 B 包的新版本，pip 可能报版本冲突。解决：
- 卸载冲突包，先装一个，再装另一个（可能功能受限）
- 或者就不用这两个包一起装——手机算力有限，装太多包本身也容易出问题
安装成功后怎么验证
在 REPL 里直接 import 试试：
>>> import numpy
>>> numpy.__version__
'1.26.0' # 显示版本号 = 安装成功小结
QPYPI 图形化界面是移动端安装包的首选——简单、不用敲命令。终端 pip 适合熟悉命令行或需要批量操作的场景。安装失败最常见的两个原因是有 C 扩展需要编译（无解）和网络问题（重试）。成功后用 import + __version__ 验证。
科学计算库是 QPython 里预装/推荐的重点，接下来详细看。