1. 为什么要把命令行工具搬到Web上?
最近接手了一个老项目,里面有个用Python写的Excel转JSON工具。这个工具是用openpyxl库开发的,然后打包成exe文件给业务人员使用。说实话,每次看到业务同事对着黑乎乎的cmd窗口一脸茫然的样子,我就觉得特别过意不去。更麻烦的是,每次需求变更都要重新打包分发,效率实在太低了。
于是我们决定把这个工具搬到Web上。Web应用有几个明显优势:首先,用户界面友好,再也不用面对命令行;其次,更新维护方便,改完代码直接部署就行;最重要的是可以随时随地使用,只要有浏览器就能操作。不过这个迁移过程也踩了不少坑,特别是Excel处理这块,前后端方案的选择就让我纠结了好久。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型:SheetJS vs ExcelJS
2.1 ExcelJS的优缺点分析
最开始我考虑的是ExcelJS,这个库完全开源,所有功能都可以免费使用。它的API设计比较规范,文档也相对完善。但是实际测试后发现几个问题:
- 单元格访问方式比较啰嗦,必须用
ws.getCell('A1')这样的写法,不如Python的ws['A1']直观 - 合并单元格的处理比较麻烦,官方文档里没找到直接获取合并信息的方法
- 文件体积较大,压缩后还有200多KB
javascript复制// ExcelJS的典型用法示例
const cell = worksheet.getCell('A1');
console.log(cell.value);
2.2 为什么最终选择SheetJS
相比之下,SheetJS有几点特别吸引我:
- 支持
ws['A1']这种简洁的访问方式,和Python习惯一致 - 合并单元格信息可以直接通过
!merges属性获取 - 社区版压缩后只有100KB左右,加载更快
- 支持前后端通用,一套代码可以跑在不同环境
html复制<!-- 最简单的SheetJS引入方式 -->
<script src="https://cdn.sheetjs.com/xlsx-latest/package/dist/xlsx.full.min.js"></script>
不过要注意的是SheetJS有社区版和专业版之分。专业版支持样式、图表等高级功能,但价格不菲。如果只是基础的数据读写,社区版完全够用。
3. 核心功能迁移实战
3.1 读取Excel文件的完整方案
原来的Python工具主要做三件事:读取Excel、处理数据、输出JSON。迁移到前端后,读取逻辑需要重新设计。这里分享我的实现方案:
javascript复制function handleFile(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 firstSheetName = workbook.SheetNames[0];
const worksheet = workbook.Sheets[firstSheetName];
// 处理合并单元格
processMerges(worksheet);
// 转换为JSON
const jsonData = XLSX.utils.sheet_to_json(worksheet);
console.log(jsonData);
};
reader.readAsArrayBuffer(file);
}
function processMerges(ws) {
if(!ws['!merges']) return;
ws['!merges'].forEach(merge => {
const start = XLSX.utils.encode_cell(merge.s);
const end = XLSX.utils.encode_cell(merge.e);
console.log(`合并区域:${start}:${end}`);
});
}
这个方案有几个关键点:
- 使用FileReader读取用户上传的文件
- 通过Uint8Array处理二进制数据
- 自动识别合并单元格并处理
- 最终输出格式与Python版保持一致
3.2 处理合并单元格的坑
合并单元格是Excel处理的难点之一。在SheetJS中,合并信息存储在!merges属性里,每个合并区域包含start(s)和end(e)坐标。这里有个容易踩的坑:合并区域只有左上角单元格有值,其他单元格都是空的。
我的解决方案是遍历所有合并区域,把值复制到每个被合并的单元格:
javascript复制function fillMergedCells(worksheet) {
if(!worksheet['!merges']) return;
worksheet['!merges'].forEach(merge => {
const startCell = XLSX.utils.encode_cell(merge.s);
const value = worksheet[startCell] ? worksheet[startCell].v : null;
// 遍历合并区域所有单元格
for(let r = merge.s.r; r <= merge.e.r; r++) {
for(let c = merge.s.c; c <= merge.e.c; c++) {
const cellAddress = XLSX.utils.encode_cell({r, c});
if(!worksheet[cellAddress]) {
worksheet[cellAddress] = {t: 's', v: value};
}
}
}
});
}
4. 构建完整的Web应用
4.1 前端界面设计
为了让工具更易用,我设计了一个简洁的界面:
- 文件上传区域
- 数据预览表格
- 处理选项(如是否包含表头)
- 下载JSON按钮
html复制<div class="container">
<h1>Excel转JSON工具</h1>
<input type="file" id="fileInput" accept=".xlsx,.xls" />
<div class="options">
<label>
<input type="checkbox" id="headerRow" checked />
第一行为表头
</label>
</div>
<div id="preview"></div>
<button id="downloadBtn" disabled>下载JSON</button>
</div>
4.2 与后端交互的优化
虽然SheetJS可以完全在前端运行,但考虑到大文件处理性能,我增加了后端API支持。当前端遇到大文件时,会自动切换到后端处理:
javascript复制async function processLargeFile(file) {
const formData = new FormData();
formData.append('file', file);
try {
const response = await fetch('/api/convert', {
method: 'POST',
body: formData
});
return await response.json();
} catch (error) {
console.error('后端处理失败:', error);
throw error;
}
}
5. 性能优化技巧
5.1 大文件分片处理
测试发现,超过10MB的Excel文件在前端处理会明显卡顿。我的解决方案是使用Web Worker进行后台处理:
javascript复制// worker.js
self.importScripts('https://cdn.sheetjs.com/xlsx-latest/package/dist/xlsx.full.min.js');
self.onmessage = function(e) {
const data = new Uint8Array(e.data);
const workbook = XLSX.read(data, {type: 'array'});
const jsonData = XLSX.utils.sheet_to_json(workbook.Sheets[workbook.SheetNames[0]]);
self.postMessage(jsonData);
};
// 主线程
const worker = new Worker('worker.js');
worker.onmessage = function(e) {
console.log('处理完成:', e.data);
};
worker.postMessage(fileData, [fileData.buffer]);
5.2 内存管理注意事项
SheetJS处理时会占用较多内存,特别是大文件。需要注意:
- 及时释放不再使用的变量
- 避免在循环中重复创建workbook
- 使用try-catch处理可能的内存溢出
javascript复制function processData() {
let workbook = null;
try {
workbook = XLSX.read(data);
// ...处理逻辑
} finally {
// 手动释放内存
workbook = null;
}
}
6. 实际项目中的扩展功能
6.1 多Sheet处理
很多Excel文件包含多个工作表,我们扩展了工具支持:
- 显示所有Sheet列表
- 允许选择要转换的Sheet
- 支持合并多个Sheet的数据
javascript复制function processMultiSheets(workbook) {
const result = {};
workbook.SheetNames.forEach(name => {
const ws = workbook.Sheets[name];
result[name] = XLSX.utils.sheet_to_json(ws);
});
return result;
}
6.2 数据校验与转换
增加了数据校验功能,比如:
- 检查必填字段
- 验证数据格式
- 自动转换日期格式
javascript复制function validateData(jsonData) {
return jsonData.map(row => {
if(!row.name) {
throw new Error('名称字段不能为空');
}
if(row.date) {
row.date = convertExcelDate(row.date);
}
return row;
});
}
function convertExcelDate(excelDate) {
// Excel日期是从1900年1月1日开始的天数
const utcDays = Math.floor(excelDate - 25569);
return new Date(utcDays * 86400 * 1000);
}
7. 部署与更新策略
7.1 静态资源部署
由于是纯前端应用,可以直接部署到任何静态服务器:
- 使用CDN加速SheetJS加载
- 配置缓存策略提高性能
- 添加Service Worker支持离线使用
bash复制# 简单的部署命令示例
npm install -g serve
serve -s dist
7.2 版本更新方案
为了避免缓存问题,我们采用以下策略:
- 文件名带hash版本号
- 每次更新修改manifest文件
- 通过API检查版本更新
javascript复制// 检查版本更新
async function checkUpdate() {
const resp = await fetch('/version.json');
const {version} = await resp.json();
if(version > currentVersion) {
showUpdateNotification();
}
}
整个迁移过程花了我们两周时间,最终效果非常不错。业务同事反馈新工具简单易用,再也不用面对命令行窗口了。维护成本也大幅降低,现在修改功能后只需要部署一次,所有用户都能立即用到最新版本。
