导入账单帮助

这篇文档会说明导入支持什么格式、文件该怎么整理，以及导入失败时怎么处理。

支持的文件格式

目前支持：

• .csv
• .xlsx

选择文件后，系统会自动识别表头并解析。若是 .xlsx，会先转换为表格数据再解析。

导入流程

1. 进入「导入账单」
2. 选择导入文件
3. 选择目标账本
4. 点击「导入」进入账单预览
5. 在预览页可删除不想导入的记录
6. 点击底部「导入」完成入库

说明：

• 账单会导入到你选中的目标账本
• 导入前建议先确认目标账本是否正确

推荐使用“下载模板”

导入页底部提供“下载模板”。

建议优先使用模板整理数据，可显著降低解析失败率。

表头字段规则

必填字段（缺一不可）

• datetime（时间）
• amount（金额）
• category（分类）

可选字段

• type（类型：收入/支出/转账）
• title（标题）
• remark（备注）
• discount（优惠）
• sub_category（二级分类）
• flag（标记，如“不计入预算”）
• asset_account（账户）
• to_asset_account（转入账户，转账场景）

如果文件里包含可选字段，系统会尽量识别并导入；识别不到的字段会被忽略。

时间与金额格式支持

时间格式（示例）

• 2026-04-18
• 2026/4/18
• 2026-04-18 08:30
• 2026-04-18 08:30:45
• 2026年4月18日
• 20260418

提示：带秒（HH:mm:ss）的时间精度更高，有助于重复账单识别。

金额格式（示例）

• 23.50
• -23.50（通常识别为支出）
• +23.50（通常识别为收入）
• ¥23.50
• 1,234.56

系统会自动清洗货币符号和分隔符。

类型识别规则

• type 存在且可识别：优先按 type 判定（收入/支出/转账）
• type 缺失时：会尝试按金额正负号推断
• 若无法推断类型，记录会被跳过

转账导入注意事项

转账账单支持导入，但有约束：

• 需要可用的转出账户和转入账户
• 转出与转入账户不能相同
• 账户不存在时，系统会尝试按账户名称自动创建
• 无法满足条件的转账记录会被跳过

分类与账户匹配规则

分类

• 非转账账单：按分类名称匹配
• 如果本地不存在对应分类，系统会自动创建分类
• 若有 sub_category，预览时优先使用二级分类名

账户

• 按账户名称匹配
• 不存在的账户会自动创建（默认作为普通账户）

重复账单去重规则

导入时会自动跳过重复账单（仅对“时间精度到秒”的记录生效），并给出“已跳过重复条数”提示。

去重会综合对比时间、类型、金额、分类、账户、备注等关键字段。

预览页能做什么

• 查看导入结果汇总（总笔数、收入、支出）
• 按天查看账单明细
• 左滑删除单条记录后再导入

建议：先清理明显异常记录，再执行最终导入。

常见问题（FAQ）

1）提示“文件解析失败”

常见原因：

• 表头缺少必填字段（datetime/amount/category）
• 文件编码异常或内容损坏
• 时间/金额列格式不可识别
• 文件内有效账单行为 0

建议先用“下载模板”对照修正后再试。

2）提示“没有可导入的账单”

表示文件可读取，但有效行都被过滤。

请重点检查：时间列、金额列、分类列是否为空，类型是否可识别。

3）为什么导入后笔数比文件少？

可能原因：

• 重复账单被自动跳过
• 无法识别的行被过滤
• 不满足转账条件的记录被跳过

4）为什么分类/账户和预期不一致？

导入按“名称匹配”处理。

如果同名但语义不同，建议先统一命名后再导入。

5）导入后可以撤销吗？

支持在“已导入管理”中删除对应导入记录进行回退（按客户端当前提供入口为准）。

6）为什么有些属性没有导入？

导入仅处理当前支持的字段。源文件里其他字段会被忽略，这是正常行为。