Thonny IDE 使用教程
简介
Thonny是一款非常适合初学者的Python IDE,具备易于上手、语法检查、自动补全等诸多对用户友好的实用功能。非常适合用来学习python。
为了支持用户在Thonny平台上实现QuecPython开发,为此QuecPython团队开发了QuecPython-Kits插件,用户只需使用Thonny安装该插件即可。
本文档,旨在介绍Thonny的功能和用法,以及QuecPython-Kits插件的安装和使用方式。
Thonny环境搭建
下载
Thonny支持三种主流操作系统:windows、macos、linux。
访问Thonny官方网站(https://thonny.org/)。

根据屏幕右上角对应操作系统可以看到有如下安装方式(以windows为例)。

安装方式
Thonny应用程序安装支持两种安装方式:
- 安装Thonny+Python捆绑包 —— 这种方式本质是将Python环境和Thonny打包在一起,即可一键安装使用,快捷方便,推荐新手使用此方式。捆绑包的方式安装又分为两种,对应上图:
- 使用Installer安装
Installer with 64-bit Python 3.10—— 64位python3.10安装程序Installer with 32-bit Python 3.8—— 32位python3.8安装程序
- 免安装版本
Portable variant with 64-bit Python 3.10—— 64位python3.10免安装版本(解压即可使用)Portable variant with 32-bit Python 3.8—— 32位python3.8免安装版本(解压即可使用)
- 使用Installer安装
- 单独安装Thonny —— Thonny应用本质是以python包的形式存在,当用户已经具备python环境,即可通过
pip install thonny单独安装Thonny。这种方式更适合开发者。对应上图:Re-using an existing Python installation (for advanced user)
使用Installer安装
以64-bit Windows 10环境下,安装程序Installer with 64-bit Python 3.10为例。下载该安装程序thonny-4.1.2.exe后,双击运行后点击Next即可一键安装。安装完毕后找到桌面应用程序图标即可运行。

使用免安装版本
以64-bit Windows 10环境下,Portable variant with 64-bit Python 3.10为例。下载安装包thonny-4.1.2-windows-portable.zip,解压后,双击运行thonny.exe即可。

使用PIP安装thonny
注意事项:
1、这种方式面向开发者,若采用该方式安装Thonny,需具备python环境。移步python官方下载(https://www.python.org/downloads/)安装python开发环境。
2、
pip是python的包管理器,通过该程序可以在shell环境下安装python应用包。
具备python环境后,通过pip install thonny安装thonny。

安装完毕后,可以通过pip list查看当前安装的thonny包(thonny==4.1.2)。

通过python -m thonny运行Thonny应用程序,随后Thonny应用程序启动窗口界面即显示。
命令解释:
python -m <package>,-m参数后跟一个模块/包名,将模块/包作为脚本运行。

编写&运行脚本
选择&配置解释器 - 编写&运行脚本
在菜单栏中选择运行 --> 配置解释器。

在弹出的对话框中,选择python解释器Local Python3即为本地python环境,在下方的Python executable栏中选择python.exe路径。如果采用捆绑包的方式安装,路径是默认配置好的。如果是单独安装,则用户需指定本地python解释器路径。

运行第一个脚本
在Thonny文本编辑区域,编辑python脚本程序。

ctrl + s快捷键弹出窗口中选择路径即可保存当前python脚本文件。
QuecPython环境搭建
下载安装QuecPython-Kits插件
使用Thonny界面安装
菜单工具,选择管理插件...打开插件管理界面。

在搜索栏中搜索thonny-quecpython。

点击Install下载按钮即可下载安装插件(注意:下载完成后需重启Thonny生效)。
使用PIP安装thonny-quecpython
pip install thonny-quecpython -i {pip国内源}
pip国内源推荐
打开插件界面
菜单栏工具,选择QuecPython套件即可打开插件界面,如下图在屏幕的下方子界面所示。

QuecPython固件下载
点击插件栏选择文件按钮,选择需要下载的固件文件后,点击开始下载即进入模组固件下载流程。完成后如下图所示。

下载固件前请确保连接模组至电脑。
QuecPython脚本运行
借助于Thonny,我们可以直接通过REPL写入代码运行调试,也可以编辑脚本文件运行调试。
选择&配置解释器 - QuecPython脚本运行
在菜单运行 --> 配置解释器中选择QuecPython(generic)。

本文档使用
EG912U-GLAA模组测试,交互口为Quectel USB NMEA Port @ COM11。
选择好交互串口后,Thonny主界面下方shell子界面会显示Quecpython欢迎字样。在交互中输入uos.uname()可以查看当前模组型号版本等信息。

编辑&运行脚本
在编辑栏中编辑QuecPython脚本代码,点击运行按钮,脚本代码即自动在模组中运行。观察shell交互界面中脚本的打印输出。

保存脚本文件
Thonny可以将脚本文件保存本地,亦可保存至设备模组中。
在编辑栏中编辑好脚本文件后,快捷键ctrl+s或点击左上角保存按钮会弹出对话框供工具选择保存至设备还是保存本地。
保存对话框:

输入文件名&选择设备保存文件系统路径(/usr):

菜单视图 -> 文件可以打开左侧栏显示本地和设备的文件系统目录结构。如下,可以看到我们刚才保存的脚本文件/usr/test.py。用户也可以直接选中设备中的脚本文件双击打开显示在Thonny编辑栏中直接进行编辑和调试。

QuecPython-Kits插件开源代码下载
QuecPython-Kits开源项目命名为thonny-quecpython,github仓库链接:https://github.com/QuecPython/thonny-quecpython。
thonny开源项目仓库链接:https://github.com/thonny/thonny。