根本原因是浏览器对blob下载中文文件名支持不一致:chrome 95+支持a.download设中文,firefox忽略而依赖encodeuri路径方案,ios safari基本不支持;content-disposition响应头在纯前端blob场景完全无效。

Chrome/Firefox 下 Blob 下载中文文件名变问号或乱码
根本原因是浏览器对 Content-Disposition 响应头中 filename 字段的编码处理不一致,而前端用 URL.createObjectURL(new Blob(...)) 触发下载时,根本没走 HTTP 响应头,只能靠 a.download 属性——但这个属性在 Chrome 和 Firefox 中对中文的支持完全不同。
- Chrome 95+ 支持直接赋值中文给
a.download(如a.download = "报告2024.xlsx"),会原样显示 - Firefox 一直不认非 ASCII 字符,设了也忽略,回退到
blob:随机路径名 - 旧版 Edge(基于 EdgeHTML)和 Safari 同样不可靠,不能依赖
download属性传中文
用 encodeURI + decodeURIComponent 混合方案绕过浏览器限制
这不是“修复”,而是利用浏览器对 URL 编码路径的兼容性:把中文文件名塞进临时 URL.createObjectURL 的路径段里,再用 a.href 触发,靠浏览器自动解码显示。实际生效的是 URL 路径中的 filename 部分,不是 a.download。
- 必须对文件名做
encodeURI(不是encodeURIComponent),否则斜杠、冒号会被过度转义 -
a.download仍需设置,作为 Chrome 的 fallback;Firefox 则完全忽略它,只看 href 路径 - 完整路径格式为:
blob:https://domain.com/xxx-xxx-xxx/报告2024.xlsx—— 注意末尾是原始文件名,未编码
const blob = new Blob([data], { type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = encodeURI(url).replace(/%2F/g, '/').replace(/%3A/g, ':') + '/' + encodeURIComponent(filename);
a.download = filename; // Chrome 用这个,Firefox 忽略
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
URL.revokeObjectURL(url);
Content-Disposition 头在纯前端 Blob 场景下完全无效
很多人查资料看到要设置 Content-Disposition: attachment; filename="中文.xlsx",但这是服务端响应头,只对 fetch 或 XMLHttpRequest 返回的二进制流有效。一旦你调用 new Blob(),就脱离了 HTTP 上下文,header 彻底丢失,所有 header 相关操作(包括 filename* RFC 5987 写法)都起不了作用。
- 如果你控制后端,优先改接口:返回真实
Content-Disposition+ArrayBuffer,前端用fetch().then(r => r.blob())接收,再生成 URL - 如果只能前端拼 Blob(比如导出 Canvas、加密数据本地生成),就别折腾 header,老实用上一节的 encodeURI 路径方案
- 注意
filename*是服务端字段,前端 JS 无法伪造或注入,new Blob()不接受 header 参数
移动端 iOS Safari 对 Blob 下载基本不支持
iOS 16.4 之前,Safari 完全禁用 a.download,点击后只打开预览页,不触发保存。即使加了 encodeURI 路径,也会被截断或报错 NotAllowedError: play() can only be initiated by user gesture(虽然和音频无关,但 Safari 把下载也归为此类权限)。
立即学习“前端免费学习笔记(深入)”;
- 目前唯一可靠方式:后端提供带正确
Content-Disposition的直链,用window.location.href跳转下载 - 如果必须前端生成,iOS 用户只能提示“请复制内容粘贴到 Excel”或引导使用桌面端
- 不要尝试用
cordova-plugin-file-opener2或capacitor插件绕过——它们依赖原生能力,且 iOS 文件系统沙盒严格,Blob URL 无法被原生层识别
file-saver)底层也是同套逻辑,别信封装后的幻觉。











