家谱迁入新软件后，熟悉的姓氏一个不少，某些要紧的东西却仍会在迁移中遗失：当初凭什么认定这段亲属关系。迁入免费开源的家谱软件 Gramps，正好可以借此检查关系与依据之间的联系。一项判断能否继续追溯到证据，是值得追问的问题。[1]
本文讨论迁入 Gramps Desktop 的过程，以 6.0.8 版本的代码为具体参照。我建议先在一份独立的家谱中演练迁移，检查几条复杂记录，再恢复一次原生备份，之后才将导入的副本作为日常研究所用的家谱。
先挑复杂的家庭记录
导出之前，先保留旧软件自身生成的备份，收集相关文献和照片。然后选一小组自己熟悉的记录：一次再婚、一名被收养的孩子、一个带重音符号的姓氏、一个约略的出生日期，以及一项依据彼此冲突的文献作出的判断。把迁移后预期看到的内容写下来。
这些是本文建议的测试案例，不代表 Gramps 的检查清单。有了这些样本，迁移是否成功就有了具体的检验依据。单看人数，无法判断收养关系的含义是否变了，日期是否被写得过于精确而产生误导，或解释性备注是否与对应记录脱离。
Vladimir Perić 在 2014 年独立撰写的 Gramps 使用文章，为这项检查提出了一个有用的标准。他在描述自己的研究流程时强调，引用记录中应写下足够的细节，以便日后再次找到原始条目。这篇文章记录的是当年的实践，用它指导今天的界面操作有时间上的局限；但迁移之后能否找回原始资料，依然是一项严格的检验。[2]
从样本里选一项判断，一直追溯到原始依据。如果找不回文献，也无法理解自己当时的推理，即使人数与旧家谱一致，迁移也只完成了一部分。
沿着引用记录检查迁移
Gramps 为这些联系安排了明确的位置。它的共享数据模型区分了来源（Source）与引用记录（Citation）：前者可以是一本教区登记簿，后者则指向登记簿中的某一条具体记录。事件、人物、备注、馆藏机构和媒体各自作为独立对象保存，彼此可以关联。一个事件也可以由多个人物共同关联，例如人口普查中登记的一户人家。[3]
以一次假设的迁移为例：某人的出生日期有登记簿条目为据，后来的普查记录却给出了不同的信息。导入后，应检查这两条引用记录。它们是否仍然指向相关页码或条目？能否看出各个日期分别来自哪份文献？当初对这处分歧所作的说明是否还找得到？
在这里，Gramps 的灵活性有了实际用途：即使涉及同一个人，各份证据仍能保持各自的区别。迁移时要核实的是，原先已作出的区分在转入这套数据模型后是否保留下来。即使界面整齐清楚，尚未解决的疑问也应继续保留。
读一读导入器未能理解的内容
GEDCOM 是家谱软件之间常用的交换格式，但导出和导入仍要转换各个软件表达资料的方式。Gramps 自身的常见问题解答提醒，GEDCOM 无法保留其数据库中的全部信息，备份应使用其他格式。[1]
为这次演练新建一份空白家谱。导入导出的 GEDCOM 文件，原始导出文件保持原样；在编辑导入的记录之前，先检查导入报告。
6.0.8 版本的解析器代码说明了这一步的具体作用。它会区分无法识别的行与能够识别但尚不支持的标签，记录诊断消息，并可将这些消息保存为类型是 GEDCOM import 的备注，在条件允许时附到相应对象上。[4]
这些备注值得逐条阅读。以诊断文本形式保留下来的内容，是否已经转成旧软件所表达的事件、引用记录或亲属关系，仍需核实。对于警告涉及的内容，也要看自己的研究是否需要。将受影响的记录与原始记录对照，才能分清这些情形。警告的严重程度要逐条判断；即使导入过程没有提示，资料是否完整、准确地保留下来也仍要检查。
如果第一次尝试后需要更换导出设置，就在另一份空白家谱中重新演练。这样便于看清两次结果的差异，也能避免将试验数据与已经开始修补的研究资料混在一起。
让照片一同迁移
上方的家庭合影，让这个问题有了具体可见的形象。Kristi Finefield 在美国国会图书馆的文章中，请读者一并细看家庭照片与照片说明。这张照片的说明将 W. E. B. Du Bois 列为收集者，拍摄时间标为 1899 年或 1900 年。留存下来的描述带有不确定性，保留这一点，比自行认定某一个年份更忠实于资料。[7]
处理自己的照片时，应分别检查照片说明和文件。Gramps 的媒体基础路径（Base media path）针对当前家谱设置，每份家谱各有自己的设置，所有家谱并未共用一个全局位置。[5] 一个实用的安排是设立专用媒体文件夹，再按肖像、证书和其他记录分设子文件夹，内部使用相对路径。
例如，记录中引用 portraits/family.jpg，对应文件就要随媒体文件夹一起迁移，目标软件也要知道该文件夹位于何处，这条引用才有用。迁移这些文件后，应打开完整图片。记录里显示着文件名，还不足以证明照片确实在场。
还应检查一份为争议判断提供依据的扫描件：条目是否读得清，是否能从对应的引用记录打开，说明是否看得懂？这样，文件传输的检查就与当初促使你保存它的研究问题连在了一起。
停用原件之前，先恢复一次备份
导入的家谱通过检查后，制作一份 Gramps 原生备份。项目建议使用 .gramps XML 保存数据，避免依赖 GEDCOM 的导出再导入来备份。[1] 如果要在桌面端迁移时一并带走媒体文件，.gpkg 包会将家谱的 XML 与相关文件打包在一起。[6]
6.0.8 版本的打包程序有一项影响实际结果的限制：它只会加入确实存在且能够读取的媒体文件，随后将 XML 数据写入归档包。[6] 因此，打包操作无法补回此前已经丢失的照片。检查媒体文件应安排在备份之前，也应在备份恢复之后再做一次。
将这个包恢复到另一份新建的家谱中，再次打开先前那些复杂的样本。试着生成平时分享给亲属的报告。旧软件的备份和导出文件应继续保留，直到你能解释清楚所有影响研究的重要差异。
对于一名研究者，或由一人维护主家谱的小型家庭小组，这样的演练在操作上容易安排。如果一个小组同时编辑多个副本，还要约定由谁汇总修改；单靠反复传输文件，这项分工仍然悬而未决。
当另一个人也能从人物记录出发，沿着引用记录找到清晰可读的文献，并且仍能看到你保留的疑问时，迁移才有了令人满意的结果。研究成果随着姓名一同迁了过来。
来源
- Gramps 项目，常见问题解答，6.0.8 版本——软件用途、GEDCOM 互操作性及原生 XML 备份建议。
- Vladimir Perić，《Genealogy research with Gramps》，LWN.net，2014 年 7 月 16 日——独立评介及查找原始资料工作流程的亲身实践；本文参考其研究方法，当前界面的细节另需查证。
- Gramps Web 文档，《How Gramps organizes data》——与 Gramps Desktop 共享的数据模型，涵盖事件、来源、引用记录和媒体；查阅日期为 2026 年 10 月 22 日。
- Gramps 项目，GEDCOM 解析器，6.0.8 版本——对不支持的行的处理，以及 GEDCOM 导入备注的创建，尤其是 ignore 和消息处理方法。
- Gramps 项目，偏好设置界面，6.0.8 版本——家谱媒体路径设置及其逐份家谱生效的范围。
- Gramps 项目，打包导出器，6.0.8 版本——PackageWriter.export、可读取媒体文件的纳入，以及包内的 data.gramps XML 文件。
- Kristi Finefield，《Profiling Portraits: Family Groups in Pictures》，美国国会图书馆，2019 年 1 月 11 日——照片背景，以及 W. E. B. Du Bois 收集的家庭合影，数字标识符为 ppmsca.08762。