十分钟搞定！PyCharm MicroPython环境搭建（含 miniconda 隔离 + 烧录配置）

PyCharm

PyCharm 是一款非常好用的 Python IDE，由 JetBrains 开发而成，支持 Windows、Max、Linux 操作系统。 PyCharm 针对每个平台都有 Professional 和 Community 两个版本，自己可根据自己的需要进行选择：

Professional：专业版（建议选择专业版），功能强大，属于收费版

Community：社区版，只支持 Python 开发，开源、免费，用作学习也够用

这里，我们使用社区版即可，关于 PyChram 的下载安装和汉化插件安装可查看如下链接：

（超详细）Python+PyCharm 的安装步骤及 PyCharm 的使用（含快捷键）

PyCharm 汉化

1.MicroPython 插件

1.1 MicroPython 插件的在线安装

首先新建一个文件夹，这里我的命名为：

F:elegance-devkit v1Demo0 PicoTest

点击鼠标右键，选择：Open Folder as PyCharm Project

把 Open Folder as PyCharm Project 添加到右键菜单打开文件夹
https://www.bianchengbaodian.com/article/e02e05369cb5d3868fe4d7ddc7e1989e.html

点击-文件-设置：

点击插件[Plugins] ，在”Search”编辑框输入：micropython，使用该插件可以完成代码编辑、程序烧录和运行 REPL 等工作：

点击 Install 安装插件，安装完成后点击-重启 IDE：

鼠标右键文件夹，点击新建-新建 Python 文件：

新建一个 main.py 文件：

这里，我们首先使用 miniconda 新建一个名为 MicroPython_Learn 的环境，这里我们使用的 Python 版本是 Python 3.12.3：

miniconda3 介绍、安装、使用教程

https://blog.csdn.net/weixin_43828245/article/details/124768518

接下来我们返回 PyCharm 界面，点击右下角添加我们当前工程的解释器：

选择虚拟环境选项，点击“现有”选项，点击解释器一栏中右边三个点的按钮，选择虚拟环境安装路径中的 python.exe 文件，点击确定：

可以看到 IDE 中右下角出现了当前虚拟环境的名称，表示添加解释器成功：

接下来，再次点击-文件-设置，点击“语言和框架”-MicroPython，勾选“Enable MicroPython support”选项，在设备类型中选择树莓派 Pico，在设备路径中输入“COM3”：

接着，我们在命令行中使用 pip 命令安装 adafruit-ampy 工具：

pip install adafruit-ampy==1.0.5

https://www.pypi.com.cn/project/adafruit-ampy/

使用 PyCharm 进行 MicroPython 开发需要的一些库和库版本信息如下：

至此，我们完成了 PyCharm IDE 树莓派 Pico MicroPython 开发环境设置。接下来，我们测试一下使用 PyCharm 进行程序的烧录和运行，在 main.py 中复制如下代码：

# Python env   : MicroPython v1.23.0
# -*- coding: utf-8 -*-        
# @Time    : 2024/6/10 下午6:52
# @Author  : 李清水
# @File    : main.py
# @Description : 测试PyCharm MicroPython环境配置的文件，成功运行则树莓派Pico的LED闪烁

# ======================================== 导入相关模块 ========================================

# 硬件相关的模块
from machine import Pin
# 时间相关的模块
import time

# ======================================== 全局变量 ============================================

# ======================================== 功能函数 ============================================

# ======================================== 自定义类 ============================================

# ======================================== 初始化配置 ==========================================

# 上电延时3s
time.sleep(3)
# 打印调试消息
print("FreakStudio: MicroPython Pico Test")

# class machine.Pin(id, mode=-1, pull=-1, *, value=None, drive=0, alt=-1)
# 设置25号引脚为正常输出，25号引脚连接了板载的LED灯
# 创建一个machine.Pin实例，实例名称为led
led: Pin = Pin(25, Pin.OUT)

# ========================================  主程序  ============================================

# 以下代码循环执行，LED灯闪烁
while True:
    # 给引脚设置高电平：LED点亮
    led.on()
    # REPL输出"LED ON"
    print("LED ON")
    # 延时等待1s
    time.sleep(1)
    # 给引脚设置低电平：LED熄灭
    led.off()
    # REPL输出"LED ON"
    print("LED OFF")
    # 延时等待1s
    time.sleep(1)

此代码在配套资料的文件夹：elegance-devkit v1Demo0 PicoTest 中。

