本文面向 HarmonyOS 7 应用开发。涉及系统能力时，以项目实际安装 SDK 的 API、权限及设备支持为准；下文代码注明为局部示例，不构成完整可运行工程。

沙箱里有文件，用户却找不到

报表生成后弹出“导出成功”，用户去文件管理里找不到，这是移动应用常见的体验断点。应用内部文件生成完成，只说明内容已经写入应用可访问的位置；用户选择保存目标并且数据写入成功，才算完成一次面向用户的导出。

先把产品动作分清楚：预览是在应用内看；导出是给用户一个可管理的文件；分享是交给其他目标。三个按钮可以使用同一个内容生成器，但完成条件不同。

推荐采用两阶段输出

第一阶段在应用管理的临时位置生成报告，检查文件非空、格式正确、内容对应当前查询条件。第二阶段调用系统文件保存选择能力，让用户确定目标，再把已生成内容写到返回资源。具体读写模式与授权范围按照项目使用的 SDK 文档实现。

写入过程可能发生部分写入，不能只调用一次写操作就默认全部完成。应确认累计写入量，并在所有分支关闭已打开的句柄。保存失败时保留短期可重试的源文件，避免再次耗时生成。

文件名也是功能的一部分

“报表.xlsx”难以区分月份；带有完整证件号的文件名又会扩大暴露范围。本例使用“订单汇总_2026-10_批次A.csv”，业务上可识别，也不把个人信息放进名称。

function safeFileName(value: string): string {
  const cleaned = value.replace(/[\\/:*?"<>|\u0000-\u001f]/g, '_').trim();
  return cleaned.length > 0 ? cleaned.slice(0, 80) : '导出文件';
}

这是应用侧的基本清理策略，并非所有文件系统规则的完整实现。保存目标还可能对名称、重名和扩展名有自己的处理方式。

表格导出有两个容易忽略的细节

第一，CSV 不是 Excel 工作簿。不要把 CSV 内容换成 .xlsx 后缀。第二，文本字段需要按 CSV 规则转义，包括内部双引号、换行和逗号。面向表格软件打开的内容还应按业务策略处理可能被解释为公式的字段，导出前说明哪些字段按文本保存。

日期和金额不要随意格式化。金额需要有币种和小数约定；时间需要有可理解的时区。用户下载的报告应与屏幕上的查询条件保持一致，可以在首部或配套说明里记录生成时间、筛选条件和行数。

把“取消”从失败中拆出来

用户在保存面板点返回，是主动取消；目标不可写是保存失败；报告生成异常是内容失败。界面分别给反馈，才能避免用户认为系统坏了。

最后用空报表、大报表、空间不足、同名文件和取消保存做一次验收。只有目标文件可打开、行数正确、特殊字符正常，才显示“已保存”。用户不需要知道文件经历了几个内部阶段，但需要得到一个真正可用的结果。

官方参考

• 华为开发者文档
• HarmonyOS 7 新能力与开发入口