Tool overview
什么是CSV 查看器?
CSV 查看器是一款帮助您在可排序表格中预覽和瀏覽 CSV 文件的開發者工具。
為什么使用CSV 查看器?
在需要在可排序表格中预覽和瀏覽 CSV 文件時提升可讀性与效率,且不會将数據上传到服務器。
核心功能
客戶端私隱保护、即時結果与一鍵複製。在可排序表格中预覽和瀏覽 CSV 文件
使用方法
按照以下步骤使用上方工具并获得准确結果。
- Open a CSV file from disk—parsing stays on-device.
- Sort columns和scan row counts in the table header.
- Use for quick inspection before JSON/ETL transforms.
CSV Viewer Features
查看此工具的有效示例、常见无效輸入和频繁出现的錯誤。
CSV Viewer 指南 — 从这里開始
本页是使用 DevUtilities CSV Viewer 预覽 CSV 的权威指南。在上方開啟文件,然后查看分隔符/表头、排序、大文件限製、編碼以及交接至 JSON/CSV 等章节。解析留在瀏覽器本地。
CSV Viewer 的作用
CSV Viewer 是面向逗號分隔值的客戶端表格预覽。它将第一行解析為表头,渲染可排序網格,并将全文保存在内存中,以便在 ETL、JSON 轉換或工單附件之前检查導出。
你将获得
- 通过 FileReader(文字)的文件選擇 / 拖放加载
- RFC 4180 風格解析:逗號、引號字段、转义引號
- 第一行作為列標題
- 可点擊表头排序(localeCompare,升/降序)
- 表格界面中的行数与列数
- 仅本地处理 — 電子表格内容不會上传
在以下情况使用此查看器
- 无需開啟 Excel 即可快速查看導出
- 在 JSON/CSV 轉換前驗證表头与行形态
- 检查引號与逗號是否在導出中保留
- 对客户或薪资 CSV 必须保持离线
分步操作
此工具如何帮助
- 从磁盤開啟 .csv。
- 确认表头名称与生產者 schema 一致。
- 对照预期導出大小检查行数。
- 点擊列標題排序;再点反转。
- 扫描不规则行或看似合并的值。
- 若字元异常(é、’),在源头修複編碼并重新加载。
- 轉換時将 CSV 複製到 JSON ↔ CSV、Dev Toolkit Columns → JSON 或你的 ETL。
分隔符与表头检测
解析器以逗號分隔。第一个非空逻辑行成為表头;之后每一行都是按列索引对齐的数據行。
會检测什么
- 逗號 (,) 作為字段分隔符
- 可包含逗號与换行的雙引號字段
- 引號字段内以雙引號转义 ("")
- CRLF 与 LF 行终止符
不會自动检测什么
- 欧盟 Excel 導出常见的分號 (;) 或製表符 (\t) 分隔符
- 單独的「有表头」開關 — 第 0 行始终是表头
- 类型推断(数字/日期在網格中仍為字串)
实用提示
实用提示
排序与表格预覽
排序通过 localeCompare 对單元格字串做字典序。适合扫描类别和 ID,不适合数值大小顺序。
- 点擊表头升序;再点降序
- 数字列按文字排序(「10」在「2」前)
- 空單元格為空字串;不规则行可能使值视觉錯位
- 加载新文件時排序状态重置
- 用 行 × 列 元信息行核对導出完整性
用例:质检電子表格導出
供应商發來 overnight.csv。在加载到数仓作業前,你需要确认表头、行数,以及带引號的逗號冇拆分字段。
此工具如何帮助
- 開啟文件,对照合同 schema 朗讀表头行。
- 将顯示行数与供应商清單比较。
- 对關鍵列(order_id、email)排序,目视空白或重複。
- 開啟可疑行的單元格 — 带引號的地址字段应留在一列。
- 若形态錯誤,在 ETL 前拒绝或重新索取文件。
結果:在预覽時發现問題,而不是在流水线失败之后。
用例:交接给 JSON 工具
你需要用于 API mock 或 LLM 工具 schema 的物件,但真相來源仍是 CSV 導出。
此工具如何帮助
- 在 CSV Viewer 中预覽,确认表头干净(无空白名、无重複標題)。
- 将 CSV 文字複製到 Dev Toolkit → Columns → JSON 得到物件陣列,或用 JSON ↔ CSV 做往返。
- 在接线 mock 前用 JSON Formatter 驗證样本物件。
- 保留 CSV 作為审计產物;只提交已清理的样本。
結果:在预覽時發现問題,而不是在流水线失败之后。
用例:發现編碼問題
姓名顯示為 José,或弯引號顯示為 ’。相關方以為数據已损坏。
此工具如何帮助
- 加载文件 — FileReader 使用瀏覽器默认文字解碼(通常為 UTF-8)。
- 若出现乱碼,文件很可能是被誤標為 UTF-8 的 Windows-1252/Latin-1(或相反)。
- 从 Excel/Sheets 重新導出為 CSV UTF-8,或用正确的編碼工具轉換。
- 重新加载并确认变音符號与货币符號顯示正确。
結果:在预覽時發现問題,而不是在流水线失败之后。
大文件注意事项
整个文件以字串保存并解析為完整的内存表。上限是瀏覽器標籤页内存,而不是流式引擎。
- 数百 MB 的 CSV 可能冻结或崩溃標籤页 — 先拆分或预覽头部样本
- 排序會複製行陣列;又宽又高的表會放大内存占用
- 冇面向百万行的虚拟无限滚动 — 请用数據庫或 CLI(csvkit、DuckDB)
- 抽查時从源系统導出前 1–5k 行到此查看器
修複:不规则行或錯位列
症状:部分行單元格更少、值出现在錯誤表头下,或含逗號的字段被拆成额外列。
發生原因
字段内未加引號的逗號、不匹配的引號,或導出中途截断的行會破坏列对齐。将分號分隔文件按逗號解析會塌成單列。
诊断
找到第一行坏数據。检查地址/姓名字段是否含未加引號的逗號。确认文件使用逗號而非分號。
修複
- 用正确引號重新導出(Excel:CSV UTF-8;数據庫:FORCE QUOTE)。
- 開啟前将分號/TSV 转為逗號分隔。
- 修複問題行中不平衡的引號。
- 重新加载并驗證样本行的列数与表头長度一致。
修複:乱碼与編碼
症状:重音、符號或 CJK 文字渲染為拉丁乱碼(Ã、Â、â€)。
發生原因
字节用了錯誤的字元集解碼。此查看器通过瀏覽器将文件讀為文字(现代 CSV 期望 UTF-8)。
诊断
在能顯示編碼的編輯器中開啟同一文件。若在 Windows-1252 下正确而此处錯誤,请轉換為 UTF-8。
修複
- 从電子表格或 BI 工具另存為 CSV UTF-8。
- 用 iconv 或专用編碼轉換器轉換后重新加载。
- 确保生產者在流水线中声明 UTF-8(尤其是遗留 ERP 導出)。
在源头修複編碼 — 排序与 JSON 交接只會传播损坏。
安全清單
CSV 導出常包含 PII、薪资或客户名單。
- 优先本地预覽,而非未知「在线 CSV」網站
- 分享網格截图前剥离或雜湊邮箱/ID
- 不要将生產 CSV 提交到公共仓庫
- 稍后粘贴到電子表格時注意公式注入(=, +, -)
常见問題
關于常见调试問題和数據私隱的可展開解答。
官方文件与参考
本工具的权威规范与平台文件。