ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

npx hucre convert 5分钟上手:终端批量转换Excel、CSV与XLS

npx hucre convert 5分钟上手:终端批量转换Excel、CSV与XLS npx hucre convert 5分钟上手终端批量转换Excel、CSV与XLS【免费下载链接】hucreZero-dependency spreadsheet engine. Read write XLSX, CSV, ODS. Pure TypeScript, works everywhere.项目地址: https://gitcode.com/gh_mirrors/hu/hucrehucre是一个零依赖的电子表格引擎Spreadsheet Engine而npx hucre convert是它最实用的终端命令——一条命令就能在 Excel.xlsx、CSV、TSV、ODS 等格式之间互相转换连npm install都不用。本文将带你 5 分钟学会用它批量转换 Excel、CSV 与 XLS 文件并附赠编码修复、标准输入输出、批量脚本等进阶技巧。为什么需要 npx hucre convert日常办公中这些场景你一定不陌生 对方发来一个.xlsx你却只需要一个纯文本的 CSV 给程序处理 一堆老旧的.xls文件需要迁移成现代.xlsx 从 Windows 导出的 CSV 打开全是乱码windows-1254 / windows-1250 编码 想把手上的 CSV 批量打包成 Excel 发给客户传统做法是打开 Excel 手动另存为文件一多就崩溃。而npx hucre convert把这件事变成一行终端命令并且零依赖——不需要安装任何 Excel 组件Node.js 环境下直接运行。支持哪些格式一览转换矩阵方向支持格式可读输入.xlsx、.ods、.csv、.tsv、.json、.ndjson/.jsonl、.xml、.html、.xls、.xlsb可写输出以上全部.xls、.xlsb除外只读 输出专属的.md几个值得注意的细节.tsv会自动使用制表符分隔不会写成逗号分隔的假 TSV.mdMarkdown是只写格式表格可以导出为 Markdown但不会从 Markdown 读回数据从管道读入没有扩展名可判断时hucre 会根据内容自动嗅探格式格式识别的实现都在 src/cli/commands.ts 中非常易读。5分钟上手3 条核心命令确保本机已安装Node.js 24然后直接开始npx会自动下载运行无需全局安装1. Excel 转 CSVxlsx → csvnpx hucre convert input.xlsx output.csv2. CSV 转 Excelcsv → xlsxnpx hucre convert input.csv output.xlsx3. 老旧 XLS 升级成 XLSXxls → xlsxnpx hucre convert legacy.xls output.xlsx.xlsb二进制 Excel同样可以作为输入读取。转换时会提示Reading → Read N sheet(s) → Written全程只需几秒。 转换保留单元格数值和 sheet 名称但不携带样式、合并单元格、公式与图表——这正是终端转换工具的合理边界。进阶技巧管道、编码与 BOM标准输入输出-代表管道把-作为输入或输出路径就能在 shell 管道中使用约定见 src/cli/commands.ts# 管道进CSV 从 stdin 读入写成 xlsx cat data.csv | npx hucre convert - out.xlsx # 管道出xlsx 读出后以 CSV 格式写到 stdout必须用 --to 指定格式 npx hucre convert in.xlsx - --to csv # 管道直通CSV 转 Markdown 表格 cat data.csv | npx hucre convert - - --to md写到 stdout 时必须加--to 格式因为管道没有扩展名可读hucre 宁愿你明确指定也不愿猜出一个二进制格式喷到终端里。修复 CSV 乱码--encoding来自土耳其或中东欧地区 Excel 的 CSV 常使用 windows-1254 / windows-1250 编码hucre 会先按字节序标记BOM判断判不出来就显式指定npx hucre convert veriler.csv out.xlsx --encoding windows-1254编码嗅探与 BOM 处理在 src/csv/encoding.ts 中实现。让 Excel 正确识别 UTF-8--bom反过来导出的 CSV 要拿给 Excel 打开可以加 BOM避免非 UTF-8 系统 locale 下出现乱码npx hucre convert in.xlsx out.csv --bom批量转换一次处理整个目录convert配合 shell 循环即可完成批量任务例如把data/下所有 CSV 转成 Excelfor f in data/*.csv; do npx hucre convert $f out/$(basename ${f%.csv}).xlsx done再比如批量把老旧 XLS 升级for f in legacy/*.xls; do npx hucre convert $f modern/$(basename ${f%.xls}).xlsx done想先确认文件内容再转换用inspect命令npx hucre inspect file.xlsx # 查看所有 sheet 概况 npx hucre inspect file.xlsx --sheet 0 # 预览第 0 个 sheet 的前 10 行inspect会列出每个 sheet 的行列数和单元格类型统计字符串/数字/日期/布尔/空值是批量处理前的体检好帮手。数据入库前顺手校验validate转换只是第一步如果数据要进入生产流程hucre 还内置了基于 JSON Schema 的校验命令npx hucre validate data.xlsx --schema schema.json它会逐行报告第 N 行、第 X 列错误原因校验失败时返回非零退出码可以直接嵌入 CI 流水线。校验逻辑位于 src/_schema.ts。常见问题FAQQ为什么输出文件不能是 .xls.xls和.xlsb是只读格式——hucre 能读它们这正是升级老旧文件的价值所在但没有对应的写入器。指定为输出时会收到明确的错误提示而不是笼统的不支持。Q转换会丢失样式、公式、图表吗会。convert只搬运单元格数值与 sheet 名称这是终端转换的明确边界官方文档中也有同样说明见 README.md 的 CLI 章节。Q多 sheet 文件转 CSV 会怎样CSV 本身是单表格式hucre 会取第一个 sheet。需要多 sheet 时请输出.xlsx或.ods。Qhucre 和 SheetJS 有什么区别hucre 零依赖、纯 TypeScript、原生 ESM、可按需 tree-shake仅 CSV 部分约 3.7 KB gzip并且完整支持 ODS 与流式读写。详细对比见 docs/PARITY.md。源码从哪里看内容路径convert / inspect / validate 命令定义src/cli/commands.ts入口与自动嗅探的read/writesrc/defter.tsCSV 读取含分隔符嗅探src/csv/reader.tsXLSX 读写器src/xlsx/reader.ts、src/xlsx/writer.tsCLI 集成测试test/cli.test.ts小结npx hucre convert把Excel ⇄ CSV ⇄ XLS 的格式转换变成了 5 分钟就能上手的终端操作✅ 三条基础命令覆盖 xlsx/csv/xls 互转✅-管道约定 --to支持脚本串联✅--encoding/--bom专治 CSV 乱码✅ shell 循环即可批量处理整个目录✅ 附赠inspect体检与validateSchema 校验零安装、零依赖、跑在 Node.js 24这就是 hucre 作为电子表格瑞士军刀的终端面。【免费下载链接】hucreZero-dependency spreadsheet engine. Read write XLSX, CSV, ODS. Pure TypeScript, works everywhere.项目地址: https://gitcode.com/gh_mirrors/hu/hucre创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表