全栈JS文件下载实现教程

常见场景包括：用户点击按钮下载某个资源，前端发送请求获取文件流，然后自动下载。

使用 fetch 请求后端接口，接收 Blob 数据，创建临时下载链接：

const downloadFile = async () => {
  const response = await fetch('/api/download');
  const blob = await response.blob();
  
  // 创建临时URL
  const url = window.URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = url;
  a.download = 'example.txt'; // 下载的文件名
  document.body.appendChild(a);
  a.click();
  
  // 清理
  window.URL.revokeObjectURL(url);
  a.remove();
};

注意：如果后端在响应头中设置了 Content-Disposition: attachment; filename="xxx"，浏览器会自动触发下载，前端甚至不需要手动设置 a.download。

后端：Node.js 实现文件响应

使用 Express 框架可以快速实现文件下载接口。核心是设置正确的响应头，并将文件流式输出。

假设你有一个 files/report.pdf 文件希望提供下载。

const express = require('express');
const path = require('path');
const app = express();

app.get('/api/download', (req, res) => {
  const filePath = path.join(__dirname, 'files', 'report.pdf');
  const fileName = '年度报告.pdf';

  res.setHeader(
    'Content-Disposition',
    `attachment; filename="${encodeURIComponent(fileName)}"; filename*=UTF-8''${encodeURIComponent(fileName)}`
  );
  res.setHeader('Content-Type', 'application/pdf');

  res.download(filePath, fileName, (err) => {
    if (err) {
      console.error('下载出错:', err);
      res.status(500).send('文件不存在或下载失败');
    }
  });
});

res.download() 是 Express 提供的便捷方法，自动处理流传输和错误。

有时文件不是静态的，比如导出 CSV 报表。

app.get('/api/export-csv', (req, res) => {
  const data = [
    ['姓名', '年龄', '城市'],
    ['张三', '25', '北京'],
    ['李四', '30', '上海']
  ];
  
  let csvContent = data.map(row => row.join(',')).join('\n');
  const buffer = Buffer.from(csvContent, 'utf-8');

  res.setHeader('Content-Disposition', 'attachment; filename="用户列表.csv"');
  res.setHeader('Content-Type', 'text/csv; charset=utf-8');

  res.send(buffer);
});

这里使用 res.send() 发送 Buffer，配合正确的 Content-Type 和编码，确保中文不乱码。

跨域与安全注意事项

如果前端和后端不在同一域名，需启用 CORS，并允许相关头部。

const cors = require('cors');
app.use(cors({
  exposedHeaders: ['Content-Disposition'] // 确保前端能读取到这个头
}));

某些浏览器在跨域时无法正确解析 Content-Disposition，所以暴露该头部很重要。

生产环境建议对下载接口做权限校验，例如检查用户登录状态或 token 合法性，防止未授权访问。

大文件与流式传输优化

对于大文件，避免一次性读入内存，应使用可读流。

const fs = require('fs');

app.get('/api/large-file', (req, res) => {
  const filePath = path.join(__dirname, 'files', 'big.zip');
  const stat = fs.statSync(filePath);

  res.setHeader('Content-Disposition', 'attachment; filename="large.zip"');
  res.setHeader('Content-Length', stat.size);
  res.setHeader('Content-Type', 'application/octet-stream');

  const stream = fs.createReadStream(filePath);
  stream.pipe(res);

  stream.on('error', () => {
    res.status(500).send('流传输错误');
  });
});

这样即使GB级文件也不会占用过多内存，适合视频、备份包等场景。

基本上就这些。前端用 fetch + blob + a标签触发下载，后端用 res.download 或流式响应返回文件，配合好响应头即可实现稳定可靠的下载功能。

好了，本文到此结束，带大家了解了《全栈JS文件下载实现教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！