download属性仅对同源URL生效,跨域链接会跳转而非下载;需用fetch+Blob方案绕过限制,且Safari全系不支持该属性。

download 属性不生效?检查链接是否同源
浏览器只允许 download 属性对同源 URL 生效,跨域链接(比如指向 CDN 或 API 接口的 https://cdn.example.com/file.pdf)点下去会直接跳转或打开,不会触发下载。
常见错误现象:<a href="https://api.example.com/export" download="report.csv">导出</a> 点击后页面跳转,文件没下载。
- 如果是后端生成的文件,用
fetch+Blob+URL.createObjectURL方案替代,绕过同源限制 - 静态资源(如 PDF、ZIP)尽量放在当前域名下,例如
/assets/guide.pdf - 开发时注意本地
file://协议下download完全无效,必须走 HTTP(S) 服务
download 属性值为空或带路径?它只控制文件名,不处理路径
download 属性值仅作为下载时建议的文件名,浏览器会忽略其中的路径成分(如 download="data/reports/2024.csv" 最终仍保存为 2024.csv),且不能含 /、\、: 等非法字符,否则退化为默认文件名。
- 合法写法:
download="invoice-202405.zip" - 非法但常见写法:
download="./export/data.json"→ 浏览器静默忽略该属性 - 如果后端返回的文件名含中文或空格,前端无需额外编码,
download值保持原样即可(现代浏览器已支持 UTF-8 文件名)
点击后没反应?确保是 <a></a> 标签且 href 有效
download 是 <a></a> 标签专属属性,用在 <button></button> 或其他标签上完全无效;同时 href 必须指向一个可获取的资源地址,空值、javascript:void(0) 或纯哈希(#section)都会导致无响应。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- 错误示范:
<button download="log.txt">下载</button>→ 属性被忽略 - 错误示范:
<a href="#" download="log.txt">下载</a>→ 点击无效果 - 正确最小闭环:
<a href="/files/log.txt" download="log.txt">下载</a> - 动态生成链接时,务必先设置
href再触发点击,否则部分浏览器(如 Safari)可能不识别
移动端 Safari 不支持 download?没错,得换方案
iOS/iPadOS 上所有版本 Safari 都不支持 download 属性,点击同源链接也会打开预览而非下载。这是系统级限制,无法通过加属性或改 MIME 绕过。
- 唯一可靠方式:后端配合,在响应头中设置
Content-Disposition: attachment; filename="xxx" - 前端可检测:
!navigator.userAgent.includes('Safari') || navigator.userAgent.includes('Chrome')仅作提示,不能解决根本问题 - 不要依赖
document.execCommand('saveAs')—— 已废弃,且 iOS 不支持
真正卡住的地方不是怎么写 HTML,而是得提前和后端约定好附件响应头,尤其当文件来自接口而非静态路径时——这点最容易被前端单方面忽略。


















