PlatformIO下Pi Pico W引入WiFi.h编译失败，求解决方法

问题根源 #

核心问题是platform.ini中指定的board为普通pico而非pico_w，导致平台未加载Pico W专属的WiFi硬件驱动与依赖库，进而出现QSPIFBlockDevice.h缺失、WiFiAccessPoint未定义等错误。另外直接指定lib_deps = WiFi会拉取通用WiFi库，并非适配Pico W的版本。

修正方案：更新platform.ini配置 #

将platform.ini修改为以下内容，确保适配Pico W并加载正确的WiFi库：

[env:pico_w]
platform = raspberrypi
board = pico_w
framework = arduino
lib_deps = 
    arduino-libraries/WiFi@^1.2.7

• board = pico_w：明确指定硬件为带WiFi的Pico W，平台会自动引入对应的硬件支持文件
• 指定的WiFi库是Arduino官方适配RP2040系列的版本，包含Pico W所需的所有依赖

验证用WiFi连接代码 #

替换为以下标准测试代码，确保编译通过并实现WiFi连接：

#include <WiFi.h>

// 替换为你的WiFi信息
const char* WIFI_SSID = "你的WiFi名称";
const char* WIFI_PASS = "你的WiFi密码";

void setup() {
  Serial.begin(115200);
  delay(1000);

  Serial.print("连接WiFi: ");
  Serial.println(WIFI_SSID);
  WiFi.begin(WIFI_SSID, WIFI_PASS);

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println("\nWiFi连接成功");
  Serial.print("IP地址: ");
  Serial.println(WiFi.localIP());
}

void loop() {
  // 可添加后续业务逻辑
}

替代方案：使用Pico SDK原生实现 #

若不想依赖Arduino框架，可直接使用Raspberry Pi官方Pico SDK，通过lwIP栈实现WiFi连接：

1. 在platform.ini中切换为Pico SDK框架：

[env:pico_w]
platform = raspberrypi
board = pico_w
framework = pico-sdk

2. 核心WiFi初始化代码示例（基于SDK）：

#include <stdio.h>
#include "pico/stdlib.h"
#include "pico/cyw43_arch.h"

// 替换为你的WiFi信息
#define WIFI_SSID "你的WiFi名称"
#define WIFI_PASS "你的WiFi密码"

int main() {
    stdio_init_all();
    if (cyw43_arch_init()) {
        printf("WiFi初始化失败\n");
        return 1;
    }
    cyw43_arch_enable_sta_mode();
    printf("连接WiFi: %s\n", WIFI_SSID);
    if (cyw43_arch_wifi_connect_timeout_ms(WIFI_SSID, WIFI_PASS, CYW43_AUTH_WPA2_AES_PSK, 30000)) {
        printf("WiFi连接失败\n");
        return 1;
    }
    printf("WiFi连接成功\n");
    
    while (true) {
        cyw43_arch_wait_for_work_until(make_timeout_time_ms(1000));
        // 循环逻辑
    }
    cyw43_arch_deinit();
    return 0;
}

内容的提问来源于stack exchange，提问作者João