a标签download属性仅对同源静态资源生效，跨域时被浏览器静默忽略；可靠解法是服务端设置content-disposition响应头，或前端用fetch+blob构造同源url下载。
用 <a></a> 的 download 属性直接触发下载
只要链接指向的是同源（相同协议、域名、端口）的静态文件，<a download="xxx"></a> 就能绕过浏览器默认打开行为，强制下载。这是最轻量、无需后端配合的方式。
-
download属性值是可选的，它会作为下载后的文件名（不含扩展名时，浏览器会保留原文件扩展名） - 如果链接是跨域资源（比如指向
https://cdn.example.com/file.pdf），download会被忽略，浏览器仍会尝试打开或跳转 - 常见误写：
download=""或download="true"—— 这些无效；要么不写，要么写期望的文件名，如download="报告2024" - 表格中使用时，确保
<a></a>在<td> 内正确闭合，避免因嵌套问题导致样式或点击失效 <h3>表格中插入带下载链接的单元格示例</h3> <p>不是所有附件都适合直接暴露路径，但对公开的 PDF、CSV、Excel 等静态资源，直接写在 HTML 中最简单：</p> <pre class="brush:php;toolbar:false;"></pre> <table> <tr> <td>季度销售数据</td> <td><a href="data/q3-sales.xlsx" download="Q3_销售汇总">? 下载 Excel</a></td> </tr> <tr> <td>用户协议</td> <td><a href="/docs/terms.pdf" download>? 下载 PDF（用原文件名）</a></td> </tr> </table> <p>注意：<code>download无值时（即仅写download）等价于download=""，但实际效果取决于浏览器——Chrome 会用 URL 路径最后一段作文件名，Firefox 可能 fallback 到原名。稳妥起见，显式写上期望名称更可靠。当附件路径是动态生成或需权限控制时，
download属性失效怎么办？比如后端返回的是带签名的临时链接（
https://api.example.com/download?id=abc123&token=xyz），或者文件存在对象存储（OSS/S3）且做了 Referer 或 IP 限制，这时<a download></a>基本没用——浏览器发起的下载请求不携带 Cookie 或自定义 Header，服务端拒绝响应，最终可能得到 403 或空白页。- 可行替代方案：用
fetch+Blob+URL.createObjectURL手动触发下载 - 关键点：请求必须携带认证信息（如
credentials: 'include'），且服务端响应头需包含Content-Disposition: attachment; filename="xxx" - 不要试图用
iframe或window.open()替代——它们无法可靠触发下载，尤其在 Safari 和新版 Chrome 中极易被拦截 - 表格中绑定事件时，推荐给
<a></a>加href="#"并用onclick阻止默认行为，避免空链接干扰语义和 SEO
移动端点击无反应？检查这几个地方
在 iOS Safari 或部分安卓 WebView 中，
<a download></a>可能静默失败，连控制台错误都不报。- 确认文件 MIME 类型是否被浏览器识别为可下载类型（如
.pdf,.xlsx,.zip）。纯文本（.txt,.csv）有时会被直接渲染而非下载 - 避免在
<a></a>外层套<div onclick> 或其他事件监听器——iOS 对非原生 <code><a></a>点击的下载支持极差 - 不要用
target="_blank"和download同时出现——两者冲突，Chrome 会忽略download - 真机调试时，用
console.log打印event.target.href确认路径拼接是否正确（比如相对路径漏了/导致 404）
同源静态文件下载本身很简单，但一旦涉及路径构造、权限、跨域或移动端兼容，问题就藏在细节里——尤其是那个看似不起眼的斜杠，或是服务端少写的
Content-Disposition头。 - 可行替代方案：用
