会务工具把名单生成了字符串，页面也弹出“导出成功”，用户却在文件管理器里找不到文件。另一种情况是文件存在，但中文乱码、逗号拆列，或者只写进去一部分内容。这些问题分别发生在格式、访问与写入阶段，不能用一个保存按钮笼统处理。一个完整的导出动作，需要把每个阶段的完成条件说清楚。

先取得用户文件，再谈写入

应用沙箱文件与用户选择保存的文件不是同一概念。前者主要服务应用内部数据管理，后者由用户决定保存位置。本文直接调用系统文档保存选择器，拿到返回的 URI 后再写入名单，不猜测公共下载目录，也不把内部沙箱路径伪装成用户已经拿到的文件。

目标为 Stage 工程、API 12 及以上 SDK，使用 @kit.CoreFileKit 的 picker 与 fileIo，以及 @kit.ArkTS 的文本编码工具。系统选择器的展示与支持情况需要在目标设备上验证，界面预览不能替代这一系统交互。接口及模型条件可对照官方文档选择器参考。

保存选择器返回地址，不代表名单已经写完。它完成的是位置选择与对应文件访问流程，业务仍要执行编码、写入和关闭。用户取消时不应继续取数组第一项；返回为空、调用失败与实际写入失败也应分别考虑。本文界面用“导出未完成”覆盖没有取得最终结果的异常，避免误说已经成功保存。

示例只含两条自建参会记录，不涉及真实人员信息。导出内容固定为姓名和场次，不夹带设备标识、内部备注或其他页面未展示的数据。实际系统应在导出前明确字段范围和访问权限，文件一旦交给用户，就进入另一种流转方式，不能继续依赖应用内部页面的访问控制。

先把 CSV 当作格式协议

直接用逗号连接字段，看上去像 CSV，遇到场次名称本身含逗号就会多出一列。本文统一给字段加双引号，并把字段里的双引号翻倍，行之间使用明确换行。这样才能正确表示“技术,产品”这类内容。格式处理必须与文件写入分开，先确定文本正确，再讨论它如何到达磁盘。字段引号与转义规则可对照 RFC 4180。

另外，供表格软件打开的文本可能触发公式解释。这里对以特定公式前缀开头的文本增加单引号保护，用于降低把文本当作表达式处理的风险。这是面向表格查看的导出策略，会改变字段的表面内容；如果目标是机器之间交换原始数据，应定义另一份导出协议，不应悄悄共用同一转换。

将以下导入、类型和函数放在 entry/src/main/ets/pages/Index.ets 顶部，随后接上后文页面组件。所有代码共同组成一个文件。编码选择 UTF-8，并添加字节顺序标记，便于部分表格工具识别中文；接收系统是否接受该标记，仍应在格式约定中写清楚。

import { picker, fileIo } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
import { util } from '@kit.ArkTS';

interface Attendee {
  name: string;
  session: string;
}