之后，我们需要修改 main.py 文件的运行配置，右击 Project 工程窗口中的[main.py]会显示一个快捷菜单，在该菜单中选取 [Modify Run Configuration…]修改运行配置，弹出“Edit Run Configuration“编辑运行配置对话框。

在”Name“编辑框中输入 Flash 程序文件名，这里输入 Flash main.py，点击应用按钮，然后再点击确认按钮。

也可以在右上角的位置进行运行配置的编辑：

点击右上角绿色箭头，开始运行 MicroPython 程序：

在“运行”终端可以看到程序下载的进度：

可以看到 Pico 开发板上的绿色 LED 灯闪烁，间隔时间为 1s，在命令行打开 mpremote，可以看到不断输出代码中的调试信息：

当我们不想树莓派 Pico 开发板执行这段程序时，可以在 Pycharm IDE 的工具选项中-MicroPython 点击 Remove All Files from MicroPython Device，移去 Pico 中烧录的程序：

也可以在命令行中，打开 mpremote 远程连接工具后，按下 ctrl+c 按键：

我们也可以在 PyCharm 中，连接树莓派 Pico 的 REPL：

1.2 MicroPython 插件的离线安装

该插件在 2025 年后已经无法使用，在插件框中无法搜索到，但我们还是可以通过离线方式进行安装：

https://plugins.jetbrains.com/plugin/9777-micropython/versions/stable

从 JetBrains Marketplace 找到 MicroPython 插件页面（如图 1），选择适配你当前 PyCharm 版本的插件版本（比如图中 1.4.6-2024.2 对应 PyCharm 2024.2 系列），点击 “Download” 下载插件的 ZIP 压缩包（保存到本地文件夹）：

在 PyCharm 中点击顶部菜单栏的「文件」「设置」（或按快捷键 Ctrl+Alt+S）：

在设置界面左侧栏选择「插件」，点击右上角的齿轮图标，在下拉菜单中选择「从磁盘安装插件」：

在弹出的文件选择窗口中，找到之前下载好的 MicroPython 插件 ZIP 包并选中，点击「确定」：

插件会自动完成安装，安装完成后界面会显示 “重启 IDE” 按钮（如图 8），点击该按钮重启 PyCharm，插件即可生效。

2.MicroPython Tool 插件

2025 年 PyCharm 完成社区版与专业版的整合后，其插件系统进行了轻量化调整，原有的 MicroPython 插件被官方优化升级为 MicroPython Tool（整合了原插件的核心功能 + PyCharm 新特性），成为适配新版本 PyCharm 的官方推荐 MicroPython 开发插件，功能更统一、兼容性更强：

进入 IDE：

接下来我们进行插件的安装：

打开整合后的 PyCharm，点击顶部菜单栏的「File」（文件）→「Settings」（设置，快捷键 Ctrl+Alt+S）；在左侧导航栏中选择「Plugins」（插件），此时会进入 PyCharm 的插件市场；在搜索框中输入 MicroPython Tool，找到对应的插件。

安装之后，将 MicroPython 开发板（ESP32/ESP8266/Raspberry Pi Pico/STM32 等）通过 USB 线连接到电脑打开插件，在弹出的配置窗口中，选择连接方式：

Serial Port：选择开发板对应的串口（如 COM3），设置波特率（默认 115200，多数开发板通用）;

WebREPL：若开发板已连接 WiFi，输入开发板的 IP 地址、端口（默认 23）、用户名和密码（若有）。

这个 MicroPython Tools 设置界面里的其他选项，作用分别是这样的（按区域说明）：

• 顶部总开关：

Enable MicroPython support

• ，这是 MicroPython 功能的总开关，勾选后 PyCharm 才会启用所有 MicroPython 相关的功能（比如串口连接、代码上传、REPL 终端等）；不勾选的话，插件等于没激活。Connection（连接设置区）Type：Serial / WebREPL

Serial：选这个是用串口线连接开发板（最常用的方式，比如 USB 连 ESP32/Pico）；

WebREPL：选这个是用无线 Web 交互终端连接（需要开发板先开启 WebREPL 功能，适合无串口线的场景）。

