系列导读：第 3 篇 / 共 7 篇。前两篇把硬件和驱动搞定了，这篇开始装工具。
本篇关键词：QPYcom / VSCode 插件 / 固件烧录 / 代码补全
一、两个工具，不是二选一，是分工不同
很多新手会问"到底该用哪个"，其实官方给了两个入口，覆盖的场景并不一样：
| 维度 | QPYcom | VSCode 插件 |
|---|---|---|
| 定位 | 全栈调试工具（官方专用） | 编辑器增强（写代码更爽） |
| 代码调试 |  交互式 REPL |
串口调试面板 |
| 日志分析 | |
基础 |
| 文件传输 | 可视化管理模组内文件 |
依赖其他方式 |
| 固件烧录 | 只有它能烧 |
插件支持 |
| 固件合并 | |
 |
| 代码提示 / 补全 | |
|
| 安装方式 | 解压即用，免安装 | 插件市场一键装 |
结论：两个都装。QPYcom 负责烧固件、传文件、看日志和交互调试；VSCode 负责写代码。只装 VSCode，你没法烧固件；只装 QPYcom，写代码体验会比较原始。
二、安装 QPYcom
QPYcom 是移远为 QuecPython 定制的开发调试工具，支持代码调试、日志分析、文件传输、固件烧录与固件合并。
下载：官网 QuecPython 资源下载 → 工具板块，下载 QPYcom（当前版本 V4.2.0）。
安装：
该工具无需安装，解压即用。解压后直接双击目录里的可执行文件就能打开，不要去找 setup.exe（没有）。
建议解压到固定路径（比如
D:\Tools\QPYcom），别放在桌面或下载目录，避免以后误删。
三、安装 VSCode 插件
QuecPython 官方推出了专用 VSCode 插件，提供代码提示、代码补全和串口调试能力。
方式一（推荐）：打开 VSCode → 左侧插件市场（Extensions）→ 搜索 QuecPython → 点击安装。
方式二：访问 VSCode 插件商店网页版，搜索 QuecPython 后点击下载，会自动唤起 VSCode 完成安装。
安装完成后，VSCode 侧边栏或状态栏会出现 QuecPython 相关入口，说明插件已生效。
四、装完先做这两件事
- 打开 QPYcom，看端口列表里有没有你的设备
如果有Quectel USB REPL Port，说明第 2 篇的驱动装对了。 - 在 VSCode 里新建一个 .py 文件试试补全
输入import看是否弹出 QuecPython 的模块列表（如machine、utime、net）。有补全 = 插件工作正常。
五、常见问题
Q1：QPYcom 打开报错 / 闪退？
A：先确认解压路径没有中文和空格；再确认系统是 Windows 10 及以上；如仍报错，尝试右键"以管理员身份运行"。
Q2：QPYcom 里能看到端口，但"打开串口"失败？
A：端口被占用。关掉其他串口工具（串口助手、Arduino IDE、另一个 QPYcom 实例）后重试。
Q3：VSCode 插件搜索不到？
A：检查 VSCode 版本是否过旧；或在插件市场切换到官方源。也可以直接从插件商店网页版跳转安装。
Q4：能不能只用 VSCode 完成全部流程？
A：写代码、调试可以，但固件烧录必须用 QPYcom。所以 QPYcom 是绕不开的。
下一篇
第 4 篇：固件烧录——把模组变成 QuecPython 开发板
这是整个流程里最容易出错的一步：固件格式选错、下载模式选错、烧到一半失败……一篇讲透。