Blob 导出中文文件名乱码 download 在 Safari 失效怎么办

现象

前端用 Blob 生成 CSV 再通过 a 标签的 download 属性触发下载,英文文件名一切正常,中文名字保存下来变成乱码或者一串百分号编码。同一个页面在 Safari 上,download 属性有时直接被忽略,文件在浏览器里被打开而不是下载。

原因

download 的值会参与文件名解析,没做编码处理时不同内核按各自字符集解码,中文就会出错。Safari 对跨源 URL 上的 download 支持有限,旧版本里 blob 协议也常被忽略。另外只有同源地址才保证按指定文件名保存,跨源时浏览器会以服务端响应头为准。

解决步骤

第一步,生成 Blob 时写清 MIME 和 charset,文件名用 encodeURIComponent 处理。用完记得释放对象 URL,否则长时间不关页面会一直占着内存。

const blob = new Blob(["\ufeff" + csv], {
  type: "text/csv;charset=utf-8"
});
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = encodeURIComponent("报表-2026.csv");
document.body.appendChild(a);
a.click();
a.remove();
setTimeout(() => URL.revokeObjectURL(url), 1000);

第二步,处理 Safari 的兼容分支。先用 "download" in a 做能力检测,不支持时提示用户长按或者右键另存,或者直接跳转到后端下载地址,不要静默失败。

第三步,文件名交给后端控制。需要绝对可控时,让接口返回 Content-Disposition: attachment; filename*=UTF-8''报表.csv,前端只负责跳转,避免各浏览器解析差异。

验证

在 Chrome、Firefox、Safari 各下载一次,检查保存下来的文件名是不是中文原名;再用表格软件打开,确认内容没有因为 BOM 多出奇怪字符。

小结

乱码的根源是文件名编码和跨源限制。前端补 encodeURIComponent 和 charset,Safari 走降级分支,要求严格时把文件名交给 Content-Disposition,问题基本能收口。

您可以还会对下面的文章感兴趣: