app软件定制开发平台_中国中铁股份有限公司_360优化大师官方免费下载_推广平台有哪些

📝 问题背景

在Vue3项目中，当我们需要将包含图片的数据导出到Excel时，常用的sheetjs/xlsx库存在局限性：无法直接导出图片到单元格。本文将提供完整的解决方案，封装可直接复用的工具函数。

---

🎯 解决方案

技术选型

使用exceljs + file-saver组合：

• exceljs：支持图片插入的Excel操作库
• file-saver：前端文件保存工具

功能特性

✅ 支持多图片列导出
✅ 自动识别Base64和DataURL格式
✅ 精确控制图片位置
✅ 异常处理与性能优化

---

🛠 完整实现代码

步骤1：安装依赖

npm install exceljs file-saver

步骤2：创建工具文件

// utils/excelExport.js
import ExcelJS from 'exceljs';
import { saveAs } from 'file-saver';/**** @param headers 表头，[表头1,表头2,...]          必填* @param tableData 内容 [data1,data2,...]       必填* @param imageIndex 图片下标列 [0, 1, 2 , ...],     非必填* @returns {Promise<void>}*/
export const exportToExcel = async (headers, tableData, imageIndex = []) => {const workbook = new ExcelJS.Workbook();const worksheet = workbook.addWorksheet('Sheet1');// 添加表头const headerRow = worksheet.addRow(headers);// 设置表头样式headerRow.eachCell((cell) => {cell.font = {bold: true,color: { argb: 'FFFFFFFF' },size: 12};cell.fill = {type: 'pattern',pattern: 'solid',fgColor: { argb: 'FF007BFF' }};cell.alignment = {horizontal: 'center',vertical: 'middle'};});// 设置列宽headers.forEach((_, colIndex) => {let width = 20; // 默认列宽if (imageIndex.includes(colIndex)) {width = 30; // 图片列更宽}worksheet.getColumn(colIndex + 1).width = width;});// 处理数据行（修改为异步）for (let rowIdx = 0; rowIdx < tableData.length; rowIdx++) {const row = tableData[rowIdx];const dataRow = worksheet.addRow(row);if (imageIndex.length > 0) {// 使用Promise.all处理多列图片await Promise.all(imageIndex.map(async (colIdx) => {const imgUrl = row[colIdx];if (!imgUrl) return;try {const parsed = await parseImageData(imgUrl);if (!parsed) return;const imageId = workbook.addImage({base64: parsed.base64,extension: parsed.extension,});const colLetter = getExcelColumnLetter(colIdx);const excelRow = rowIdx + 2;worksheet.addImage(imageId, {tl: { col: colIdx, row: excelRow - 1 },br: { col: colIdx + 1, row: excelRow },editAs: 'oneCell' // 更稳定的定位方式});} catch (error) {console.error(`图片处理失败（行${rowIdx + 1}列${colIdx + 1}）:`, error);}}));}}// 生成文件const buffer = await workbook.xlsx.writeBuffer();saveAs(new Blob([buffer]), `数据导出_${new Date().getTime()}.xlsx`);
};// 列索引转Excel字母（如：0 -> A, 1 -> B）
const getExcelColumnLetter = (column) => {let letter = '';let col = column + 1;while (col > 0) {const remainder = (col - 1) % 26;letter = String.fromCharCode(65 + remainder) + letter;col = Math.floor((col - 1) / 26);}return letter;
};// 新增：将图片URL转换为base64
const urlToBase64 = async (url) => {try {const response = await fetch(url);const blob = await response.blob();return new Promise((resolve) => {const reader = new FileReader();reader.onloadend = () => resolve(reader.result);reader.readAsDataURL(blob);});} catch (error) {console.error('图片转换失败:', error);return null;}
};// 修改后的解析函数
const parseImageData = async (imgData) => {if (!imgData) return null;// 处理URL情况if (imgData.startsWith('http')) {const dataURL = await urlToBase64(imgData);if (!dataURL) return null;const [header, base64] = dataURL.split(';base64,');const extension = header.split('/')[1];return { base64, extension };}// 原有处理dataURL的逻辑if (imgData.startsWith('data:image')) {const [header, base64] = imgData.split(';base64,');if (!header || !base64) return null;const extension = header.split('/')[1];return { base64, extension };}return null;
};

---

📌 使用示例

Vue3组件调用

<template><button @click="handleExport">导出Excel</button>
</template><script setup>
import { exportDataToExcel } from '@/utils/excelExport';const headers = ['名称', '价格', '主图'];
const tableData = [['商品A', 99.9, 'https://fuss10.elemecdn.com/e/5d/4a731a90594a4af544c0c25941171jpeg.jpeg'], ['商品B', 199.9, '']
];
const imageIndex = [2]; // 第三列为图片列const handleExport = async () => {await exportDataToExcel(headers, tableData, imageIndex);
};
</script>

---

⚙️ 扩展配置

设置列宽

    headers.forEach((_, colIndex) => {let width = 20; // 默认列宽if (imageIndex.includes(colIndex)) {width = 30; // 图片列更宽}worksheet.getColumn(colIndex + 1).width = width;});

设置表头样式

headerRow.eachCell((cell) => {cell.font = {bold: true,color: { argb: 'FFFFFFFF' },size: 12};cell.fill = {type: 'pattern',pattern: 'solid',fgColor: { argb: 'FF007BFF' }};cell.alignment = {horizontal: 'center',vertical: 'middle'};});

---

📌 导出样式

---

⚠️ 注意事项

1. 图片规范

   • 建议使用PNG格式
   • 单图片尺寸不超过500x500px
   • Base64字符串需完整

2. 性能建议

   • 推荐数据量：<1000行
   • 单文件图片：<50张
   • 大文件建议分页导出

3. 常见问题

   • 图片不显示：检查Base64格式是否正确
   • 位置偏移：调整tl/br定位参数
   • 内存溢出：分批次处理数据

---

📚 实现原理

1. 坐标转换
   通过getExcelColumnLetter函数将数字索引转换为Excel字母坐标

2. 图片处理

   • 自动剥离DataURL头信息
   • 支持纯Base64直接使用

3. 定位系统

   // tl: 左上角定位(top-left)
   // br: 右下角定位(bottom-right)
   { tl: { col: 0, row: 0 }, // A1单元格br: { col: 1, row: 1 }  // B2单元格
   }
   

---

💡 总结

本文提供的方案具有以下优势：

1. 开箱即用：封装完整工具函数
2. 灵活配置：支持多图片列、自定义样式
3. 健壮性强：完善的异常处理机制

建议根据实际业务需求调整图片定位参数和样式配置，对于复杂报表建议结合后端生成方案。