文档系统迁移最常见的事故，不是文件丢了，而是「文件还在，但用不了了」。
比如：打开是三年前的版式，打印出来页码错位；原来的共享链接全部失效；历史权限没带过来，一个部门突然能看另一个部门的资料。用户不会说「迁移有问题」，只会说「新系统不好用」。
所以迁移要按「保什么」来设计，而不是按「拷多少」来排期。
一｜迁移不是拷贝，是四件事同时成立
一次可用的迁移，至少要同时满足四条：
- 格式能打开：常见文档、表格、演示、PDF 都能正常预览和编辑；
- 版式能还原：字体、页边距、页眉页脚、红头、签章位置不发生明显偏移；
- 权限能对应：原来的组织、角色、共享关系，能在新系统里找到对应物；
- 引用能延续：文档之间的链接、被引用关系、收藏和最近访问，不至于全部断掉。
只做到第一条，叫「搬过去了」；四条都做到，才叫「迁移完成」。
二｜五步迁移法：每一步都有交付物
| 阶段 | 主要动作 | 交付物 |
|---|---|---|
| 盘点 | 统计文件数量、格式、大小、历史年限、活跃度 | 文件清单与优先级分组 |
| 映射 | 梳理组织、角色、共享关系与权限来源 | 权限映射表 |
| 试迁 | 选一个部门或一类文件做小范围迁移 | 试迁报告与问题清单 |
| 对账 | 抽样比对打开、搜索、统计、打印、权限 | 差异清单与处理结论 |
| 切换 | 正式迁移、并行期、回滚预案 | 切换方案与回滚演练记录 |
其中「映射」和「对账」最容易被压缩，也最容易在切换后集中爆发。
三｜三类必须人工确认的内容
工具能处理大部分标准文件，但下面三类建议逐项人工确认：
- 复杂版式文件：红头文件、合同、报表、带签章或特殊字体的文档。抽样打印，和原件逐页比对。
- 历史权限关系：尤其是「部门共享」「外部协作」「临时授权」这三类。工具通常只能迁移显式权限，隐含关系需要业务确认。
- 外链与引用：文档里指向旧系统的链接、图片、附件，迁移后可能全部失效。需要统计影响面，决定是批量替换还是保留跳转。
四｜对账表：用数据代替「感觉差不多」
| 指标 | 怎么抽 | 通过标准（示例） |
|---|---|---|
| 打开成功率 | 按格式分层抽样，每类不少于 50 份 | 约定比例以上可正常打开，失败项有明确原因 |
| 版式一致性 | 复杂版式文件逐页比对打印样张 | 关键元素不偏移，字体不缺，页码正确 |
| 权限正确性 | 按角色抽用户，验证可见与不可见 | 越权访问为 0，误拦截可解释 |
| 搜索一致性 | 用固定关键词比对命中数量与排序 | 核心关键词结果一致，差异有说明 |
| 链接有效性 | 抽取文档内外部链接做可用性检查 | 失效链接有替换或跳转方案 |
对账结果要能签字。没有签字标准的迁移，最后都会变成「再观察一段时间」。
五｜并行期与回滚：给迁移留后路
建议设置一段并行期：旧系统只读、新系统可写，至少覆盖一个完整的业务周期。并行期的价值不是「双保险」，而是给用户一个适应窗口，也给项目组发现问题的机会。
回滚预案要提前演练，至少回答三个问题：回滚需要多久、回滚期间的新数据怎么处理、回滚后旧系统的权限是否还完整。
六｜结语：迁移的终点是「愿意用」
迁移项目最容易犯的错，是把「文件搬完」当成终点。真正的终点是用户愿意在新系统里继续工作：能找到文件、能打开、能分享、权限不出错。