MICROSOFT 365 · 迁移前准备

文件迁移预检

迁移前,先发现命名问题。检查 SharePoint 或 OneDrive 目标路径,审核建议名称,带着清晰的计划开始迁移。

浏览器本地处理完整报告,免费导出了解检查规则
01

添加文件清单

选择文件夹,或使用相对路径清单。

选择文件夹时,浏览器可能显示“上传”,但文件不会上传。选择器无法列出空文件夹;请在文本清单中添加以斜杠结尾的路径。

保留文件夹层级。每行一个路径,或使用带 path 表头的 CSV;可选 type 列填 file 或 folder。每条相对路径前都会加上右侧目标文件夹。

默认关闭。仅在清单已进行网址编码时开启,例如 Report%20final.pdf。关闭时,百分号按原样保留。

02

设置迁移目标

检查完整目标路径,而不只是文件名。

输入已解码的服务器相对路径,或直接指向文件夹的 https 网址。不接受分享链接、查询参数或片段。网址路径解码一次;普通路径按原样保留。

仅用于检查文档库根目录中的保留名称 Forms。如果目标位于子文件夹内,请取消勾选。

可选:本地同步检查

同一份相对路径清单将追加在此目录后。留空则跳过本地完整路径检查。

先了解路径长度预算

400云端路径单位
255每段同步名称单位
520本地同步路径单位

云端长度以解码后的 UTF-16 单位计数,对增补字符采用保守计数。详细规则见下方说明。

准备就绪。添加文件清单,然后开始预检。

让迁移更有把握

少些反复尝试,多些提前了解。

文件迁移预检是面向 Microsoft 365 中 SharePoint Online 和 OneDrive 的浏览器端文件名与路径检查工具。上传或同步之前,先整理并检查迁移清单。

01 / 检查名称

发现不支持的字符、保留名称和命名风险。名称包含 # 或 % 时会提示租户支持警告,因为是否支持取决于组织设置。

02 / 看清完整路径

填入实际目标目录,发现迁移后才会出现的路径过长问题。还可以添加本地目录,分别检查同步路径和操作系统兼容性。

03 / 审核修改计划

编辑文件或文件夹的建议名称,查看子项如何更新。导出前,检查重复目标,以及大小写或 Unicode 规范化造成的名称冲突。

这些数字如何计算

  • 云端路径:目标目录与相对清单路径组合后,最多为 400 个已解码的 UTF-16 单位。不计协议、域名和首尾斜杠;目录之间的分隔符计入长度。结果中显示的目标路径就是被计数的字符串。
  • 本地同步:每段名称最多 255 个 UTF-16 单位,完整本地路径最多 520 个单位。填写本地目录并选择同步环境后,Windows 路径达到 260 个单位,或 macOS 路径达到 1,024 个 UTF-8 字节时,会提示兼容性警告。具体应用可能有更严格的限制。
  • 选择文件夹时会包含该文件夹本身的名称。例如,选择“项目”文件夹,其内容的路径会带有“项目/”前缀。若不希望包含这一层,请改用相对路径文本清单。

安全上限:250,000 条输入;含推断文件夹在内共 500,000 项;32 MiB 清单文本;展开后的原始路径累计 1,600 万个 UTF-16 单位;计划路径累计 3,200 万个单位。单条路径或名称最多 16,384 个单位,路径最多 256 层。超出上限会停止检查并报错,不会截断报告。大型清单请分批处理。

使用说明

开始前,你可能想了解

文件会被上传或更改吗?

不会。选择文件夹只会向此页面提供相对文件名,不会读取这些文件的内容。导入 TXT 或 CSV 时,只读取所选清单的内容。所有检查均在浏览器中进行,建议名称只修改计划,不会生成重命名脚本。

如何包含空文件夹?

文件夹选择器通常只提供文件,因此无法列出空目录。请在文本清单中添加以斜杠结尾的空文件夹路径,或在 CSV 中将该行的 type 设为 folder。保留父目录路径,以明确文件夹层级。

目标网址与目标路径有什么区别?

直接指向文件夹的 https 网址只使用其中的路径,并解码一次。普通服务器相对路径视为已经解码,其中的百分号按原样保留。不接受分享链接、查询参数或片段。单独的“清单解码”选项仅影响导入或粘贴的清单路径。

名称建议能修复所有问题吗?

不能。名称建议是可编辑的起点。文件夹改名会更新其子项的目标路径,并重新执行检查,但工具不会自动处理冲突,也不能保证所有路径都符合长度要求。请在自行重命名之前审核完整报告。

完整报告真的免费吗?

是的。CSV 和 JSON 导出包含完整报告,包括当前分页之外或被显示筛选隐藏的项目。表格分页只是为了便于浏览,导出不会截断。大型清单仍受浏览器可用内存的限制。

规则与参考资料

规则版本:2026-10-16

本工具为独立的迁移准备工具,与 Microsoft 无关联。迁移前请核实最新官方指南与租户设置。