PROVIDER - 即插即用的教育向硬件 Python

CircuitPython

CircuitPython 2017 年从 MicroPython 分叉,把开发板变成插上即改的 U 盘并内置 USB HID,配套 300 余种板型与统一库包;它把入门门槛降到最低,代价是性能、内存与部分高级外设能力。

编程语言与框架 美国 2026.11.19
3.6分

详细说明

优势 5 项

2017 年由 Adafruit 从 MicroPython 分叉,专注教育与「插上就能改代码」的体验
板子插入电脑后自动出现为 U 盘,编辑 1 个 code.py 保存即自动重启执行,无需任何工具
内置 USB HID 能力,可把开发板变成键盘、鼠标、游戏手柄或 MIDI 等 4 类设备
官方支持 300 余种开发板,配套 CircuitPython 库包按版本统一分发
全部代码与库开源,把 1 个 .py 文件拷入 lib 目录即可调用,方便教学与二次开发

不足 4 项

为易用性牺牲性能与内存:GC 与文件系统开销更大,复杂逻辑容易触发内存不足
与 MicroPython 分叉后 API 有差异,跨生态移植需要改动
高级外设(CAN、USB Host、低功耗深度睡眠)支持有限
生产部署需要关掉 USB 存储写入等便利功能,配置更接近传统固件

服务商概述

CircuitPython 于 2017 年由 Adafruit 从 MicroPython 分叉而来,目标不是做通用嵌入式运行时,而是把「插上就能改」做到极致:开发板连接电脑后出现为一个 U 盘,里面有一个 code.py,改完保存即自动重启执行。

在编程语言与框架分类里,它代表「教育优先」的硬件 Python 路线:内置 USB HID、统一库包、300 余种板型支持,让没有工具链经验的人也能在几分钟内让硬件动起来。

核心优势

  • 零工具链:不需要装 IDE 或编译器,文本编辑器改 code.py 即可,学生上手最快
  • USB HID 原生能力:开发板可直接充当键盘、鼠标、手柄或 MIDI 设备
  • 库包统一:按 CircuitPython 版本发布库包,lib 目录拖入即可用
  • 板型覆盖广:官方固件支持 300 余种开发板,含 ESP32-S2/S3、RP2040、nRF52、SAMD
  • 错误提示友好:语法与运行时错误会输出到串口并以文件形式提示,便于教学排查

产品生态

固件与板型

circuitpython.org/downloads 列出全部受支持板型并按芯片家族分类。

库

Adafruit 维护的 CircuitPython 库包覆盖传感器、显示屏、电机与网络,按版本发布。

工具

Mu Editor、Thonny 与 VS Code 插件提供串口与文件同步;circup 可批量更新库。

不足之处

  • 性能与内存开销大于 MicroPython:文件系统与 GC 更重,复杂逻辑易触发 MemoryError
  • 与 MicroPython 分叉后 API 差异明显,两个生态的库不能直接互换
  • 高级外设支持有限:CAN、USB Host、深度睡眠等场景常需回到 C 或 MicroPython
  • 量产配置繁琐:需要关闭 USB 写入与自动重载,才能接近传统固件的行为

适用场景

  • 教学与创客工作坊(★★★★★):插上即用,不需要环境配置
  • 快速硬件原型(★★★★):传感器与显示屏代码量极小
  • USB HID 小工具(★★★★):把板子变成键盘或手柄
  • 量产与硬实时(★★):建议 C/C++ 或 Rust

价格参考

项目 价格 说明
CircuitPython 固件 $0 开源(MIT),可自由使用
开发板 按型号 Adafruit 原板与兼容板价差较大
库包 $0 官方与社区库均开源

成本集中在硬件;教学场景建议选带 USB 与传感器齐全的入门板。

常见问题

  • 和 MicroPython 该选哪个? 教学、快速原型、需要 U 盘式更新选 CircuitPython;需要更完整的模块覆盖与性能选 MicroPython。
  • 为什么我的板子报 MemoryError? 常见原因是同时 import 太多库或建了大数组,可精简库、改用 displayio 分块刷新,或换内存更大的板型。
  • 能连 Wi-Fi 吗? 支持,ESP32-S2/S3 与 Pico W 等板型可用 wifi 与 socketpool 模块。相关网络项目可参考编程语言与框架里的 MicroPython。

代码示例

code.py:板载 LED 呼吸与按键

import board, digitalio, time

led = digitalio.DigitalInOut(board.LED)
led.direction = digitalio.Direction.OUTPUT
button = digitalio.DigitalInOut(board.BUTTON)
button.switch_to_input(pull=digitalio.Pull.DOWN)

while True:
    if button.value:
        led.value = True
    else:
        led.value = False
    time.sleep(0.05)

board 模块按板型自动映射引脚名,换板时通常只改这一处。

作 USB HID 键盘

import time
import usb_hid
from adafruit_hid.keyboard import Keyboard
from adafruit_hid.keycode import Keycode

kbd = Keyboard(usb_hid.devices)
time.sleep(1)
kbd.send(Keycode.CONTROL, Keycode.ALT, Keycode.DELETE)

把板子插到电脑上,它就会被识别成键盘设备。

社区与资源

前往 CircuitPython 官网 → https://circuitpython.org/
访问官网 ↗