使用Node.js ExcelJS库实现动态列Excel导出的问题求助

问题分析 #

你的代码存在三个核心问题：

• 动态列key重复：遍历每个goal时都重置i=1，不同goal的新字段会生成重复的CustomFieldN key，导致列映射混乱。
• 重复添加行：在m.fields循环内调用addRow，同一个goal会被添加N行（N为动态字段数量），不符合预期。
• 硬编码动态字段：手动写死CustomField1到CustomField5，无法根据实际动态字段数量灵活映射。

修正方案 #

1. 先收集所有唯一动态字段，统一创建列

先遍历所有goal，收集不重复的动态字段，再一次性添加到工作表列中，确保每个字段对应唯一的列key。

2. 构建完整行数据后再添加

每个goal只创建一个行对象，先填充静态字段，再遍历当前goal的动态字段，匹配对应的列key并赋值，最后一次性调用addRow。

修正后的完整代码 #

const stream = new Stream.PassThrough();
const workbook = new excel.stream.xlsx.WorkbookWriter({
    stream: stream,
});

let worksheet = workbook.addWorksheet("Goals");

// 静态列定义
const staticColumns = [
    { header: "Name", key: "goal_name", width: 15 },
    { header: "Description", key: "goal_description", width: 15 },
    { header: "Created Date", key: "created", width: 20 },
    { header: 'Privacy Type', key: 'privacy_types_id', width: 20 },
    { header: 'Priority', key: 'priority', width: 20 },
    { header: 'Progress', key: 'progress', width: 20 },
];
worksheet.columns = [...staticColumns];

// 收集所有唯一的动态字段（避免重复列）
const dynamicFields = new Set();
_goals.forEach(m => {
    if (m.fields?.length > 0) {
        m.fields.forEach(item => dynamicFields.add(item.field_name));
    }
});

// 添加动态列
let customFieldIndex = 1;
dynamicFields.forEach(fieldName => {
    const columnKey = `CustomField${customFieldIndex}`;
    worksheet.columns.push({
        header: fieldName,
        key: columnKey,
        width: 15
    });
    customFieldIndex++;
});

// 添加所有行数据
_goals.forEach(m => {
    // 初始化静态字段数据
    const rowData = {
        goal_name: m.name,
        goal_description: m.purpose,
        created: m.created,
        privacy_types_id: m.privacy_types_id,
        priority: m.priority,
        progress: m.stats?.progress || '' // 处理progress可能不存在的情况
    };

    // 填充动态字段数据
    if (m.fields?.length > 0) {
        // 建立字段名到列key的映射（方便快速查找）
        const fieldToKeyMap = worksheet.columns
            .filter(col => col.key.startsWith('CustomField'))
            .reduce((map, col) => {
                map[col.header] = col.key;
                return map;
            }, {});

        m.fields.forEach(item => {
            const columnKey = fieldToKeyMap[item.field_name];
            if (columnKey) {
                rowData[columnKey] = item.value;
            }
        });
    }

    // 一次性添加整行
    worksheet.addRow(rowData);
});

worksheet.commit();
workbook.commit();

const file_uuid = uuidv4();
const name = 'Goals list';
const mimetype = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'; // 修正xlsx的正确mimetype
const ext = 'xlsx';

关键改进点 #

• 使用Set收集唯一动态字段，避免重复创建列。
• 提前建立字段名到列key的映射，快速匹配动态字段对应的列。
• 每个goal只生成一个行对象，避免重复添加行。
• 修正了xlsx文件的正确mimetype（原代码用了xls的类型）。

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