前端可通过Blob和a[download]实现文件下载,如文本、JSON、CSV等;利用URL.createObjectURL创建临时链接,动态触发下载,适用于导出数据场景。
在前端开发中,JavaScript 本身不能直接操作用户的文件系统,出于安全考虑,浏览器限制了对本地文件的读写权限。但可以通过一些方法实现“下载文件”的功能,比如将文本、JSON、CSV 等内容生成文件并触发浏览器下载。
1. 使用 Blob 和 URL.createObjectURL 实现文件下载
这是最常用的方式,适用于导出文本类数据(如 TXT、CSV、JSON)或二进制数据(如图片、PDF)。
原理: 将数据包装成 Blob 对象,创建一个临时的 URL,然后通过动态创建的 标签触发下载。
示例:下载一段文本为 .txt 文件
function downloadText(content, filename) {
const blob = new Blob([content], { type: 'text/plain' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
a.click();
URL.revokeObjectURL(url); // 释放内存
}
// 调用
downloadText('Hello, 这是要保存的内容', 'note.txt');
示例:下载 JSON 数据
function downloadJSON(data, filename) {
const content = JSON.stringify(data, null, 2);
const blob = new Blob([content], { type: 'application/json' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
a.click();
URL.revokeObjectURL(url);
}
// 调用
downloadJSON({ name: '张三', age: 30 }, 'user.json');
2. 下载 CSV 文件(常用于表格导出)
将数组数据转换为 CSV 格式并下载。
function downloadCSV(rows, filename) {
const csvContent = rows.map(row => row.join(',')).join('\n');
const blob = new Blob(['\uFEFF' + csvContent], { type: 'text/csv;charset=utf-8;' }); // 加 BOM 避免中文乱码
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = filename;
a.click();
URL.revokeObjectURL(url);
}
// 调用示例
const data = [
['姓名', '年龄'],
['李四', '25'],
['王五', '28']
];
downloadCSV(data, 'users.csv');
3. 直接下载已有文件(通过链接)
如果只是想让用户下载服务器上的某个文件,可以直接使用带有 download 属性的链接。
下载PDF
注意:跨域资源可能无法触发自动下载,需服务端设置 Content-Disposition 头。
4. 注意事项与限制
- Blob 下载方式不支持 IE9 及以下,IE10+ 需使用 ms
SaveBlob
- 不能指定保存路径,由用户浏览器决定
- 无法读取或修改用户任意文件,仅能生成并引导下载
- 移动端部分浏览器对 download 属性支持有限,可能直接打开而非下载
基本上就这些。JavaScript 的“下载”本质是生成数据并触发浏览器行为,而不是真正的文件系统操作。只要理解 Blob 和 a[download] 的配合使用,大多数导出需求都能满足。

SaveBlob







