QPython内置完整的Python3.12运行环境，无需联网即可运行Python程序，提供语法高亮、快捷输入、代码片段等编辑功能，保存时需手动添加py扩展名，并提供Python控制台，支持探索对象属性、测试语法和直接执行命令，且支持通过QPYPI和pip安装第三方扩展包，预装Numpy、Scipy、Matplotlib等科学计算库，以及Pillow、OpenPyXL、Lxml等文件处理库。

一、QPython如何运行脚本文件

1、打开QPython后，点击上方的按钮。

2、再点击运行脚本。

3、最后选择需要运行的脚本即可运行。

二、QPython如何编辑程序并保存

1、打开QPython后，点击程序编辑器。

2、然后编写程序代码。

3、再找到右上角的文件图标并点击。

4、然后选择需要保存的文件夹即可。

三、QPython的常见问题

Q：QPython读取手机外部存储文件时提示“FileNotFoundError”或“PermissionError”怎么办？

A：这是 Android 10 及以上系统分区存储机制导致的典型问题。QPython 3h 基于旧版 Python，无法直接访问非应用专属目录。解决方法为：先在代码中调用 androidhelper.Android().makeToast() 触发权限请求，再用 os.path.join(android.os.environ['EXTERNAL_STORAGE'], 'Download', 'test.txt') 构造合规路径，避免直接使用 /sdcard/... 写法。Android 6.0 以上还需在运行时动态申请 READ_EXTERNAL_STORAGE 权限。

Q：QPython中安装第三方库后无法 import 怎么办？

A：常见原因包括旧版 QPython 未适配 PEP 517，对 pyproject.toml 项目解析异常，可能跳过 C 扩展编译步骤而不报错。建议优先通过 QPYPI 安装预编译的 wheel 包，而非直接使用 pip。如果 QPYPI 中缺少目标库，可尝试更新 QPython 至最新版本，或改用 QPython+ 社区版获取更新的包管理支持。

Q：QPython的SL4A功能无法正常使用或连接失败怎么办？

A：SL4A 服务需要 QPython 应用处于前台运行状态才能正常连接，无法仅通过桌面快捷方式直接调用。请先打开 QPython 应用，再运行使用 SL4A 的脚本。如果问题依旧，检查系统设置中是否已为 QPython 授予对应的敏感权限，如短信、位置、摄像头等。标准版仅需基本权限即可安装，但部分 SL4A API 需要 Plus 版本才能调用。

四、QPython的软件特色

- Android功能：

通过QSL4A库接入Android设备传感器和服务，拓宽应用场景。

- Web开发：

支持Django、Flask等流行框架，轻松构建Web应用程序。

- AI集成：

支持OpenAI、Langchain、APIGPTCloud等AI框架，探索人工智能的无限可能。

- 科学计算：

Numpy、Scipy、Scikit-learn、Matplotlib 等库帮助您解决复杂的科学计算问题。

- 文件处理：

Pillow、OpenPyXL、Lxml 等库使数据处理变得简单。

五、QPython的更新日志

v3.8.6版本

- 将 qsl4ahelper 添加为内置包

- 将 QPySL4A App 项目示例添加到内置编辑器中，您可以通过创建项目来创建 QSLAApp

- 重新安排权限

- 修复了 ssl 错误错误