Appearance
iCost账单导入指南
📋 概述
本指南将指导您如何从 iCost 导出账单，并导入到 考拉记账 App 中。
考拉记账当前支持导入 iCost 导出的 Excel 文件（.xlsx / .xls），并且 不支持 iCost 的 CSV 文件。
📱 第一步：在 iCost 中导出账单
不同版本的 iCost，入口可能略有差异，但思路一致：进入“导出/数据导出”，选择导出格式为 Excel 后保存文件。
步骤 1：进入导出入口
- 打开 iCost
- 进入 设置 / 更多（或“我的”页中的设置入口）
- 找到 导出 / 数据导出 / 导出账单（名称可能略有不同）
步骤 2：选择导出格式
- 选择导出格式：Excel（.xlsx / .xls）
- 选择导出时间范围（建议每次不超过 3 个月）
- 导出并保存到本地（或通过“分享/保存到文件”）
⚠️ 重要：导出为 CSV 会在考拉记账中提示“不支持 CSV，请使用 Excel”。
📱 第二步：在考拉记账中导入
步骤 1：进入导入页面
- 打开考拉记账 App
- 点击底部导航栏的 “设置”
- 在设置页面中找到 “账单导入”
- 点击进入账单导入页面
步骤 2：选择导入来源
- 点击 “导入来源”
- 在列表中选择 “iCost”
⚠️ 重要：必须选择“iCost”，否则系统会按其他来源解析，导致找不到表头或字段错位。
步骤 3：选择文件
- 点击 “文件路径”
- 选择 iCost 导出的 Excel 文件（
.xlsx/.xls） - 确认文件名已显示
步骤 4：关联账本
- 点击 “关联账本”
- 选择要导入的目标账本
- 确认账本选择
步骤 5：解析并预览
- 点击右上角 “解析”
- 解析成功后进入预览页
- 在预览页可以编辑单条记录的分类、账户、时间、金额、标签、备注等，再执行导入
步骤 6：导入
- 预览确认无误后点击 “导入”
- 等待导入完成
📋 iCost账单文件格式说明（Excel）
考拉记账对 iCost Excel 的校验点：
- Excel 需要存在可读取的工作表
- 表头行需要包含 “日期” 字样（用于定位表头行）
📝 提示：如果 iCost 导出支持选择语言，建议导出为中文表头（至少保证表头行包含“日期”）。
读取字段（按列位置）
考拉记账按列位置读取 iCost Excel 的部分字段，其它列会被忽略：
| 列序号 | 字段 | 说明 |
|---|---|---|
| 1 | 日期 | 支持 yyyy-MM-dd / yyyy/MM/dd / yyyy-MM-ddTHH:mm:ss / yyyy-MM-dd HH:mm:ss；也支持 Excel 序列号日期 |
| 2 | 类型 | 文本需包含“支出”或“收入”关键字；包含“支出”=支出，包含“收入”=收入 |
| 3 | 金额 | 允许带 +/-，导入会自动去除符号并去掉千分位逗号 |
| 4 | 父分类 | 用于匹配考拉记账收支项目父类名称 |
| 5 | 子分类 | 为空时会自动使用“父分类”的值 |
| 6 | 账户 | 为空时会使用默认账户（数据库 id=1）作为兜底 |
| 8 | 备注 | 备注文本 |
| 9 | 币种代码 | 例如 CNY / USD；为空或匹配失败时使用目标账本的默认币种 |
| 10 | 标签 | 多个标签用逗号分隔（同时支持中文逗号 ，） |
导入映射（考拉记账）
- 日期（row[0]）→ 账单日期
- 类型（row[1]，含“支出/收入”）→ 账单类型
- 金额（row[2]）→ 金额
- 一级分类（row[3]）→ 一级分类（并匹配/创建 parentCategoryId 等）
- 二级分类（row[4]，空则用一级）→ 二级分类 （并匹配/创建 childCategoryId 等）
- 账户（row[5]，空则默认账户）→账户名称
- 第7列（row[6]）→ 不入库（未使用）
- 备注（row[7]）→ 备注
- 货币代码（row[8]）→ 货币名称
- 标签（row[9]）→ 标签（解析/创建标签后入库）
⚠️ 注意事项
- 仅支持 Excel：iCost CSV 文件无法导入。
- 不自动去重：重复导入同一份文件会生成重复账单记录，请避免多次导入同一时间段。
- 表头语言：解析依赖表头行包含“日期”；若导出为非中文表头，可能导致找不到表头而解析失败。
- 账户为空的处理：若 iCost 导出中“账户”列为空，会使用默认账户（id=1）兜底；建议导出时尽量补全账户信息，或在预览页统一修改。
- 收支项目匹配：按“父分类 + 子分类”名称匹配；匹配失败会在预览页提示不完善，需要手动选择正确的收支项目后再导入。
🔧 常见问题
Q1：提示“未找到 iCost 账单表头”？
A： 通常是以下原因：
- Excel 中表头行不包含“日期”字样（例如导出为英文表头）
- 文件不是 iCost 导出的账单文件，或表结构被二次编辑破坏
- Excel 文件为空/没有工作表
建议重新从 iCost 导出，并优先选择中文表头的导出方式。
Q2：账户为空导致导入后都进了同一个账户？
A： 这是正常兜底行为：当“账户”列为空时，会使用默认账户（id=1）。可在预览页批量编辑账户，或在 iCost 导出前补全账户字段后再重新导入。
Q3：分类匹配不上怎么办？
A： 在导入预览页点进单条记录手动选择收支项目；或者先在考拉记账里创建好与 iCost 导出文件同名的收支项目后再重新解析。
📚 相关教程
最后更新：2026年4月