PlatformIO+VSCode中ESP-IDF框架编译WiFi.h缺失问题求助

核心原因 #

你当前使用的是ESP-IDF框架，但代码是基于Arduino框架编写的，且安装的是Arduino生态的WiFi库，两者不兼容，导致编译时找不到WiFi.h。

方案1：切换到Arduino框架（最简单直接） #

修改platformio.ini配置，将框架从espidf改为arduino，并移除不必要的库依赖：

; PlatformIO Project Configuration File
[env:nodemcu-32s]
platform = espressif32
board = nodemcu-32s
framework = arduino
; 移除lib_deps，Arduino框架下ESP32的WiFi库是自带的

修改后重新编译即可，原代码无需改动——Arduino框架下ESP32原生支持WiFi.h及相关API。

方案2：适配ESP-IDF框架（保留原框架） #

若必须使用ESP-IDF框架，需要完全重构代码，替换Arduino相关API为ESP-IDF原生组件：

• 移除#include <WiFi.h>，改用ESP-IDF的WiFi组件头文件：#include "esp_wifi.h"、#include "esp_event.h"
• 替换WiFi.begin()、WiFi.localIP()等Arduino WiFi API为ESP-IDF的esp_wifi_init()、esp_wifi_connect()等函数
• 替换WiFiServer为ESP-IDF的esp_http_server组件实现网页服务器
• 替换millis()为ESP-IDF的esp_timer_get_time()或vTaskDelay()等时间管理API

这种方式需要熟悉ESP-IDF的编程模型，适合对ESP-IDF有基础的开发者。

内容的提问来源于stack exchange，提问作者Kifsif