JavaScript无法直接读写本地Excel文件,但可通过SheetJS库实现前端导入解析(如XLSX.read)和导出生成(如XLSX.writeFile),支持.xlsx/.xls/.csv格式,无需后端参与。

JavaScript 本身不能直接读写本地 Excel 文件(如 .xlsx、.xls),因为浏览器出于安全限制,无法随意访问用户文件系统。但通过前端库(如 SheetJS)配合用户主动选择文件或触发下载,可以实现 Excel 的导入解析和导出生成,无需后端参与。
导入 Excel:读取用户选中的文件
使用 SheetJS(xlsx.js) 是最主流的方式。它支持 .xlsx、.xls、.csv 等格式,纯前端解析,不上传服务器。
- 引入库(CDN 方式):
- HTML 中放一个文件输入框:
- 监听 change 事件,用
XLSX.read()解析二进制内容,再用XLSX.utils.sheet_to_json()转成数组:
document.getElementById('importFile').onchange = e => {
const file = e.target.files[0];
const reader = new FileReader();
reader.onload = function(e) {
const data = new Uint8Array(e.target.result);
const workbook = XLSX.read(data, {type: 'array'});
const sheetName = workbook.SheetNames[0];
const worksheet = workbook.Sheets[sheetName];
const jsonData = XLSX.utils.sheet_to_json(worksheet);
console.log(jsonData); // [{name: "张三", score: 95}, ...]
};
reader.readAsArrayBuffer(file);
};
导出 Excel:将 JSON 数据生成并下载 .xlsx 文件
同样用 SheetJS,把 JS 数组转为工作表,再写入 workbook 并触发浏览器下载。
立即学习“Java免费学习笔记(深入)”;
- 准备数据(例如表格行数据):const data = [{name: "李四", age: 28}, {name: "王五", age: 32}];
- 用
XLSX.utils.json_to_sheet()创建工作表 - 新建 workbook,添加 sheet,再用
XLSX.writeFile()直接下载:
const ws = XLSX.utils.json_to_sheet(data);
const wb = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(wb, ws, "用户列表");
XLSX.writeFile(wb, "导出数据.xlsx"); // 自动触发下载
注意事项与常见问题
- 中文乱码? 确保文件是 UTF-8 编码(CSV 导入时较敏感),.xlsx 基本无此问题
-
日期/数字格式丢失? SheetJS 默认会尝试转换类型。如需保留原始字符串,可加选项:
{raw: true, defval: ""} - 大文件卡顿? 浏览器内存有限,超过 10MB 的 Excel 建议分页或交由后端处理
- 样式/公式/图表? SheetJS 支持基础样式读写,但复杂格式(如条件格式、图表)不支持,导出仅推荐用于结构化数据交换
替代方案简要说明
-
后端中转(Node.js):用
xlsx或exceljs库在服务端解析/生成,适合需权限控制、大文件或保留样式的场景 -
CSV 替代:若只需简单表格,用
text/csvMIME 类型 + Blob 下载更轻量,兼容性更好 - Excel Online API:企业级应用可调用 Microsoft Graph API 操作 OneDrive 中的 Excel,需 OAuth 授权











