ESP32使用LittleFS能否替换文件单行内容？无需复制整个文件

需求可行性说明 #

你的需求完全可行。LittleFS支持随机读写（通过seek()定位），且你限定了所有行（包括换行符）长度一致，无需复制整个文件，直接定位到目标行位置覆盖写入即可。

原代码问题分析 #

运行后文件空白的核心问题是文件打开模式错误：

• 使用FILE_WRITE打开文件时，LittleFS会直接截断原有文件内容（清空文件），导致后续读取不到任何内容，最终文件保持空白。
• 额外问题：readStringUntil('\n')不会读取换行符，导致记录的position与实际行起始位置的对应关系出现偏差，即使修正打开模式，也可能出现写入位置错误。

修正方案 #

1. 使用正确的文件打开模式：用FILE_READ_WRITE模式打开文件，既能读取原有内容，又能写入修改，不会截断文件。
2. 准确读取完整行（含换行符）：通过逐字节读取直到换行符，确保获取包含换行的完整行，保证position定位准确。
3. 严格保证写入长度一致：因为你限定了行长度相同，替换后的内容（含换行）必须和原行长度完全一致，避免破坏后续行的结构。

修正后的完整代码 #

#include <LittleFS.h>

String stringToSearchInLine = "Line 2";
String newSubString = "123";

void replacePDU(const String &searchString, const String &PDU_Name) {
  // 关键：用FILE_READ_WRITE模式打开，避免截断文件
  File file = LittleFS.open("/ReplaceLineTest.txt", FILE_READ_WRITE);
  if (!file) {
    Serial.println("File open error!!");
    return;
  }
  
  while (file.available()) {
    // 记录当前行的起始位置
    int lineStartPos = file.position();
    
    // 读取完整行（包含换行符）
    String line = "";
    char c;
    while (file.available() && (c = file.read()) != '\n') {
      line += c;
    }
    line += '\n'; // 补回换行符，保证行内容完整
    
    // 检查当前行是否为目标行
    if (line.indexOf(searchString) != -1) {     
      int pduIndex = line.indexOf("---");
      if (pduIndex != -1) {
        // 替换内容，注意保证替换后的总长度和原行一致
        line.replace("---", PDU_Name);
        
        // 定位到目标行起始位置
        file.seek(lineStartPos);
        // 写入修改后的行
        file.print(line);
        // 强制刷新缓存到闪存
        file.flush();
        break;
      } else {
        Serial.println("PDU Name is already assigned");
      }
    }
  }
  // 必须关闭文件，确保所有写入操作生效
  file.close();
}

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

  if (!LittleFS.begin()) {
    Serial.println("Error Initializing the file system");
    return;
  }
  Serial.println("File System ready");

  // 初始化测试文件，用FILE_WRITE会覆盖原有内容，适合首次创建
  File file = LittleFS.open("/ReplaceLineTest.txt", FILE_WRITE);
  if (!file) {
    Serial.println("Open File to write error.");
    return;
  }
  file.println("Line 1 ---");
  file.println("Line 2 ---");
  file.println("Line 3 ---");
  file.println("Line 4 ---");
  file.close();

  // 读取并打印原始文件
  Serial.println("  Read from original file:");
  file = LittleFS.open("/ReplaceLineTest.txt", FILE_READ);
  while(file.available()){
    Serial.write(file.read());
  }
  file.close();

  // 执行替换操作
  replacePDU(stringToSearchInLine, newSubString);

  // 读取并打印修改后的文件
  Serial.println("\n  Read from modified file:");
  file = LittleFS.open("/ReplaceLineTest.txt", FILE_READ);
  if(!file){
    Serial.println("Problem occurred during opening file");
    return;
  }
  while(file.available()){
    Serial.write(file.read());
  }
  file.close();
}

void loop(){
  
}

关键修改点说明 #

• 文件打开模式：将FILE_WRITE改为FILE_READ_WRITE，保留原有文件内容。
• 完整行读取：逐字节读取直到换行符，手动补回换行符，确保行内容包含换行，lineStartPos准确对应行的起始位置。
• 缓存刷新：写入后调用file.flush()，确保修改立即写入闪存，避免数据丢失。
• 文件关闭：操作完成后关闭文件，确保所有IO操作完成。

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