esp-idf 默认禁用 c++ 异常和 rtti，需手动添加 -fexceptions -frtti 编译标志；freertos 任务中禁止栈上构造长生命周期 c++ 对象；不可使用 std::thread/std::async，应改用 xtaskcreate。
ESP-IDF 默认不支持 C++ 异常和 RTTI，必须手动开启
ESP-IDF 默认禁用 C++ 异常（exceptions）和运行时类型信息（RTTI），因为它们会显著增加代码体积和内存开销。但很多现代 C++ 库（如 std::function、std::shared_ptr、第三方异步库）依赖这两项特性。若不显式启用，编译会通过，但运行时调用 throw 或 dynamic_cast 会导致硬复位或不可预测行为。
实操建议：
- 在项目根目录的
CMakeLists.txt中，在set(CMAKE_CXX_STANDARD 17)后添加：set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fexceptions -frtti") - 确保所有子组件（包括自定义组件）也继承该标志，可在组件级
CMakeLists.txt中重复设置，或统一在项目顶层project.cmake中配置 - 注意：启用后
idf.py size-components显示的.text大小通常增加 8–15 KB；若 Flash 空间紧张，应避免在中断服务程序（ISR）中抛出异常
FreeRTOS 任务与 C++ 对象生命周期必须严格对齐
在 ESP32 上，C++ 对象若在 FreeRTOS 任务函数内栈上构造（如 void task_func(void*) { MyService svc; ... }），任务退出后对象自动析构——但此时任务栈已被回收，svc 的析构函数可能访问非法内存，引发 Guru Meditation 错误。
实操建议：
- 所有需跨任务生命周期的对象，必须堆分配并显式管理：使用
new+delete，或更安全地用std::unique_ptr（需已启用 exceptions/RTTI） - 任务函数本身应为
static或全局函数，不能是类成员函数；若需绑定对象，用static_cast将void*参数转回指针：static void wifi_task(void* arg) { auto* svc = static_cast<mywifiservice>(arg); svc->run_loop(); }</mywifiservice> - 在任务删除前（
vTaskDelete）务必先调用对象清理逻辑，例如关闭网络连接、注销事件回调，否则可能触发悬空指针访问
std::thread 和 std::async 在 ESP-IDF 中不可用，必须用 xTaskCreate
ESP-IDF 基于 FreeRTOS，不提供 POSIX 线程兼容层。std::thread 在 ESP-IDF 工具链中被禁用，链接时会报错 undefined reference to 'pthread_create'；std::async 同样失效。试图绕过会破坏调度器稳定性。
实操建议：
- 用
xTaskCreate或其 C++ 封装（如esp_pthread_create）创建任务，传参统一用void*指针 - 可封装轻量级 RAII 任务句柄类，例如：
class TaskHandle { public: explicit TaskHandle(TaskHandle_t h) : handle_(h) {} ~TaskHandle() { if (handle_) vTaskDelete(handle_); } private: TaskHandle_t handle_; }; - 避免在任务中直接使用
std::cout或std::cerr：改用ESP_LOGI/ESP_LOGE；重载operator 到日志宏需谨慎，防止格式化开销阻塞高优先级任务
WiFi/Bluetooth 初始化失败时，错误码映射不直观，需查 IDF 版本对应表
ESP-IDF 的 WiFi API（如 esp_wifi_start()）返回 esp_err_t，不是标准 C++ std::error_code。常见错误如 ESP_ERR_WIFI_NOT_INIT 表示未调用 esp_netif_init() 和 esp_event_loop_create()，但错误信息本身不提示缺失步骤。
实操建议：
- 初始化顺序必须严格遵循文档：先
esp_netif_init()→esp_event_loop_create()→esp_netif_create_default_wifi_ap()或_sta()→wifi_init_config_t配置 →esp_wifi_init() - 每个关键 API 调用后加检查：
auto err = esp_wifi_start(); if (err != ESP_OK) { ESP_LOGE("WIFI", "start failed: %s", esp_err_to_name(err)); } - 注意 IDF v5.0+ 移除了部分旧宏（如
WIFI_MODE_NULL），改用WIFI_MODE_MAX；升级框架时务必核对esp_wifi_types.h中枚举值变更
C++ 在 ESP-IDF 上的可靠性，不取决于语法多“现代”，而在于每一步是否与 FreeRTOS 内存模型、启动顺序、错误传播路径对齐。最容易被忽略的是：WiFi 事件回调函数里调用的 C++ 成员函数，其所属对象可能已在别处被 delete，但事件队列尚未消费完该回调——这时需要引用计数或弱指针保护，而不是靠 try-catch。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
