# 数据导出结果示例：藏书 CSV、阅读记录和笔记档案怎么看

来源：https://bookshelf.yuanzhetech.cn/docs/guides/data-export-examples
更新：2026-10-09

读书迹 App 可以导出书籍 CSV、阅读记录 CSV、笔记 Markdown 压缩包和生词 CSV，也可以把这些内容合成完整档案 ZIP。书籍表格是一行一本书，阅读记录是一行一次已结束的阅读，笔记按关联书籍分文件夹。下面用演示数据说明文件结构与字段含义，不展示真实用户信息。

手机从「数据导出」进入，电脑网页版从「设置 → 数据导入导出」进入。导出后保存文件，先检查内容再作为备份留存。

## 完整档案解压后是什么样

```text
books.csv
reading-sessions.csv
vocab.csv
notes/
  示例小说 A/
    book.json
    示例笔记ID-2026-09-18.md
  无关联书籍/
    示例笔记ID-2026-09-20.md
```

完整档案的三个 CSV 位于压缩包根目录，笔记位于 `notes/`。只有存在笔记的书才会在笔记目录中出现，不是每本藏书都生成一个文件夹。同名书可能在文件夹名后追加标识，文件名中的非法字符会被替换。

单独导出笔记时，ZIP 内最外层是 `notes-YYYY-MM-DD/`，下面仍按书籍分组；不要把这一层与完整档案里的 `notes/` 混淆。

## 书籍 CSV：一行一本书

书籍表格使用以下中文表头，按添加时间倒序输出：

```text
书名,作者,译者,出版社,ISBN,定价,册数,页数,字数,评分,阅读状态,阅读时长,阅读天数,阅读次数,购入价,购买时间,购买来源,存放位置,书架,分类,阅读日期,备注,简介,添加时间,更新时间
```

以下只截取部分列作阅读示例，不是完整导出行：

| 书名 | 定价 | 购入价 | 评分 | 阅读状态 | 阅读时长 | 阅读天数 | 阅读次数 | 存放位置 | 分类 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 示例小说 A | 49.80 | 32.00 | 4.5 | 已读 | 1 小时 20 分钟 | 2 | 1 | 书房 A 柜第 2 层 | 文学/小说 |

- **金额单位是元**：`49.80` 表示 49 元 8 角；未设置金额时可能输出 `0.00`。
- **阅读时长是汇总**：将这本书的阅读记录时长相加，再四舍五入为分钟，不是逐条流水。
- **阅读天数是不同阅读日期的数量**：同一天读多次不会增加多个阅读天数。
- **阅读次数是读毕次数**：计时开始次数不等于这列的次数。
- **阅读日期列列出读毕日期**：按日期倒序，以逗号分隔；含逗号的 CSV 单元格会用双引号包裹。
- **分类用 `/` 分隔**：表示多个分类，不表示层级。页数、字数等无有效数值时可能留空。

## 阅读记录 CSV：一行一次已结束的阅读

```csv
书名,作者,ISBN,开始时间,结束时间,时长（分钟）,阅读日期,读到页码,是否读毕,来源,备注
示例小说 A,示例作者甲,,2026-09-18 20:00,2026-09-18 20:35,35,2026-09-18,120,,计时,晚间阅读
```

开始时间和结束时间统一按北京时间（UTC+8）输出为 `YYYY-MM-DD HH:mm`。阅读日期是记录归属的自然日，不能仅凭开始时间重新推算，跨日或补录时尤其需要保留这一列。

只有已结束的记录进入导出，正在计时的记录不在其中。计时记录的分钟数会四舍五入，正时长不足一分钟时输出 1；手动标记的记录没有计时时长，时长列留空，不表示「读了 0 分钟」。读毕记录在「是否读毕」列写「是」，其他记录留空。

## 笔记 Markdown 和 book.json

每条未删除笔记写成一个 `.md` 文件，内容保留笔记正文，不额外增加标题或日期前言。文件名包含笔记标识和创建日期，没有关联书籍的笔记放在「无关联书籍」目录。

有书籍关联的目录还带 `book.json`，保存该书的标识、书名、作者、封面链接、ISBN、评分和部分书目、购买信息。需要注意：**其中 `price` 和 `purchasePrice` 是内部金额的分值**，例如 `4980` 表示 49.80 元，与书籍 CSV 的元单位不同。

封面记录的是 URL，不代表压缩包下载并保存了封面图片；笔记正文中的远程图片链接也不代表已打包对应图片文件。检查长期备份时，应分别确认这些链接中的资源是否需要另行保存。

## 生词 CSV

默认中文表头为「类型、字/词、读音、释义、收藏时间」。字和词本身来自生词本，读音与释义在导出时查询补充；未查到时相应列可能为空，原来的字或词仍保留。不同界面语言下，生词表头和类型文案可能不同。

## 这些文件能否完整恢复账号

书籍 CSV 可以作为表格导入来源，但完整档案 ZIP 不是一键恢复包。阅读记录 CSV、笔记目录和生词 CSV 不会通过书籍表格导入自动恢复。

重新导入书籍时需要选择目标书架；书架列不会自动还原各行原书架，私人标签也不会由表格自动重建。书籍 CSV 中的累计阅读时长、读毕日期可以按导入规则处理，但逐次阅读明细不能由汇总表完整恢复。具体字段规则见[Excel 导入字段示例](https://bookshelf.yuanzhetech.cn/docs/guides/excel-import-fields)。

## 保存前核对

1. 确认压缩包能解压、CSV 能正常显示中文。
2. 随机检查书名、ISBN、金额和阅读记录时间。
3. 检查有无关联书籍的笔记目录，以及其中的 Markdown 正文。
4. 按导出日期分别保留档案，不覆盖唯一的旧备份。

CSV 使用 UTF-8 BOM，含逗号、引号或换行的字段按 CSV 规则转义。用 Excel 打开时，ISBN 列仍建议按文本导入，避免软件自动转换数字。

## 继续了解

- [Excel 导入字段示例](https://bookshelf.yuanzhetech.cn/docs/guides/excel-import-fields)
- [手机与电脑分工示例](https://bookshelf.yuanzhetech.cn/docs/guides/mobile-desktop-workflow)