表格数据格式转换工作流

目标与适用范围

在 CSV、电子表格、JSON、HTML 表格、Markdown、XML 和文本之间转换，同时检查表头、分隔符、类型与编码。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 准备源数据的代表性副本，并确认第一行是否为表头。

• 在转换前记录预期分隔符、文本编码、引号规则和各列类型。

• 决策点: 是否需要先检测源文件？. 当分隔符、编码、表头或推断类型不确定时先检测并规范化，否则可以直接转换。

• 决策点: 目标格式服务于什么用途？. 编辑选电子表格，接口交换选 JSON，展示选 HTML 或 Markdown，需要层级结构时选 XML。

• 决策点: 能否验证往返结果？. 将小样本转回原表示，比较表头、行数、空值、转义字符和代表性类型。

按步骤完成工作流

1. 检测并规范化源数据

检测电子表格或分隔文本的结构，在导出前处理表头、分隔符、编码和列类型。 使用 xlsx-csv-detect-normalize, text-to-csv.

2. 导出电子表格工作表

将单个或批量工作表导出为 CSV，保留工作表名称并逐个检查生成文件的列。 使用 xlsx-csv-batch-converter, xlsx-sheet-to-csv-pack, excel-to-csv.

3. 在 CSV 与结构化记录间转换

当下游程序需要记录数组或表格交换格式时，在 CSV 与 JSON 之间转换。 使用 csv-to-json, json-to-csv.

4. 生成可读表格

将 CSV 渲染为 HTML 或 Markdown 表格，也可把已有表格导回 CSV 并检查转义与列对齐。 使用 csv-to-html-table, csv-to-markdown, html-table-to-csv, markdown-to-csv.

5. 交换 XML 与表格数据

在 CSV 与 XML 间转换，核对重复行、缺失字段和文本编码是否符合预期结构。 使用 csv-to-xml, xml-to-csv, csv-to-excel.

交付前验收结果

• 除非记录了有意映射，否则表头与列顺序保持一致。
• 目标文件明确且可读地保留分隔符、引号、换行和编码。
• 数字、日期、空值和文本标识符没有被静默转换。
• 转换前后的行数和代表性值一致，或已解释差异。

常见问题

• 如何保留前导零？ 在检测和转换时将编号列设为文本，不要让电子表格把它推断为数字。
• 什么时候需要规范化？ 当分隔符、编码、表头、引号风格或列类型未知或不一致时，应先规范化。
• CSV 转 JSON 能完全还原吗？ 定义清晰的模式后通常可以保持结构，但空值、重复表头、日期和数字型编号必须先规定规则。
• 人阅读应选哪种格式？ 网页展示用 HTML，文档用 Markdown；系统交换则根据接口选择 JSON、XML 或 CSV。