Flutter/Dart技术问题：如何将List<String>完整写入文件？仅部分生效

云上老周

2026-7-11

问题原因

你的代码里writeAsString是异步方法，但循环中没有等待它执行完成就发起下一次写入，多个异步写入操作会互相抢占文件资源，导致部分内容无法成功写入。

解决方案

有两种可行的修复方式：

方式一：等待每次写入完成

在循环中给writeAsString加上await，确保上一次写入完成后再执行下一次：

final Directory? externalStorageDirectoryPath =
    await getExternalStorageDirectory();
if (externalStorageDirectoryPath != null) {
  File file = File('${externalStorageDirectoryPath.path}/contacts.vcf');

  for (int i = 0; i < vCardsList.length; i++) {
    await file.writeAsString(vCardsList[i], mode: FileMode.writeOnlyAppend);
  }
}

方式二：一次性写入所有内容（更高效）

先把列表中所有字符串拼接成一个整体，再一次性写入文件，减少IO操作次数，避免异步冲突：

final Directory? externalStorageDirectoryPath =
    await getExternalStorageDirectory();
if (externalStorageDirectoryPath != null) {
  File file = File('${externalStorageDirectoryPath.path}/contacts.vcf');
  
  // 拼接所有vCard内容，根据vCard格式需求选择分隔符，比如换行或空行
  String allVCards = vCardsList.join('\n\n');
  await file.writeAsString(allVCards);
}