如何将 CSV 文本转换为 HTML 表格

先确认输入与转换范围

这个工具适合把已经准备好的 CSV 文本整理成 HTML 表格，方便放入支持 HTML 的网页内容中。它的输入重点是文本，而不是通用文件或电子表格。转换前可以决定第一行是否承担表头作用，也可以为生成的表格指定 class，从而让后续样式设置有明确的选择器。使用时应先确认数据的行列结构，再判断表头选项是否符合你的展示目的。

按顺序生成并检查 HTML 表格

1. 在输入区域粘贴或输入 CSV 文本。输入框的默认内容为空，因此开始操作时需要先提供待转换的文本；如果只输入空格或其他空白字符，工具会直接返回空的 HTML 结果，并显示 0 行、0 列。 2. 检查表头选项是否开启。默认情况下该选项已开启，第一行会被解析为表头，后续行会作为表格主体；关闭后，解析出的每一行都会作为主体内容，不会生成表头单元格。数据第一行是字段名称时，通常应保留开启状态；如果每一行地位相同，则可关闭该选项。 3. 按需填写表格 class。未填写时，默认 class 是 csv-table；填写自定义值后，生成结果会使用该值。单元格文字和表格 class 在写入 HTML 前会进行 HTML 转义，因此包含特殊 HTML 字符的内容不会按原字符直接插入标签结构。 4. 执行转换后，查看生成的 HTML 表格以及行数和列数。启用表头时，报告的行数排除第一行，只表示主体行数量；关闭表头时，报告的行数包含解析出的每一行。列数取解析行中字段数量最多的一行，较短的主体行会补充空单元格以对齐该列数，但较短的表头行不会自动补齐。 5. 使用结果时，把生成的表格放到需要 HTML 的位置，并依据填写的 class 配置样式。若主要处理阶段发生异常，工具会返回成功状态，同时给出空 HTML、0 行、0 列和错误详情；这类结果应结合错误详情检查输入或处理情况，而不应只看成功状态。

根据行列统计判断结果

解读结果时，先把表头选项与行数放在一起判断。启用表头代表第一行承担字段名称的作用，所以显示的行数可能比输入中可见的行数少一行；关闭选项后，行数则按照解析出的主体记录计算。列数并不取第一行的长度，而是取解析结果中字段最多的那一行，因此数据长度不一致时，主体部分可能出现用于补齐的空单元格。表头较短时不会获得同样的自动补齐处理。空白输入的空 HTML、0 行和 0 列是预期的空结果；非空输入若同时出现这些数值并附带错误详情，则说明处理过程中报告了异常。HTML 转义只说明单元格文字与 class 会以转义后的形式写入生成表格，不能据此判断原始 CSV 的其他排版或格式会被保留。

使用示例

你需要把两条包含姓名和城市的数据放进网页表格，并让生成结果带有指定的 class。

输入三行 CSV 内容：第一行写“姓名,城市”，第二行写“林梅,广州”，第三行写“周宁,深圳”；保持表头选项开启，填写表格 class 为 sales-table，然后执行转换。

结果应包含一个 HTML 表格，其中第一行作为表头，后两行作为表格主体；报告行数为 2，列数为 2，表格使用填写的自定义 class。

使用限制

• 已确认的用途是把提供的 CSV 文本转换成 HTML 表格，不能将其扩展理解为通用文件处理、电子表格处理或转换回 CSV 的工具。

常见错误

• 误把表头计入主体行数通常是因为忽略了表头选项的状态；先确认该选项，再按主体行数量读取报告值。

常见问题

空白 CSV 输入会产生什么结果？

输入为空或只含空白字符时，工具会返回空 HTML 结果，并将行数和列数显示为 0；要生成表格，应先输入非空的 CSV 文本。

开启表头后应怎样理解行数？

开启表头处理后，第一条解析行会渲染成表头，其余解析行会渲染成主体，报告行数不包含这条表头行；关闭该设置时，解析行均作为主体内容计算。

生成的表格支持自定义 class 吗？

可以填写自定义 class；留空时采用 csv-table，而填写的 class 会在写入生成 HTML 之前经过转义处理。