CSV 透镜 · 本地数据预览

一个不依赖云服务的浏览器 CSV 检查工具。粘贴或读取本地 CSV 后，可以看到字段数、记录数、每列空值与不重复值数量，并预览前 100 行。代码原创；没有复用复现包中已发布的 JSON 工具源码。

运行

需要 Node.js 18+。无需安装依赖：

npm test
npm run dev

打开 http://127.0.0.1:4179/ 。示例按钮可直接体验；浏览器中的文件读取与分析不向服务端上传数据。服务端只提供静态页面和脚本，不接收文件。

CSV 约定与限制

• UTF-8，逗号分隔；首行必须为非空列名。
• 支持 UTF-8 BOM、CRLF/LF、双引号包裹的逗号或换行、"" 转义引号。
• 单个输入不超过 1 MiB，最多 5,000 条记录；每条记录的列数必须与表头一致。
• “空值”指去除首尾空白后为空；“不重复值”按原始文本精确比较，不自动做大小写、数字或空白归一化。
• 预览最多 100 行，但统计覆盖全部已解析记录。导入文件只在浏览器内读取，不会自动持久化；请勿将此工具当作敏感数据安全审计器。

验证

npm test 覆盖基础表格、BOM、引号与换行、空值统计及错误输入。手工可用示例按钮观察三项总览、字段卡片与预览表格，再输入列数不一致的内容验证错误提示。