QPython 产品定位——把完整 Python 编程环境装进口袋
一句话概括
QPython 是一款专为 Android 设备打造的 Python 编程引擎和集成开发环境(IDE)。它在一个 App 内集成了 Python 解释器、代码编辑器、交互式控制台、PIP 包管理、Android API 桥接库以及本地 AI 框架,让用户在手机上就能完成 Python 的学习、开发、调试与 AI 应用构建。
从简单工具到综合平台
QPython 的起源可以追溯到创始人 River 的个人项目——一个简单的 Android 上运行 Python 脚本的工具。经过社区十多年的迭代,它已经从「只能跑脚本」的小程序,发展为功能完备的移动端编程平台:
- 早期版本只有终端和解释器,用户需要手动编辑脚本再执行
- 中期加入了 QEditor 编辑器、QPYPI 包管理、QSL4A Android API 桥接
- 近期集成了 Ollama 本地 AI 框架、QNotebook Jupyter 支持、Web 开发套件(Django / Flask)
核心架构组件
QPython 的架构设计围绕「一个 App 覆盖全链路」展开,各组件之间的协作关系如下:
Python 解释器
底层的 Python 运行时,负责解析和执行脚本。QPython 的 Python 版本随 App 更新而迭代,官方教程提到最新版本至少 3.3.0 起。
QEditor
可视化代码编辑器,提供语法高亮、代码补全、多标签编辑、主题切换等 IDE 级能力。它不是独立 App,而是 QPython 内部的编辑模块。
QSL4A 桥接层
这是 QPython 区别于其他 Android 上 Python 方案的关键。QSL4A 采用 RPC(远程过程调用)架构,将 Android 原生 API 映射为可在 Python 中直接调用的函数。脚本通过 from androidhelper import Android 导入后,就能控制摄像头、读取传感器、发送通知等。
APIGPT / Ollama
4.0 版本起,QPython 集成了本地 AI 能力。用户可以在手机上下载并运行 Llama3.3、DeepSeek-R1、Phi-4、Mistral、Gemma2 等大语言模型,结合 LangChain 工具链构建 AI 应用。
与同类方案的定位差异
Android 上还有 Termux、Pydroid 等 Python 方案,QPython 与之形成不同的定位:
| 方案 | 定位 | 界面 | 原生 API | AI 支持 |
|---|---|---|---|---|
| QPython | Python IDE + Android API + AI 综合平台 | 全图形界面,开箱即用 | QSL4A 深度桥接 | 内置 Ollama |
| Termux | 类 Linux Shell 环境 | 终端为主 | 需额外配置 | 需自行安装 |
| Pydroid | 轻量 Python 编辑器 | 编辑器 + 终端 | 有限支持 | 无 |
功能概览图

小结
QPython 的定位非常明确:在 Android 上提供完整的、开箱即用的 Python 编程环境。它不追求极简,也不刻意模拟 PC 开发体验,而是直接在移动端形态上构建最丰富的功能集——从解释器到编辑器、从 API 桥接到本地 AI,全部内置,安装即用。
接下来可以看 版本演进 了解它是如何一步步长到今天的。