开发第一个脚本

在开始编写代码前，请确保您已完成硬件、固件和软件环境的准备。

编写第一个脚本文件

打开VScode，输入下方字符串

print("hello world")

接下来将编写好的脚本保存在本地，将文件名命名为 helloworld.py（仅允许英文、数字和下划线，禁止使用中文和特殊字符）

下面通过QPYcom将上面编辑好的文件传输到模组中并运行

传输脚本文件到模组

在传输脚本文件前要确保QPYcom串口已打开

方法一: 通过拖拽形式传输

打开QPYcom点击文件，点击图示上的按钮选择helloworld.py脚本文件路径

选择存放helloworld.py脚本文件路径后，在左侧可以看到编写好的脚本文件

将左侧helloworld.py脚本文件拖拽到右侧usr中进行传输，下载进度和结果会在下方状态栏显示

右侧usr显示helloworld.py说明成功传输到模组中

方法二:通过工具按钮传输

点击右侧 "+"按钮进行传输文件

找到编写好的helloworld.py文件，点击右下角打开

右侧usr显示helloworld.py说明成功传输到模组中

方法三:创建用户项目进行传输

点击下载页面

创建用户项目（点击"创建"按钮）

创建好项目名称，点击"OK"

左侧显示创建好的项目

在"用户脚本/文件"区域选择usr根目录鼠标右键添加文件

添加成功后会显示准备好进行传输的helloword.py文件，点击右下角会出现“下载脚本“与”下载固件”，选择下载脚本进行传输

下载好后会提示”文件下载成功“

执行脚本文件

方法一：通过repl执行脚本

打开串口之后，在QPYcom交互页面输入以下代码执行脚本文件

import example
example.exec("/usr/hello world.py") # filePath为要执行的脚本文件路径

方法二：通过GUI工具执行脚本

在工具的文件页面选择要执行的helloworld.py脚本文件然后点击按钮运行

方法三：通过右键菜单运行脚本文件

选择脚本文件，右键点击运行

执行结果如图所示

停止程序运行

如何停止正在运行的程序,根据运行的脚本文件类型有以下方法:

常见问题与注意事项

1. 执行脚本无输出 / 提示文件不存在

• 路径拼写错误：REPL 执行exec函数时路径文件名大小写 / 拼写与模组内文件不一致；
• GUI 执行选错文件：未选中右侧usr目录下的目标脚本，点击执行按钮后无实际程序运行；
• 脚本语法错误：脚本内存在语法问题（如缺少括号、缩进错误），执行时静默失败无输出。

2. 脚本文件下载失败

• 串口未就绪：下载前未打开串口，或开发板未烧录对应固件 / 固件烧录失败，导致模组无响应；
• 命名 / 路径非法：文件名含中文、特殊字符，或本地文件路径选择错误；
• 拖拽操作不当：未将本地文件拖至右侧模组usr目录区域。