hucre：零依赖的 TypeScript 电子表格引擎，但 ODS 与 XLSX 之间存在明显的取舍

它解决什么问题：现代 JS 生态中的表格处理空白

在 JavaScript 生态里，处理电子表格长期被几个老牌库主导，但它们都带着历史包袱。SheetJS CE 从 npm 消失，只能从 CDN 安装；ExcelJS 依赖 9 个包且是 CommonJS；xlsx-js-style 的样式支持有限。hucre 瞄准的正是这个缝隙：一个零依赖、原生 ESM、TypeScript 编写、能在边缘运行时（如 Cloudflare Workers）运行的库。它的目标用户是那些需要读写 XLSX、CSV、ODS，但不想为了一个表格功能引入 300 KB 依赖的团队。更重要的是，hucre 把体积当作一等公民，通过 tree-shaking 让用户只加载自己用到的格式解析器。

核心机制：按格式拆包与 tree-shaking 设计

hucre 的架构围绕模块化入口展开。主包 `hucre` 导出所有功能，但专门入口如 `hucre/xlsx`、`hucre/csv`、`hucre/ods` 允许只引入所需格式。这种设计直接反映在体积上：仅 `parseCsv` 和 `writeCsv` 的 gzip 后约 3.7 KB，`readXlsx` 约 34 KB，整个库全量约 129 KB。这些数字不是宣传口号，而是被 CI 强制执行的预算，仓库里有 `scripts/size-budget.json`，一旦体积超限构建就会失败。README 还提到这些数字曾经漂移过，旧版本标注的 2.3 / 32 / 64 / 114 KB 在无人监督时失真，现在用脚本钉住了。这说明项目对体积控制有实际机制，而非空谈。

安装与运行：从 npm 到第一个读写示例

安装很简单，`npm install hucre` 即可。读取 XLSX 的代码是异步的：`const workbook = await readXlsx(buffer)`，然后可以访问 `workbook.sheets[0].rows`。写入时构造一个对象，指定工作表名称、列定义（含宽度和数字格式）以及行数据。列定义支持 `numFmt: "$#,##0.00"` 这样的格式字符串，说明它至少能处理价格格式。读取选项包括 `sheets` 过滤（按索引或名称）、`readStyles` 控制是否解析样式、`dateSystem: "auto"` 自动检测 1900/1904 日期系统。这些选项表明它考虑了实际使用中的常见需求，比如只读特定工作表或处理不同日期纪元。

格式支持矩阵：XLSX 是主角，ODS 有明确边界

hucre 支持 XLSX、CSV、ODS、JSON、NDJSON、XML 的读写，但每种格式的深度不同。XLSX 支持条件格式的 13 种类型（如 `cellIs`、`colorScale`、`dataBar`），还支持迷你图（sparklines）和图片。ODS 则只支持六种样式方面：粗体、斜体、字号、字体颜色、背景色和数字格式。边框、对齐、列宽、冻结窗格、验证、命名区域、图片和页面设置都不建模。这意味着 ODS 到 ODS 是无损的，但 XLSX 转 ODS 会丢失这些元素。这是一个明显的取舍：如果你主要处理 ODS 文件，且需要完整样式，hucre 可能不是最佳选择。

流式与枢轴表：功能存在但有保留

hucre 宣称支持流式读写，这在处理大文件时很重要，但 README 没有给出流式 API 的具体示例，只提到“Stream read + write”在对比表中为“Yes”。枢轴表的支持是“Read + Write (skel)”，意思是它写入枢轴缓存、布局和关系，但不写预计算的值单元格，Excel 会在首次打开时填充。这是一个务实的设计，避免重复计算逻辑，但如果你依赖预先计算的值（比如在服务端生成报表），这可能是个问题。此外，hucre 没有公式求值引擎，对比表中明确显示“Formula eval: No”。因此它适合处理数据，不适合需要计算结果的工作流。

与现有库的对比：轻量 vs 功能广度

对比表显示 hucre 在依赖数、ESM 原生支持、边缘运行时兼容性和 CSP 合规性上占优。SheetJS CE 虽然零依赖，但已从 npm 移除，只能从 CDN 安装，这对现代构建流程是个麻烦。ExcelJS 有 9 个依赖且是 CJS，在浏览器或边缘环境可能有问题。但 ExcelJS 支持样式和图表，而 hucre 的图表只是“round-trip”，即读写但不创建新图表。在 Python 生态中，openpyxl 支持 15+ 图表类型，而 hucre 不创建图表。这说明 hucre 的定位是轻量读写，不是完整办公套件替代品。如果你的需求是生成带图表和复杂格式的 Excel 报表，现有库可能更合适。

维护与升级：版本节奏和许可证

hucre 采用 MIT 许可证，这对商业项目友好，没有 copyleft 义务。最近版本节奏较快：v1.1.0 发布于 2026 年 8 月 13 日，v1.0.0 在 8 月 4 日，v0.6.2 在 7 月 21 日。这说明项目在活跃迭代，但 v1.0 刚发布不到两周，API 可能仍会变动。README 提到体积预算已经漂移过一次，说明项目对回归有意识，但用户仍应锁定版本并关注更新日志。由于零依赖，升级成本较低，不用担心传递依赖的破坏性变化。不过，如果你需要长期稳定性，建议在 CI 中固定版本，并定期测试新版本是否影响你的文件兼容性。

编辑结论

hucre 适合那些已经使用 ESM 和现代打包工具、需要跨格式读写且对包体积敏感的 TypeScript 项目，尤其是边缘运行时或 CSP 受限环境。不适合需要公式计算、复杂 ODS 样式或 Excel 专有功能（如枢轴表预计算值）的场景。在采用前，请先在目标运行时（如 Node、Deno、Cloudflare Workers）用真实文件测试 readXlsx 与 writeXlsx 的往返一致性，并检查 ODS 往返时样式丢失是否可接受。若项目依赖 SheetJS 的 CDN 安装方式，迁移前需确认 npm 工作流。

官方来源

1. Official documentation
2. Official README
3. Project repository
4. Release notes