ESP-IDF 常见问题

六、常见问题

• ESP-IDF 和 Arduino 怎么选？做产品选 IDF，做实验和教学 Arduino 更快。两者甚至可以混用（在 IDF 工程里引入 Arduino 组件），但会增加构建复杂度。
• 编译很慢怎么办？用 ccache 缓存编译结果；只改一个组件时 IDF 已经支持增量编译；换 SSD 与多核机器也有帮助。
• sdkconfig 要不要提交？通常提交 sdkconfig.defaults，sdkconfig 由它生成；团队协作时这样最不容易冲突。
• 内存不够怎么办？用 idf.py size-components 看各组件占用；把大缓冲区改成动态分配并从 PSRAM 分配（若芯片支持）；关闭不用的协议栈。
• 串口监视器里中文乱码怎么办？确认终端与监视器的编码一致，日志内容用英文最省事。
• 具体的安装脚本参数、菜单路径、API 名称以乐鑫官方文档（docs.espressif.com 的 ESP-IDF 编程指南）为准，版本间存在差异。