Edit port manually：勾选后可以手动输入串口端口号（默认是自动识别可用端口，若自动识别不准时可以手动填，比如 COM4 改成 COM5）。Filter out devices with unknown manufacturers：过滤掉 “厂商未知” 的设备，避免把电脑上无关的串口设备（比如某些 USB 设备的虚拟串口）识别成开发板，减少干扰。Install or update MicroPython firmware：这是安装 / 更新开发板固件的入口，点击后可以给开发板刷入最新的 MicroPython 系统固件。Communication Settings（通信设置区）带 PRO 标的选项，是原专业版功能（现在 PyCharm 合并后，部分功能可能需订阅解锁）：

Background uploads/downloads：开启后，代码上传 / 下载会在后台运行，不影响你同时写代码。

Compress uploads：开启后会压缩代码文件再上传，能加快大文件的上传速度。

Enable legacy volume support (pre-1.25.0)：兼容 1.25.0 版本之前的旧 MicroPython 固件的存储功能（如果你的开发板固件是很老的版本，才需要勾这个）。Show upload preview dialog：上传代码前，会弹出文件预览对话框，显示要上传的文件列表，确认后再上传，避免传错文件。MicroPython Type Hints（类型提示区）

Enable MicroPython type hints：开启后，PyCharm 会提供 MicroPython 专属的代码补全、语法检查（比如写 machine.Pin 时会自动提示参数）。

No stub package selected + 下方的 stubs 包：“stubs 包” 是存储 MicroPython API 类型信息的文件，选对应的 stubs 包（比如图里的 microPython-mimxrt...stubs），能让代码提示更精准（适配特定开发板的 API）。

在下方 File System 面板中，是开发板内部文件的 “管理界面”，能直接查看、操作已连接开发板里存储的所有文件（比如图里的 main.py、dht22.py 这些是开发板里的代码文件）：

查看文件：面板里会列出开发板当前的所有文件 / 文件夹（包括大小、名称），刷新按钮（循环箭头图标）可同步最新的文件列表；

上传文件：点击 “上传图标”（通常是向上箭头），可把本地 PyCharm 里的文件 / 文件夹

传到开发板（比如把写好的 main.py 传到开发板运行）；

下载文件：选中开发板里的某个文件，点击 “下载图标”（向下箭头），可把开发板的文件保存到本地（比如备份开发板里的代码）；

删除文件：选中文件后点 “垃圾桶图标”，可删除开发板里的冗余文件（注意：删错会丢失代码，谨慎操作）；

其他操作：右键点击文件，还能做重命名、新建文件夹等基础文件管理。

REPL 是开发板的 “实时命令行”，连接成功后会显示开发板的 MicroPython 版本（图里显示 MicroPython v1.26.1 on Raspberry Pi Pico），可以直接输入代码并立即执行，是快速调试硬件、测试代码片段的工具。

顶部的 “当前文件” 菜单，是进入 “运行 / 调试配置” 的入口，后续烧录文件的核心配置，就是从这里启动的。

这是 “运行 / 调试配置” 的创建界面，是烧录文件的前置操作：

1. 点击顶部 “当前文件”→ 选择 “编辑配置”，弹出 “运行 / 调试配置” 窗口；点击窗口左上角的 “+ 号（添加）”→ 选择 “MicroPython Tools”，会出现 3 个功能选项：

Upload：将文件 / 项目烧录（上传）到开发板（这是你需要的 “烧录” 功能）；

Execute：上传文件后，直接在开发板上执行该文件；

Compile：先把 Python 代码编译为 MicroPython 字节码（.mpy 格式，更省开发板空间、运行更快），再上传。

1. 这是烧录单文件 / 多文件的核心配置界面，配置完成后就能执行烧录：

选择烧录范围（Type 选项）：

Project：烧录整个项目的所有文件（适合多文件项目）；

Selected MPY sources roots：只烧录你选中的部分文件 / 文件夹（适合单文件或局部文件）；

Custom path：自定义要烧录的文件路径。

烧录辅助选项：

Reset on success：烧录成功后自动重启开发板（让代码立即运行）；

Switch to REPL tab on success：烧录完成后自动切换到 REPL 终端，方便立即调试代码。

• • 这是 “Compile Project（编译项目）” 的配置界面（不是直接烧录，是烧录的优化步骤）：

Type 选 Project：编译整个项目的所有文件（多文件）；选 Selected MPY：只编译你指定的部分文件；

底部的 “MicroPython support was not enabled for this project” 是关键错误：必须先为当前项目启用 MicroPython 支持，否则无法配置烧录 / 编译。