Confirm your board
Check the exact label: Pico W, Pico 2 W, ESP32-S3 and ESP32-C3 are not interchangeable.
Install the VS Code extension, connect a supported MicroPython board, open its REPL and run a small script. Debugging is an optional next step and needs board-specific firmware.
For Windows, macOS and Linux with VS Code. The VSIX is the public approved release; commits merged to main do not automatically appear in the Marketplace.
Start with the normal USB serial connection. It is independent of optional Wi-Fi/WebREPL and of the frozen debugger.
Install MicroPython Studio in VS Code from the Marketplace. Alternatively, open the Command Palette and choose Extensions: Install from VSIX… after downloading the verified stable file above.
Use a USB data cable, not a charging-only lead. Check that the serial device appears in your operating system. Start with the board's own supported MicroPython firmware; do not flash a debugger image until you have confirmed the exact model.
In VS Code, press Ctrl + Shift + P (or the Command Palette shortcut on your OS) and run MicroPython: Setup Development Environment. Then choose MicroPython: Create New Project or open an existing project.
Choose the board's USB REPL serial port and run MicroPython: Open Device Shell. You should see a >>> prompt. Try this:
import sys
print(sys.platform)
print("MicroPython Studio connected")
Save a file such as hello.py and use MicroPython: Run Script on Device. When that works, try MicroPython: Refresh Device Files to browse the board.
from machine import Pin
import time
print("Hello from MicroPython Studio")
for count in range(3):
print("Loop", count)
time.sleep(0.5)
Source breakpoints, stepping, locals, call stacks and runtime tracing need a compatible board-specific debugger image and a separate debugger transport. Do not select the same serial COM port for both REPL and debugger.
Check the exact label: Pico W, Pico 2 W, ESP32-S3 and ESP32-C3 are not interchangeable.
Choose a hardware-tested release only for its matching board. Preview firmware requires an explicit test plan.
Use the board-specific REPL and debugger ports. Start with a basic breakpoint before testing RTA.