当前位置：首页 > article >正文

使用 `xlsx` 库读取和写入 Excel 文件

article 2025/3/19 7:13:31

1. 环境准备

首先，确保你已经安装了 Node.js 和 npm（Node 包管理器）。如果还没有安装，可以从 Node.js 官方网站下载并安装最新版本。

接下来，创建一个新的项目目录，并初始化一个新的 Node.js 项目：

mkdir excel-demo
cd excel-demo
npm init -y

2. 安装依赖

我们将使用 xlsx 库来处理 Excel 文件。通过以下命令安装 xlsx：

npm install xlsx

3. 创建读取和写入 Excel 文件的脚本

3.1 读取 Excel 文件

下面是一个简单的示例脚本，展示如何读取 Excel 文件中的数据。

const xlsx = require('xlsx');

// 读取Excel文件
function readExcel(filePath) {
    // 加载工作簿
    const workbook = xlsx.readFile(filePath);

    // 获取第一个工作表的名字
    const sheetName = workbook.SheetNames[0];

    // 获取工作表
    const worksheet = workbook.Sheets[sheetName];

    // 将工作表转换为JSON格式
    const jsonData = xlsx.utils.sheet_to_json(worksheet, { header: 1 });

    console.log('Excel Data:');
    console.log(jsonData);
}

// 示例：读取当前目录下的example.xlsx文件
readExcel('./example.xlsx');

3.2 写入 Excel 文件

下面是一个简单的示例脚本，展示如何写入数据到新的 Excel 文件。

const xlsx = require('xlsx');

// 写入Excel文件
function writeExcel(data, filePath) {
    // 创建一个新的工作簿
    const workbook = xlsx.utils.book_new();

    // 将数据转换为工作表
    const worksheet = xlsx.utils.json_to_sheet(data);

    // 将工作表添加到工作簿
    xlsx.utils.book_append_sheet(workbook, worksheet, 'Sheet1');

    // 将工作簿保存为Excel文件
    xlsx.writeFile(workbook, filePath);

    console.log(`Data has been written to ${filePath}`);
}

// 示例数据
const data = [
    { name: 'John', age: 30, city: 'New York' },
    { name: 'Anna', age: 25, city: 'London' },
    { name: 'Mike', age: 32, city: 'San Francisco' }
];

// 示例：写入当前目录下的output.xlsx文件
writeExcel(data, './output.xlsx');

4. 完整示例

下面是一个完整的示例，展示了如何读取一个 Excel 文件，并将其内容写入到另一个 Excel 文件中。

const xlsx = require('xlsx');

// 读取Excel文件
function readExcel(filePath) {
    // 加载工作簿
    const workbook = xlsx.readFile(filePath);

    // 获取第一个工作表的名字
    const sheetName = workbook.SheetNames[0];

    // 获取工作表
    const worksheet = workbook.Sheets[sheetName];

    // 将工作表转换为JSON格式
    const jsonData = xlsx.utils.sheet_to_json(worksheet, { header: 1 });

    return jsonData;
}

// 写入Excel文件
function writeExcel(data, filePath) {
    // 创建一个新的工作簿
    const workbook = xlsx.utils.book_new();

    // 将数据转换为工作表
    const worksheet = xlsx.utils.json_to_sheet(data);

    // 将工作表添加到工作簿
    xlsx.utils.book_append_sheet(workbook, worksheet, 'Sheet1');

    // 将工作簿保存为Excel文件
    xlsx.writeFile(workbook, filePath);

    console.log(`Data has been written to ${filePath}`);
}

// 示例：读取当前目录下的example.xlsx文件
const inputFilePath = './example.xlsx';
const outputFilePath = './output.xlsx';

// 读取Excel文件中的数据
const excelData = readExcel(inputFilePath);

// 将数据写入到新的Excel文件
writeExcel(excelData, outputFilePath);

5. 运行脚本

确保你的项目目录中有一个名为 example.xlsx 的 Excel 文件，然后运行以下命令来执行脚本：

node your_script_name.js

这将读取 example.xlsx 文件的内容，并将其写入到 output.xlsx 文件中。

6. 处理复杂的数据结构

如果你需要处理更复杂的数据结构，比如多张工作表或带有特定格式的数据，可以参考 xlsx 库的文档，它提供了丰富的 API 来满足各种需求。

例如，读取多个工作表：

const xlsx = require('xlsx');

function readAllSheets(filePath) {
    const workbook = xlsx.readFile(filePath);
    const allSheets = {};

    workbook.SheetNames.forEach(sheetName => {
        const worksheet = workbook.Sheets[sheetName];
        const jsonData = xlsx.utils.sheet_to_json(worksheet, { header: 1 });
        allSheets[sheetName] = jsonData;
    });

    return allSheets;
}

const allSheets = readAllSheets('./example.xlsx');
console.log(allSheets);