Page 1 of 1

Trouble getting started on ESP-IDF extension of VSCode

Posted: Wed Apr 15, 2026 1:02 am
by quarterstablemind
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

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

Posted: Wed Apr 15, 2026 4:57 am
by bignacio
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.

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

Posted: Wed Apr 15, 2026 11:42 am
by radurentea
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!