下载行为由服务端Content-Disposition响应头决定，前端download属性仅对同源URL有效且受浏览器兼容性限制；动态内容需用Blob+临时URL实现，移动端应降级提示或依赖服务端直链。
下载链接不触发下载，而是跳转或打开文件
浏览器默认对某些文件类型（如 .txt、.pdf、.png）会直接在标签页中打开，而不是下载。关键在于服务端响应头是否设置了 Content-Disposition: attachment；前端无法强制覆盖该行为，但可用 download 属性辅助控制。
-
download属性仅对同源 URL 有效；跨域链接即使写了download，也会退化为普通跳转 - 如果目标文件是同源的（比如放在同一域名下的
/files/report.xlsx），直接写：<a href="/files/report.xlsx" download="monthly-report.xlsx">下载报表</a>
- 若文件在第三方 CDN 或 S3 上（如
https://cdn.example.com/data.csv），download属性会被忽略，此时必须让服务端返回带attachment的响应头，否则用户只能右键另存为
download 属性指定的文件名被忽略或乱码
Chrome 和 Edge 支持 download 后跟自定义文件名，但 Safari 完全忽略该值，Firefox 则只在同源时生效；且文件名含中文或特殊符号时，部分浏览器可能截断或编码错误。
- 避免使用空格、斜杠、问号等 URL 不安全字符；推荐用下划线或短横线代替，例如
download="2024_q3_report.pdf" - 中文文件名建议转为 ASCII：服务端生成下载链接时，用 UTF-8 编码后 base64 或 URL encode（前端不可靠）；纯前端场景下，宁可使用英文名 + 注释说明
- 不要依赖
download改变实际文件内容——它只是建议浏览器保存时用的名字，不影响服务器返回的真实文件名或内容
想下载动态生成的内容（比如导出表格），但没有真实文件路径
没有服务器端文件时，不能靠 <a href="..." download> 直接指向一个不存在的路径。得用 JavaScript 构造 Blob 并创建临时 URL。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 核心步骤：把数据转成
Blob→ 用window.URL.createObjectURL()生成临时地址 → 绑定到<a>的href→ 触发点击 → 调用revokeObjectURL清理 - 例如导出 CSV 字符串：
const csv = "name,age\nAlice,30\nBob,25";<br>const blob = new Blob([csv], { type: "text/csv;charset=utf-8" });<br>const url = URL.createObjectURL(blob);<br>const a = document.createElement("a");<br>a.href = url;<br>a.download = "users.csv";<br>a.click();<br>URL.revokeObjectURL(url); - 注意：Blob 的
type影响浏览器识别方式；设为"application/octet-stream"可绕过预览，强制下载，但会丢失原始扩展名提示
移动端点击下载链接无反应
iOS Safari 对 download 属性完全不支持，Android Chrome 也限制自动触发下载（尤其非用户手势上下文）。
立即学习“前端免费学习笔记（深入）”；
- 确保下载触发发生在明确的用户操作内，比如
onclick事件里，而不是异步回调或定时器中 - 不要用
location.href或window.open()替代<a>点击——它们不会触发下载逻辑 - 移动端更稳妥的方式仍是服务端提供带正确响应头的直链；前端生成 Blob 下载在 iOS 上大概率失败，需降级提示“请长按链接选择‘下载’”
download 属性能一锤定音。 
