CSV 查看器

本页是使用 DevUtilities CSV Viewer 预览 CSV 的权威指南。在上方打开文件，然后查看分隔符/表头、排序、大文件限制、编码以及交接至 JSON/CSV 等章节。解析留在浏览器本地。

CSV Viewer 是面向逗号分隔值的客户端表格预览。它将第一行解析为表头，渲染可排序网格，并将全文保存在内存中，以便在 ETL、JSON 转换或工单附件之前检查导出。

你将获得

• 通过 FileReader（文本）的文件选择 / 拖放加载
• RFC 4180 风格解析：逗号、引号字段、转义引号
• 第一行作为列标题
• 可点击表头排序（localeCompare，升/降序）
• 表格界面中的行数与列数
• 仅本地处理 — 电子表格内容不会上传

在以下情况使用此查看器

• 无需打开 Excel 即可快速查看导出
• 在 JSON/CSV 转换前验证表头与行形态
• 检查引号与逗号是否在导出中保留
• 对客户或薪资 CSV 必须保持离线

此工具如何帮助

1. 从磁盘打开 .csv。
2. 确认表头名称与生产者 schema 一致。
3. 对照预期导出大小检查行数。
4. 点击列标题排序；再点反转。
5. 扫描不规则行或看似合并的值。
6. 若字符异常（é、’），在源头修复编码并重新加载。
7. 转换时将 CSV 复制到 JSON ↔ CSV、Dev Toolkit Columns → JSON 或你的 ETL。

解析器以逗号分隔。第一个非空逻辑行成为表头；之后每一行都是按列索引对齐的数据行。

会检测什么

• 逗号 (,) 作为字段分隔符
• 可包含逗号与换行的双引号字段
• 引号字段内以双引号转义 ("")
• CRLF 与 LF 行终止符

不会自动检测什么

• 欧盟 Excel 导出常见的分号 (;) 或制表符 (\t) 分隔符
• 单独的「有表头」开关 — 第 0 行始终是表头
• 类型推断（数字/日期在网格中仍为字符串）

实用提示

实用提示

排序通过 localeCompare 对单元格字符串做字典序。适合扫描类别和 ID，不适合数值大小顺序。

• 点击表头升序；再点降序
• 数字列按文本排序（「10」在「2」前）
• 空单元格为空字符串；不规则行可能使值视觉错位
• 加载新文件时排序状态重置
• 用 行 × 列 元信息行核对导出完整性

供应商发来 overnight.csv。在加载到数仓作业前，你需要确认表头、行数，以及带引号的逗号没有拆分字段。

此工具如何帮助

1. 打开文件，对照合同 schema 朗读表头行。
2. 将显示行数与供应商清单比较。
3. 对关键列（order_id、email）排序，目视空白或重复。
4. 打开可疑行的单元格 — 带引号的地址字段应留在一列。
5. 若形态错误，在 ETL 前拒绝或重新索取文件。

结果：在预览时发现问题，而不是在流水线失败之后。

你需要用于 API mock 或 LLM 工具 schema 的对象，但真相来源仍是 CSV 导出。

此工具如何帮助

1. 在 CSV Viewer 中预览，确认表头干净（无空白名、无重复标题）。
2. 将 CSV 文本复制到 Dev Toolkit → Columns → JSON 得到对象数组，或用 JSON ↔ CSV 做往返。
3. 在接线 mock 前用 JSON Formatter 验证样本对象。
4. 保留 CSV 作为审计产物；只提交已清理的样本。

结果：在预览时发现问题，而不是在流水线失败之后。

姓名显示为 José，或弯引号显示为 ’。相关方以为数据已损坏。

此工具如何帮助

1. 加载文件 — FileReader 使用浏览器默认文本解码（通常为 UTF-8）。
2. 若出现乱码，文件很可能是被误标为 UTF-8 的 Windows-1252/Latin-1（或相反）。
3. 从 Excel/Sheets 重新导出为 CSV UTF-8，或用正确的编码工具转换。
4. 重新加载并确认变音符号与货币符号显示正确。

结果：在预览时发现问题，而不是在流水线失败之后。

整个文件以字符串保存并解析为完整的内存表。上限是浏览器标签页内存，而不是流式引擎。

• 数百 MB 的 CSV 可能冻结或崩溃标签页 — 先拆分或预览头部样本
• 排序会复制行数组；又宽又高的表会放大内存占用
• 没有面向百万行的虚拟无限滚动 — 请用数据库或 CLI（csvkit、DuckDB）
• 抽查时从源系统导出前 1–5k 行到此查看器

症状：部分行单元格更少、值出现在错误表头下，或含逗号的字段被拆成额外列。

发生原因

字段内未加引号的逗号、不匹配的引号，或导出中途截断的行会破坏列对齐。将分号分隔文件按逗号解析会塌成单列。

诊断

找到第一行坏数据。检查地址/姓名字段是否含未加引号的逗号。确认文件使用逗号而非分号。

修复

1. 用正确引号重新导出（Excel：CSV UTF-8；数据库：FORCE QUOTE）。
2. 打开前将分号/TSV 转为逗号分隔。
3. 修复问题行中不平衡的引号。
4. 重新加载并验证样本行的列数与表头长度一致。

症状：重音、符号或 CJK 文本渲染为拉丁乱码（Ã、Â、â€）。

发生原因

字节用了错误的字符集解码。此查看器通过浏览器将文件读为文本（现代 CSV 期望 UTF-8）。

诊断

在能显示编码的编辑器中打开同一文件。若在 Windows-1252 下正确而此处错误，请转换为 UTF-8。

修复

1. 从电子表格或 BI 工具另存为 CSV UTF-8。
2. 用 iconv 或专用编码转换器转换后重新加载。
3. 确保生产者在流水线中声明 UTF-8（尤其是遗留 ERP 导出）。

在源头修复编码 — 排序与 JSON 交接只会传播损坏。

CSV 导出常包含 PII、薪资或客户名单。

• 优先本地预览，而非未知「在线 CSV」网站
• 分享网格截图前剥离或哈希邮箱/ID
• 不要将生产 CSV 提交到公共仓库
• 稍后粘贴到电子表格时注意公式注入（=, +, -）