现象
前端用 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,问题基本能收口。
