Trouble getting started on ESP-IDF extension of VSCode

quarterstablemind
Posts: 1
Joined: Wed Apr 15, 2026 12:30 am

Trouble getting started on ESP-IDF extension of VSCode

Postby quarterstablemind » Wed Apr 15, 2026 1:02 am

Hello everyone

This is my first time using the ESP-IDF extension and after trying to follow the steps on the installation guide and watching a couple of Youtube tutorials, I keep getting these error messages/notifications which I can't fix or find the workaround for. I will put pictures of the error messages below.

To be more specific, this problem occurs after installing the ESP-IDF extension from the extensions tab in VSCode and clicking the "Activate Anyway" button in the notification that shows up once I try to open the ESP-IDF Installation Manager.

If anyone else had the same issue and already solved it or if anyone can tell me what these error messages mean, your help will be much appreciated.

Thanks
Attachments
Screenshot 2026-04-14 175912.png
Screenshot 2026-04-14 175912.png (12.22 KiB) Viewed 156 times
vscode error.png
vscode error.png (33.63 KiB) Viewed 156 times

bignacio
Espressif staff
Espressif staff
Posts: 255
Joined: Wed May 02, 2018 12:12 pm

Re: Trouble getting started on ESP-IDF extension of VSCode

Postby bignacio » Wed Apr 15, 2026 4:57 am

Many third party tutorials or YouTube videos might be outdated to the current way of using the extension.

Please follow the official documentation here:

https://docs.espressif.com/projects/vsc ... index.html

Also please share the troubleshooting information as described here:

https://docs.espressif.com/projects/vsc ... oting.html

My guess is that there is an issue with the way you configured the extension.

radurentea
Espressif staff
Espressif staff
Posts: 26
Joined: Thu Mar 09, 2023 8:30 am

Re: Trouble getting started on ESP-IDF extension of VSCode

Postby radurentea » Wed Apr 15, 2026 11:42 am

Hi quarterstablemind,

This is a known issue with the activation for the v2.0.2 of the extension and will get fixed with the next release. The issue happens when you have a non esp-idf project folder open inside VS Code.

The workaround is to just open a new window of VS Code (File > New Window) and try to run the "ESP-IDF: Open ESP-IDF Installation Manager" and it should work.

Sorry for the inconvenience!

Who is online

Users browsing this forum: No registered users and 0 guests