VS Code + ESP-IDF: el entorno oficial con JTAG incluido

Si has decidido usar ESP-IDF, la extensión oficial para VS Code te da lo mejor de los dos mundos: la comodidad de un editor moderno y depuración por JTAG de verdad.

Instalación

1. En VS Code, instala la extensión ESP-IDF (de Espressif).
2. Ejecuta el setup wizard (icono de ESP-IDF → Setup). La extensión descarga ESP-IDF, el toolchain y Python.
3. Elige la versión: hoy ESP-IDF 6.1.

Tarda bastante porque baja todo (ESP-IDF es grande). Es normal.

Crear un proyecto

ESP-IDF: New Project → plantilla (sample_project, blink…), nombre y chip. La estructura es la de ESP-IDF:

mi-proyecto/
├── CMakeLists.txt
├── sdkconfig
└── main/
    ├── CMakeLists.txt
    └── main.c

menuconfig desde VS Code

ESP-IDF: SDK Configuration Editor abre menuconfig en una vista web integrada: cambias opciones, buscas por texto y guarda el sdkconfig. Mucho más cómodo que la terminal.

Compilar, flashear y monitorizar

En la barra inferior tienes los botones:

• Build, Flash, Monitor y Build + Flash + Monitor.
• Selección de puerto serie y velocidad de monitor.
• Selección de target (esp32, esp32s3, esp32c3…).

Equivale a:

idf.py build
idf.py -p /dev/ttyUSB0 flash monitor

Depuración por JTAG

Aquí está la joya. Con una placa ESP32-S3/C3 (y su USB nativo) o una sonda externa, tienes puntos de ruptura, step over, inspección de variables y pila de llamadas — sin printf.

En ESP-IDF se configura con idf.py openocd y la extensión lo integra. Es de las cosas que más tiempo ahorran cuando un bug no se deja ver.

Extensiones que pegan bien

• C/C++ (IntelliSense) — la extensión la configura.
• clang-format — formato automático al guardar.
• Error Lens — errores en línea, sin abrir la consola.

Cuándo elegirlo

• Sí: vas en serio con ESP-IDF, quieres menuconfig cómodo y depurar por JTAG.
• No: si usas Arduino o MicroPython (no aplica) o si te vale la línea de comandos.

Resumen

• La extensión ESP-IDF instala el SDK y el toolchain por ti.
• menuconfig integrado, con búsqueda.
• Botones de build/flash/monitor y selección de chip y puerto.
• JTAG para depurar de verdad (S3/C3 o sonda externa).
• Versión actual de ESP-IDF: 6.1.

Siguiente paso: el bloque práctico: parpadea un LED con lo que ya tienes montado. O vuelve al hub de la serie.