function csvField(value: string): string {
  const safe: string = /^[\s]*[=+\-@＝＋－＠]/.test(value) ? "'" + value : value;
  return '"' + safe.replace(/"/g, '""') + '"';
}

function createCsv(rows: Attendee[]): string {
  const lines: string[] = [csvField('姓名') + ',' + csvField('场次')];
  rows.forEach((row: Attendee) => {
    lines.push(csvField(row.name) + ',' + csvField(row.session));
  });
  return '\uFEFF' + lines.join('\r\n') + '\r\n';
}

async function writeUtf8(uri: string, content: string): Promise<void> {
  const encoder = new util.TextEncoder('utf-8');
  const bytes: Uint8Array = encoder.encodeInto(content);
  const file = await fileIo.open(uri,
    fileIo.OpenMode.WRITE_ONLY | fileIo.OpenMode.CREATE | fileIo.OpenMode.TRUNC);
  try {
    let position: number = 0;
    while (position < bytes.byteLength) {
      const part: Uint8Array = bytes.slice(position);
      const written: number = await fileIo.write(file.fd, part.buffer, {
        offset: position
      });
      if (written <= 0) {
        throw new Error('写入没有继续推进');
      }
      position += written;
    }
  } finally {
    await fileIo.close(file);
  }
}

写入返回值是实际写入的字节数，不是字符串长度。中文字符与字节并非一一对应，因此循环先编码，再按字节推进。发生短写时只处理剩余字节；若一次写入没有推进就抛出错误，防止进入无休止循环。具体参数语义可查文件写入接口。

文件句柄在 finally 中关闭，成功和失败都会走到这里。关闭发生异常时，辅助函数不会正常返回，因此页面也不会提前显示完成。这里没有承诺跨设备断电场景下的事务保证，只把本次打开、写入与关闭的责任闭合。用户文件被覆盖之前，应由产品和选择器流程明确处理同名文件行为。

页面只在整条链路结束后确认

下面是同一文件的页面部分。名单显示在界面中，点击导出时先生成本次文本快照，再打开系统选择器。等待期间禁用导出按钮，避免出现多个位置选择窗口。文件名是一个建议值，用户可以按系统提供的方式调整，应用不应假设最终名称一定与建议值完全相同。

@Entry
@Component
struct Index {
  @State private busy: boolean = false;
  @State private status: string = '选择位置后导出名单';
  private generation: number = 0;
  private rows: Attendee[] = [
    { name: '参会者甲', session: '技术,产品' },
    { name: '参会者乙', session: '设计专场' }
  ];

  private async exportCsv(): Promise<void> {
    if (this.busy) {
      return;
    }
    const ticket: number = ++this.generation;
    const csv: string = createCsv(this.rows);
    this.busy = true;
    this.status = '请选择保存位置';
    try {
      const context = this.getUIContext().getHostContext() as common.UIAbilityContext;
      const options = new picker.DocumentSaveOptions();
      options.newFileNames = ['参会名单.csv'];
      options.fileSuffixChoices = ['CSV表格|.csv'];
      const viewPicker = new picker.DocumentViewPicker(context);
      const uris: string[] = await viewPicker.save(options);
      if (ticket !== this.generation) {
        return;
      }
      if (uris.length === 0) {
        this.status = '未选择保存位置';
        return;
      }
      this.status = '正在写入名单';
      await writeUtf8(uris[0], csv);
      if (ticket === this.generation) {
        this.status = '已导出2条参会记录';
      }
    } catch (_) {
      if (ticket === this.generation) {
        this.status = '导出未完成，请检查位置后重试';
      }
    } finally {
      if (ticket === this.generation) {
        this.busy = false;
      }
    }
  }

  aboutToDisappear(): void {
    this.generation += 1;
    this.busy = false;
  }

  build() {
    Column({ space: 20 }) {
      Text('会务名单').fontSize(28).fontWeight(FontWeight.Bold)
      Text('CSV 导出示例 · 2条记录').fontSize(16).fontColor('#64748B')
      ForEach(this.rows, (row: Attendee) => {
        Column({ space: 8 }) {
          Text(row.name).fontSize(22)
          Text(row.session).fontSize(18).fontColor('#64748B')
        }
        .padding(20).width('100%').borderRadius(14)
        .backgroundColor(Color.White)
      }, (row: Attendee) => row.name)
      Text(this.status).fontSize(18).fontColor('#275FB6')
      Button('导出CSV').width('100%').enabled(!this.busy)
        .onClick(() => { this.exportCsv(); })
    }
    .width('100%').height('100%').padding(24)
    .backgroundColor('#F2F6FB')
  }
}

这个示例没有申请任意公共目录访问能力，而是使用用户选定位置的访问结果。URI 应作为系统返回值交给支持它的接口，不应当作普通目录字符串随意拼接。若需要长期保留访问能力，必须继续查证相应授权与持久化规则，不能默认一次选择得到的地址永远可写。

页面版本用于阻止已经离开的组件接受旧结果。若用户在选择位置期间离开，返回后不继续写入；如果已经开始写入，函数仍负责关闭句柄，但旧结果不再更新页面。实际产品若要求导出任务离开页面也持续可见，应把任务交给明确的业务管理层，而不是仅移除版本检查。

验收要同时打开文本与表格

先在文本查看器中检查列名、引号、换行和中文编码，再在目标表格软件中打开，核对仍然是两列、两条记录。“技术,产品”必须留在同一单元格；如果被拆成两列，说明序列化规则或接收方式有问题。只看文件大小大于零，无法证明业务内容完整。

接着加入含双引号、换行、空字符串和公式前缀的样本，验证字段转义策略。CSV 不提供完整的单元格类型系统，数字样式文本在某些工具里仍可能被自动转换。若业务必须精确保留编号格式、日期类型和显示样式，应选择更适合的文件格式，不能指望给字段加引号解决所有问题。

系统交互也要覆盖取消、同名文件、无可用位置和写入失败。取消后不应显示成功，失败后应恢复按钮；重复点击只启动一条流程。覆盖既有文件可能使原内容被截断，所以异常后要提示导出没有完成，不能把部分文件当成可用成果。对关键数据可以另设计临时输出与确认替换流程。

当名单很大时，还需要重新评估内存峰值。本文把完整 CSV 和编码字节都保留在内存里，适合展示小型闭环；大规模记录应考虑分页获取、分块编码和写入，避免同时持有多个完整副本。分块时必须处理字符边界和行边界，不能简单按字符串下标切字节。

完成提示必须对应真实交付边界

导出完成意味着本次文件写入流程正常结束，不意味着用户已经把文件发给同事，也不意味着其他软件一定按预期解释所有字段。产品可以提供下一步打开或分享入口，但每个动作都应有自己的结果反馈。将多个步骤合并成一个含糊的“全部完成”，只会让失败来源更难定位。

字段范围也应固定在本次快照中。用户打开保存选择器后，后台列表可能刷新；如果写入时重新读取页面数组，导出的就可能不是用户点击时看到的内容。本文在拉起选择器之前生成文本，明确了这次导出的时间点。真实大数据导出可采用稳定查询版本或服务端导出任务来保持一致。

从工程维护看，格式函数、文件函数和页面流程应分别承担责任。格式函数可以用固定样本检查，文件函数可以检查短写与资源释放，页面流程则检查取消和重入。把它们全部塞进一个点击回调，即使功能暂时可用，也很难在后续添加格式或进度时保持边界清楚。

公式保护也不能写成对所有表格工具的通用保证。OWASP 的 CSV 注入说明提醒，保存后重新打开等行为可能改变转义效果，不同软件对前缀的解释也有差异。因此面向任意外部输入的正式导出，应按接收软件制定策略并进行回归；要求严格保持文本类型时，可以选择能够明确指定单元格类型的格式。本文的固定样本不包含公式内容，保护函数只是展示入口边界。

空名单也需要约定。格式函数会生成列名而没有数据行，这在结构上仍是一个明确的文件，但产品是否允许导出空名单应由需求决定。如果选择禁止，应在拉起系统选择器前提示用户；如果选择允许，完成文案应显示零条记录。不能因为文件有表头，就把它误算成一条参会记录。

错误处理还要考虑已有文件的影响。使用截断模式后再遇到写入失败，原文件可能已经不完整，应用不能宣称错误不会产生任何变化。本文让用户选择目标位置并给出失败反馈；需要保留原文件的业务，应优先选择新的输出名称，或者在受支持的存储范围内设计经过验证的替换流程，不把单次写入当成原子更新。

文件名属于展示建议，不能成为数据身份。用户可能改名，也可能在不同目录保存同名文件，所以业务记录应使用内部稳定标识，导出记录只保存必要的操作结果。日志里通常不需要打印完整用户 URI，更不需要逐行记录名单。定位失败可以依赖阶段和错误类别，不必复制整份导出内容到诊断系统。

格式测试可以独立于设备文件访问执行。用固定输入检查逗号字段仍占一列、双引号成对转义、行数与记录数对应，再把同样的文本送入设备导出流程。这种拆分让问题更容易归类：若文本阶段就错，修序列化；若文本正确但文件不完整，查写入；若文件正确但接收软件解释不同，查格式合同和导入选项。

会务名单只是一个小例子，真正需要留下的是交付条件：用户明确选择位置，文本遵守约定格式，字节写入有完成判断，句柄在所有路径关闭，页面只在整条链路结束后报成功。每一步都有可观察的结果，导出功能才不会停在“字符串已经生成”的半成品状态。

官方参考

• 文档选择器与保存选项

• 文件读写与 WriteOptions

• TextEncoder 字符串编码

• 保存用户文件指南

• RFC 4180：CSV 字段与转义规则

• OWASP：CSV 注入及处理边界