Node.js下使用XLSX指定自定义路径导出Excel失败求助

问题根源 #

你遇到的路径字符被替换、默认存到下载文件夹的情况，大概率是误用了浏览器版本的XLSX库，或者在Node.js环境中传入了浏览器专属参数。浏览器版的writeFile会自动将路径转成安全文件名（替换特殊字符）并触发下载，而Node.js版的writeFile应该直接操作本地文件系统。

修复原代码的方法 #

1. 确保使用Node.js版本的XLSX #

确认你安装的是官方xlsx包，并用require引入，而非浏览器CDN链接：

npm install xlsx

引入方式：

const XLSX = require('xlsx');

2. 移除浏览器专属参数，用path模块处理路径 #

Node.js环境下XLSX.writeFile不需要type: "file"参数，直接传入正确的本地路径即可。推荐用Node.js内置的path模块生成路径，避免分隔符问题：

const XLSX = require('xlsx');
const path = require('path');

// 构造工作簿和工作表
var wb = XLSX.utils.book_new();
const exportedData = XLSX.utils.json_to_sheet(exportData);
XLSX.utils.book_append_sheet(wb, exportedData, "Export");

const filename = `dateiname`;
// 用path.resolve生成绝对路径，自动处理分隔符
const filePath = path.resolve('D:/users/user', `${filename}.xlsx`);

// Node.js环境下直接调用writeFile，无需额外参数
XLSX.writeFile(wb, filePath);

3. 排查版本或引入问题 #

如果还是不行，检查是否不小心引入了浏览器版的XLSX（比如require('xlsx/dist/xlsx.full.min.js')），换成require('xlsx')即可。

替代方案 #

如果XLSX库还是有问题，可以试试以下更适合Node.js的Excel处理库：

1. ExcelJS #

功能丰富，API直观，支持流式处理：

const ExcelJS = require('exceljs');
const path = require('path');

async function exportExcel() {
  const workbook = new ExcelJS.Workbook();
  const worksheet = workbook.addWorksheet('Export');

  // 配置表头（假设exportData是包含对象的数组）
  worksheet.columns = Object.keys(exportData[0]).map(key => ({
    header: key,
    key: key
  }));

  // 添加数据行
  worksheet.addRows(exportData);

  const filename = `dateiname`;
  const filePath = path.resolve('D:/users/user', `${filename}.xlsx`);

  // 写入文件
  await workbook.xlsx.writeFile(filePath);
}

exportExcel();

2. node-xlsx #

轻量易用，基于xlsx但更适配Node.js：

const nodeXlsx = require('node-xlsx');
const fs = require('fs');
const path = require('path');

// 将JSON数据转换为sheet格式（node-xlsx接受二维数组）
const sheetData = [
  Object.keys(exportData[0]), // 表头
  ...exportData.map(item => Object.values(item)) // 数据行
];

// 生成Excel buffer
const buffer = nodeXlsx.build([{ name: 'Export', data: sheetData }]);

const filename = `dateiname`;
const filePath = path.resolve('D:/users/user', `${filename}.xlsx`);

// 写入到指定路径
fs.writeFileSync(filePath, buffer);

内容的提问来源于stack exchange，提问作者Andrej Dederer