如何在Dart中修改大CSV文件单行内容而不重写整个文件？

核心结论 #

仅当修改后的行编码为字节后的长度与原行完全一致时，才能无需重写整个文件修改单行；否则必须重写文件（至少修改点之后的所有内容）——这是由文件系统的存储机制决定的，并非Dart的限制。

具体实现方案 #

情况1：修改后行字节数与原行一致 #

利用Dart的RandomAccessFile实现定位写入，步骤如下：

1. 遍历文件字节流，记录目标行的起始字节偏移量和原行的总字节长度（包括换行符）
2. 验证修改后的行编码为UTF8字节后的长度是否与原行一致
3. 定位到目标行的起始偏移量，覆盖写入修改后的行字节

示例代码：

import 'dart:io';
import 'dart:convert';

Future<void> editMatchingLengthLine(String filePath, int targetLineNum, String newLine) async {
  final file = File(filePath);
  final raf = await file.open(mode: FileMode.readWrite);
  
  int currentLine = 0;
  int lineStartOffset = 0;
  final buffer = <int>[];
  bool isCR = false;

  while (true) {
    final byte = await raf.readByte();
    if (byte == -1) break;

    if (isCR) {
      buffer.add(byte);
      if (byte == 10) { // 处理\r\n换行
        if (currentLine == targetLineNum) {
          await _handleLineEdit(raf, lineStartOffset, buffer, newLine, '\r\n');
          await raf.close();
          return;
        }
        currentLine++;
        lineStartOffset = await raf.position();
        buffer.clear();
      }
      isCR = false;
      continue;
    }

    if (byte == 13) { // 遇到\r，标记下一个字节需要检查
      isCR = true;
      buffer.add(byte);
    } else if (byte == 10) { // 处理\n换行
      buffer.add(byte);
      if (currentLine == targetLineNum) {
        await _handleLineEdit(raf, lineStartOffset, buffer, newLine, '\n');
        await raf.close();
        return;
      }
      currentLine++;
      lineStartOffset = await raf.position();
      buffer.clear();
    } else {
      buffer.add(byte);
    }
  }

  // 处理无换行符的最后一行
  if (currentLine == targetLineNum) {
    await _handleLineEdit(raf, lineStartOffset, buffer, newLine, '');
  }

  await raf.close();
}

Future<void> _handleLineEdit(RandomAccessFile raf, int lineStartOffset, List<int> originalBytes, String newLine, String lineEnding) async {
  final newLineBytes = utf8.encode(newLine + lineEnding);
  if (newLineBytes.length != originalBytes.length) {
    print("修改前后行字节长度不一致，无法直接修改，将重写整个文件");
    await raf.close();
    await rewriteFileWithEdit(raf.path, targetLineNum, newLine);
    return;
  }

  await raf.setPosition(lineStartOffset);
  await raf.writeFrom(newLineBytes);
  print("已成功修改目标行");
}

情况2：修改后行字节数与原行不一致（绝大多数场景） #

这种情况下必须重写文件，为了避免内存溢出，建议逐行读取写入临时文件，最后替换原文件：

示例代码：

Future<void> rewriteFileWithEdit(String filePath, int targetLineNum, String newLine) async {
  final originalFile = File(filePath);
  final tempFile = File('$filePath.tmp');
  
  int currentLine = 0;
  await for (final line in originalFile.openRead()
      .transform(utf8.decoder)
      .transform(const LineSplitter())) {
    final content = currentLine == targetLineNum ? '$newLine\n' : '$line\n';
    await tempFile.writeAsString(content, mode: FileMode.append);
    currentLine++;
  }

  // 替换原文件
  await originalFile.delete();
  await tempFile.rename(filePath);
  print("已通过重写文件完成修改");
}

关键说明 #

• Dart的RandomAccessFile是实现定位写入的核心，它支持setPosition跳转到指定字节偏移量，再通过writeFrom覆盖写入内容
• 直接修改仅适用于字节长度完全匹配的场景，否则会破坏文件后续内容的结构
• 重写文件时使用临时文件是为了避免修改过程中出现异常导致原文件损坏

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