如何使用SheetJS在JavaScript中写入现有Excel文件

首先明确：前端JavaScript无法直接读写服务器上的文件，这是浏览器安全策略限制的。你遇到的Uncaught TypeError: Cannot read properties of undefined (reading 'A3')，大概率是试图在前端直接操作服务器文件对象，导致获取的工作表或单元格引用为undefined。

正确的流程是：前端把整理好的数组数据发送给后端，由后端负责加载服务器上的现有Excel文件、写入数据并保存。下面以Node.js后端为例给出完整解决方案：

1. 前端：整理数据并发送到后端 #

把你存在columnA、columnB里的数据打包成JSON，通过POST请求传给后端接口：

// 整理要发送的数据
const payload = {
  columnA: columnA,
  columnB: columnB
};

// 发送请求到后端接口
fetch('/api/write-excel', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
})
.then(res => res.json())
.then(result => {
  console.log('写入结果:', result);
})
.catch(err => {
  console.error('请求失败:', err);
});

2. 后端：实现Excel写入逻辑 #

这里用Node.js + Express + ExcelJS（处理现有Excel文件更灵活）：

第一步：安装依赖 #

npm install express exceljs

第二步：编写后端接口 #

const express = require('express');
const ExcelJS = require('exceljs');
const app = express();

// 解析JSON请求体
app.use(express.json());

// 处理写入Excel的接口
app.post('/api/write-excel', async (req, res) => {
  const { columnA, columnB } = req.body;
  // 替换成你服务器上现有Excel文件的实际路径
  const targetFilePath = './server-files/your-existing-file.xlsx';

  try {
    // 加载服务器上的现有Excel文件
    const workbook = new ExcelJS.Workbook();
    await workbook.xlsx.readFile(targetFilePath);

    // 获取目标工作表（可以按索引或名称获取，比如第一个工作表）
    const worksheet = workbook.getWorksheet(1);
    // 或者按名称获取：workbook.getWorksheet('Sheet1')

    if (!worksheet) {
      throw new Error('目标工作表不存在');
    }

    // 写入columnA到A列，从A3开始
    columnA.forEach((val, idx) => {
      const row = 3 + idx;
      worksheet.getCell(`A${row}`).value = val;
    });

    // 写入columnB到B列，从B3开始
    columnB.forEach((val, idx) => {
      const row = 3 + idx;
      worksheet.getCell(`B${row}`).value = val;
    });

    // 保存修改后的文件
    await workbook.xlsx.writeFile(targetFilePath);

    res.json({ success: true, msg: '数据写入成功' });
  } catch (err) {
    console.error('写入出错:', err);
    res.status(500).json({ success: false, msg: err.message });
  }
});

// 启动服务器
app.listen(3000, () => {
  console.log('后端服务运行在 http://localhost:3000');
});

报错原因排查 #

你之前的Cannot read properties of undefined (reading 'A3')错误，常见原因：

• 前端直接操作服务器文件：浏览器不允许，导致你获取的工作表对象是undefined
• 后端加载文件失败：路径错误、文件不存在，或者后端进程没有文件读写权限
• 指定的工作表不存在：比如你要操作的Sheet1被改名，导致getWorksheet返回undefined

额外注意事项 #

• 确保服务器上的Excel文件路径正确，且后端进程有读写该文件的权限
• 如果用其他后端语言（比如Python、PHP），逻辑一致：接收前端数据→加载现有Excel→写入数据→保存文件（Python可用openpyxl，PHP可用PhpSpreadsheet）
• 前端发送数据前，确认columnA、columnB数组格式正确，避免空数组或非法值导致后端处理异常

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