ESP-IDF extension in VS Code - idf.py not recognized
Posted: Sun Dec 07, 2025 5:53 pm
Hi all,
I'm sure I'm doing something stupid but every time I try to use the ESP-IDF extension in VS Code it seems to be overly complicated!
I'm new to VS Code (which I find overly complicated in the first place, but that's a gripe for another time) and don't consider myself to be too much of a moron, but there seem to be so many little gotchas and settings files and tweaks that need to be made to get it to work properly when what I was hoping for was 'out-of-the-box' full functionality.
Anyway, I digress. My setup is that I have installed VS Code on my Win 11 computer, then installed and configured the ESP-IDF extension (choosing all default values). For clarity, I have not installed anything else ESP-IDF related on my computer - am I supposed to? It's not mentioned in the extension installation instructions that I have to do that, but some people elsewhere talk about installing the ESP-IDF framework. I had assumed that the VS Code extension would install everything I need. Is that wrong?
The issue I'm currently facing is that I've created a new project (workspace?) and written a custom class (cpp and h files) and am trying to include the class in my main.c file but the #include line has a red squiggle under it. When I ask the AI for help it says that my c_cpp_properties.json has an issue with my environment variables and recommends running some idf.py commands in the Terminal.
Firstly, why are there issues with my environment variables, given that I've left everything default? Shouldn't these be set correctly on installation of the extension?
Secondly, when I try to run 'idf.py fullclean' in the terminal I get the error "idf.py : The term 'idf.py' is not recognized as the name of a cmdlet, function, script file, or operable program." Why do I get this error? Shouldn't idf.py be installed and configured correctly as part of the setup?
Am very confused and quite frustrated with this so would be very thankful for any help anyone can give.
Thanks!
I'm sure I'm doing something stupid but every time I try to use the ESP-IDF extension in VS Code it seems to be overly complicated!
I'm new to VS Code (which I find overly complicated in the first place, but that's a gripe for another time) and don't consider myself to be too much of a moron, but there seem to be so many little gotchas and settings files and tweaks that need to be made to get it to work properly when what I was hoping for was 'out-of-the-box' full functionality.
Anyway, I digress. My setup is that I have installed VS Code on my Win 11 computer, then installed and configured the ESP-IDF extension (choosing all default values). For clarity, I have not installed anything else ESP-IDF related on my computer - am I supposed to? It's not mentioned in the extension installation instructions that I have to do that, but some people elsewhere talk about installing the ESP-IDF framework. I had assumed that the VS Code extension would install everything I need. Is that wrong?
The issue I'm currently facing is that I've created a new project (workspace?) and written a custom class (cpp and h files) and am trying to include the class in my main.c file but the #include line has a red squiggle under it. When I ask the AI for help it says that my c_cpp_properties.json has an issue with my environment variables and recommends running some idf.py commands in the Terminal.
Firstly, why are there issues with my environment variables, given that I've left everything default? Shouldn't these be set correctly on installation of the extension?
Secondly, when I try to run 'idf.py fullclean' in the terminal I get the error "idf.py : The term 'idf.py' is not recognized as the name of a cmdlet, function, script file, or operable program." Why do I get this error? Shouldn't idf.py be installed and configured correctly as part of the setup?
Am very confused and quite frustrated with this so would be very thankful for any help anyone can give.
Thanks!