告别复杂存储操作：Arduino-ESP32轻松掌握文件创建、读写与删除

你是否还在为ESP32开发中的文件管理烦恼？从配置存储到数据记录，文件操作是物联网项目的必备技能。本文将带你零基础掌握FFat与SD卡两种存储方案，通过3个实用场景示例，让你10分钟内实现文件创建、内容读写和安全删除。

存储方案选择：FFat vs SD卡

Arduino-ESP32提供两种主流文件系统解决方案，适用于不同场景需求：

方案	特点	适用场景	核心库文件
FFat	基于闪存的虚拟文件系统，无需额外硬件	配置文件、小型日志	libraries/FFat/src/FFat.h
SD_MMC	支持高速SD/SDHC卡，容量可达2TB	视频存储、大数据采集	libraries/SD_MMC/src/SD_MMC.h

FFat文件系统初始化

FFat使用片上闪存，初始化仅需一行代码：

#include "FFat.h"

void setup() {
  Serial.begin(115200);
  
  // 初始化FFat，失败时自动格式化
  if(!FFat.begin(true)){
    Serial.println("FFat挂载失败，请检查分区配置");
    return;
  }
  
  Serial.printf("总空间: %d KB\n", FFat.totalBytes()/1024);
  Serial.printf("可用空间: %d KB\n", FFat.freeBytes()/1024);
}

SD卡硬件连接与初始化

SD_MMC需要硬件连接，以4线模式为例：

ESP32引脚	SD卡引脚
GPIO14	CLK
GPIO15	CMD
GPIO2	D0
GPIO4	D1
GPIO12	D2
GPIO13	D3

初始化代码：

#include "SD_MMC.h"

void setup() {
  Serial.begin(115200);
  
  // 设置4线模式引脚
  SD_MMC.setPins(14, 15, 2, 4, 12, 13);
  
  // 初始化SD卡，高速模式
  if(!SD_MMC.begin("/sdcard", false)){
    Serial.println("SD卡挂载失败");
    return;
  }
  
  Serial.printf("卡类型: %d\n", SD_MMC.cardType());
  Serial.printf("总容量: %d MB\n", SD_MMC.totalBytes()/(1024*1024));
}

文件基本操作：创建、读写与删除

1. 创建并写入文件

以下示例演示在FFat中创建配置文件并写入数据：

void createConfigFile() {
  // 以写入模式打开文件，不存在则创建
  File file = FFat.open("/config.json", FILE_WRITE);
  
  if(!file){
    Serial.println("文件创建失败");
    return;
  }
  
  // 写入JSON格式配置
  file.print("{\"ssid\":\"ESP32_AP\",\"password\":\"12345678\",\"interval\":5000}");
  file.close();
  
  Serial.println("配置文件创建成功");
}

2. 读取文件内容

读取刚才创建的配置文件：

void readConfigFile() {
  File file = FFat.open("/config.json", FILE_READ);
  
  if(!file){
    Serial.println("文件打开失败");
    return;
  }
  
  Serial.println("配置内容:");
  while(file.available()){
    Serial.write(file.read());
  }
  file.close();
}

3. 修改与删除文件

更新配置文件并安全删除临时文件：

void updateAndDeleteFile() {
  // 追加模式打开文件
  File file = FFat.open("/config.json", FILE_APPEND);
  if(file){
    file.println("\n\"log_level\":\"info\"");
    file.close();
  }
  
  // 删除临时文件
  if(FFat.exists("/temp.log")){
    FFat.remove("/temp.log");
    Serial.println("临时文件已删除");
  }
}

高级应用：传感器数据日志系统

结合FFat实现温湿度数据记录，每5秒写入一条记录：

#include "FFat.h"
#include "DHT.h"

DHT dht(4, DHT11);
File logFile;

void setup() {
  Serial.begin(115200);
  dht.begin();
  FFat.begin(true);
  
  // 创建日志文件，追加模式
  logFile = FFat.open("/sensor.log", FILE_APPEND);
  if(logFile){
    logFile.println("时间,温度(°C),湿度(%)");
    logFile.close();
  }
}

void loop() {
  float temp = dht.readTemperature();
  float humi = dht.readHumidity();
  
  logFile = FFat.open("/sensor.log", FILE_APPEND);
  if(logFile){
    logFile.printf("%lu,%.2f,%.2f\n", millis(), temp, humi);
    logFile.close();
    Serial.println("数据已记录");
  }
  
  delay(5000);
}

常见问题与解决方案

1. 文件系统挂载失败

   • 检查分区大小配置：menuconfig中确保FFat分区不小于2MB
   • 尝试格式化：FFat.format()或SD_MMC.format()

2. 写入速度慢

   • 使用缓冲写入：file.write(buffer, size)代替多次print
   • 降低SD卡频率：SD_MMC.begin("/sdcard", false, false, 20000000)

3. 文件损坏

   • 确保断电前关闭文件：file.close()
   • 启用Wear Levelling：libraries/FFat/src/FFat.h

总结与扩展学习

通过本文你已掌握：

• FFat与SD_MMC两种存储方案的使用
• 文件创建、读写、删除的核心API
• 传感器日志系统的完整实现

进阶学习推荐：

• 文件系统加密：FFat.begin(true, "/ffat", 10, "encrypted")
• 大文件操作：使用file.seek()实现随机访问
• 目录管理：FFat.mkdir()与FFat.rmdir()

收藏本文，下次开发ESP32存储功能时即可快速参考。关注获取更多物联网实战教程，下期将讲解"OTA升级与文件校验"。