使用 <a> 标签 download 属性可实现同源文件下载,支持自定义文件名;2. javaScript 可通过 Blob对象 动态生成并下载文本等内容;3. fetch 结合 Blob 适用于需鉴权或跨域的二进制文件下载;4. 直接跳转 URL 或使用 iframe 适用于服务端设置 Content-Disposition 响应头自动触发下载的场景。

在html 5 网页中实现文件下载有多种方式,可以根据文件类型、来源以及用户交互需求选择合适的方法。以下介绍几种常见且实用的实现方案。
1. 使用 <a> 标签的 download 属性
这是最简单直接的方式,适用于同源资源的下载。通过 download 属性,可以提示 浏览器 下载链接指向的文件,而不是在 浏览器 中打开。
示例:
<a href="example.pdf" download=" 自定义文件名。pdf"> 下载 PDF</a>
说明:
- 如果省略 download 属性的值,浏览器将使用原始文件名。
- 该方法仅对同源 URL 有效,跨域资源可能被忽略 download 属性,直接在新页面打开。
2. 动态创建下载链接(javascript)
当需要下载动态生成的内容(如文本、csv、jsON)时,可以通过 JavaScript 创建 Blob 对象并触发下载。
立即学习 “ 前端免费学习笔记(深入)”;
示例:下载一段文本
const content = "Hello, 这是要下载的内容 "; const blob = new Blob([content], {type: 'text/plain'}); const url = URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = 'hello.txt'; document.body.appendChild(a); a.click(); document.body.removeChild(a); URL.revokeObjectURL(url);
适用场景:
3. 利用 fetch 下载二进制文件
对于跨域资源或需要鉴权的文件(如用户私有文件),可通过 fetch 获取数据后创建本地下载链接。
示例:下载图片或文档
fetch('/api/download/file.pdf', { method: 'GET', headers: { 'Authorization': 'Bearer token123'} }) .then(res => res.blob()) .then(blob => { const url = URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = 'file.pdf'; a.click(); URL.revokeObjectURL(url); });
优势:
- 支持带身份验证的请求。
- 可处理跨域资源。
4. 直接跳转或使用 iframe(简单场景)
某些服务器配置了正确的 Content-Disposition 响应头,浏览器会自动下载文件。此时只需跳转到该 URL 即可。
示例:
window.location.href = '/files/report.xlsx';
前提:
基本上就这些常用方式。根据实际需求选择:静态资源用 download 属性,动态内容用 Blob,需认证的用 fetch,服务端控制的可直接跳转。关键是理解每种方式的限制和适用环境。不复杂但容易忽略细节,比如跨域和文件命名问题。基本上就这些。


