一个基于 SvelteKit + TypeScript 的 Excel 转 JSON 可视化工具。
支持上传 Excel/CSV、列级映射配置、实时 JSON 预览、模板导入导出与一键复制/下载。

• 支持文件格式：.xlsx、.xls、.csv
• 左侧表格预览 Excel 数据，右侧实时预览转换后的 JSON
• 每列可配置：
  • 目标字段名（target）
  • 数据类型（string / number / boolean / date）
  • 日期格式（如 YYYY-MM-DD、YYYY-MM-DD HH:mm:ss、timestamp）
  • 空值策略（空值时移除字段 / 使用默认值）
  • 是否启用该列输出
• 支持嵌套字段：user.address.city 会生成嵌套对象，而不是带点字符串键名
• 支持映射模板导入/导出（JSON）
• 支持导出 JSON 文件与复制 JSON 到剪贴板
• 包含单元测试（vitest）

• Svelte 5 + SvelteKit 2
• TypeScript
• Tailwind CSS 4
• xlsx（SheetJS）
• dayjs
• Vitest

npm install

npm run dev

默认地址通常为：http://localhost:5173

npm run build
npm run preview

1. 上传或拖拽 Excel/CSV 文件
2. 在左侧点击列头“设置”调整映射规则
3. 右侧实时查看 JSON 结果
4. 可导出当前映射为模板，供后续复用
5. 使用“下载 JSON”或“复制 JSON”输出结果

模板是一个 JSON 数组，每一项对应一列配置。示例：

[
  {
    "source": "姓名",
    "target": "user.name",
    "type": "string",
    "excludeIfEmpty": false,
    "defaultValue": ""
  },
  {
    "source": "入职日期",
    "target": "user.joinDate",
    "type": "date",
    "format": "YYYY-MM-DD",
    "excludeIfEmpty": true
  }
]

• npm run dev：启动开发服务器
• npm run build：生产构建
• npm run preview：预览构建产物
• npm run check：类型与 Svelte 检查
• npm run test：运行测试（单次）
• npm run test:unit：运行 Vitest（交互模式）

• src/routes/+page.svelte：主页面与整体交互
• src/lib/excel.ts：Excel/CSV 读取与解析
• src/lib/converter.ts：映射转换核心逻辑
• src/lib/types.ts：类型定义（MappingConfig、RowData 等）
• src/lib/components/ExcelTable.svelte：左侧数据表格
• src/lib/components/ColumnConfig.svelte：列映射配置面板
• src/lib/components/JsonPreview.svelte：右侧 JSON 预览

• 日期字段会尽量兼容 Excel 序列日期（数字日期）
• 当 excludeIfEmpty = true 时，空值字段不会出现在输出 JSON 中
• 若目标字段包含 .，会按路径写入嵌套对象