什么是文件路径长度限制？

应用对象

Windows 版 OneDrive

跨 Windows、macOS、OneDrive、SharePoint 和 Office 的文件路径长度限制

不同的平台和应用程序支持不同的最大路径长度，超过这些限制可能会阻止文件同步、打开、移动或重命名。

本文介绍什么是文件路径、跨平台的路径长度限制、可能遇到问题的位置、如何检查路径长度以及保持在限制范围内的提示。

什么是文件路径？

文件路径是计算机或云中文件的完整地址。它包括层次结构中的每个文件夹和文件名及其扩展名。路径中的每个字符都计入限制，包括 Windows 上的分隔符 (反斜杠、macOS) 上的正斜杠、空格和文件扩展名。

Windows (文件资源管理器) -- 工作或学校帐户
C:\Users\JaneDoe\OneDrive - Contoso\Projects\2026\Q1\Budget_Report_v3.xlsx

Windows (文件资源管理器) -- 个人帐户
C:\Users\JaneDoe\OneDrive\Projects\2026\Q1\Budget_Report_v3.xlsx

在下面的示例中，路径以驱动器号 (C:\) 开头，包括用户配置文件文件夹、OneDrive 同步文件夹、嵌套文件夹结构和文件名。请注意，工作或学校帐户路径包括组织名称 (例如 OneDrive - Contoso) ，其使用的字符比 OneDrive) (个人帐户文件夹更多。这种差异意味着拥有工作或学校帐户的用户可用于其文件和文件夹名称的字符较少。

macOS (Finder)
/Users/janedoe/Library/CloudStorage/OneDrive - Contoso/Projects/2026/Q1/Budget_Report_v3.xlsx

在 macOS 上，路径使用左斜线，通常从根目录开始。

OneDrive 网页版
Documents/Projects/2026/Q1/Budget_Report_v3.xlsx

在浏览器中，路径从 OneDrive 或 SharePoint 文档库的根目录开始。它不包括本地同步文件夹路径，这就是同一文件的云路径通常比本地路径短的原因。

平台之间的路径长度限制是什么？

下表汇总了每个平台的最大文件路径长度。在日常使用中遇到的最严格的限制是 Windows 文件资源管理器和 Office 桌面应用上的 260 个字符。

平台	最大路径长度	详细信息
Windows Office 桌面应用 (Word、PowerPoint、Excel)	256 个字符 (260 个 UTF16 WCHAR)	无法打开完整路径超过 260 个字符的文件，即使该文件存储在本地。 Office 应用使用强制 MAX`\`_PATH = 260 常量的旧版 Win32 API。
Windows 文件系统 (默认)	260 个字符	默认情况下，Windows 文件系统强制最大路径长度为 260 个字符。这是大多数 Windows 应用程序（包括文件资源管理器和 Office）遵循的限制。
Windows 文件资源管理器	260 个字符	适用于打开、重命名和移动文件。单个文件或文件夹的名称最多可为 255 个字符。即使启用了 Windows 长路径组策略设置，文件资源管理器也不会使用它。
OneDrive 和 SharePoint (云存储)	400 个字符	整个解码的文件路径（包括文件名）不能超过 400 个字符。
Office 网页版 (Word、Excel、PowerPoint Online)	400 个字符	可以在浏览器中创建、重命名和移动 Files 到此限制。
OneDrive 同步	520 个字符	总路径是本地路径 (最多 400 个字符) 和 OneDrive 根文件夹 (最多 120 个字符) 的组合。超过 520 个字符的路径显示同步错误。
macOS Office 桌面应用 (Word、PowerPoint & Excel)	1024 字节 (1024 UTF8 编码字节)	以 UTF-8 字节而不是字符表示的路径限制。 (重音符等多字节字符的Files，CJK) 可能比预期更早达到限制。
macOS 查找工具	1,024 个字符	单个文件或文件夹的名称上限为 255 个字符。在文件系统级别，包含多字节 Unicode 字符的路径可能超过 1,024 字节，即使字符计数看起来在限制范围内也是如此。
已启用长路径 (Windows 文件系统)	32,767 个字符	若要使用更长的路径，必须启用 LongPathAware 组策略设置。即便如此，每个应用程序也必须单独选择加入以支持扩展长度路径。文件资源管理器和 Office 桌面应用当前未选择加入，因此单独启用策略不会更改大多数用户的 260 个字符限制。
第三方应用	各不相同	第三方应用程序可能具有自己的路径长度限制，与操作系统无关。如果在非 Microsoft 软件中遇到与路径相关的错误，请咨询应用开发人员。

哪里会遇到路径长度问题

无法在桌面上打开的在线创建的 Files

在 OneDrive 网页版的深嵌套文件夹中创建 Office 文件。云路径在 400 个字符的限制内。当文件同步到电脑时，完整的本地路径会变长，因为 OneDrive 文件夹 (添加) 等 C:\Users\YourName\OneDrive - Your Organization Name\ 字符。如果总数超过 260 个字符，文件将不会在 Office 桌面应用中打开，也不会在文件资源管理器中重命名。

计算机上未显示的文件夹

在 OneDrive 网页版中创建一个名称超过 255 个字符的文件夹。该文件夹在浏览器中工作，但它不会同步到 Windows 文件资源管理器或 macOS 查找器，因为这两个平台都将单个文件和文件夹名称限制为 255 个字符。

OneDrive 同步暂停并显示“路径过长”通知

如果同步文件的完整路径超过 520 个字符，OneDrive 将显示“路径太长”通知，同步客户端将退出，直到解决超限项目。

SharePoint 快捷方式和已同步的库

为共享的 SharePoint 库或 Teams 频道文件夹添加 OneDrive 的快捷方式时，快捷方式内容将同步到 OneDrive 文件夹下的设备。如果共享库具有深嵌套或长文件夹名称，则本地路径可能很快超过 260 个字符 - 即使浏览器中一切正常。

Files from migrations

从其他云存储服务迁移文件时，组合的文件夹结构可能会意外超过路径限制，尤其是在原始结构具有较深嵌套的情况下。

“无法完成操作”错误对话框

如果看到错误对话框，显示“无法完成操作，因为文件夹或其中的文件在其他程序中打开”，有时可能表明文件路径太长。尽管消息引用了另一个程序，但根本原因通常是路径超过了平台的最大长度。请尝试缩短文件或文件夹名称，或将文件移至更靠近驱动器根目录的位置。

Office 临时文件即使在 260 个字符以下也会失败

Office 桌面应用创建临时锁定文件 (例如， ~$Budget_Report_v3.xlsx 通过将字符附加到原始文件路径来) 。如果文件路径接近 260 个字符，这些派生路径可能会超出限制，从而导致在保存或打开时出错。

如何检查文件路径长度

在 Windows 上

打开文件资源管理器并导航到该文件。
选择地址栏以显示完整路径。
复制路径，将其粘贴到文本编辑器中，然后检查字符数。

提示

还可以右键单击该文件，选择“属性”，然后查看“位置”字段。将文件名长度添加到总和的文件夹路径长度中。

还可以使用 PowerShell 检查特定文件的路径长度：
("C:\Users\JaneDoe\OneDrive - Contoso\Projects\2026\Q1\Budget_Report_v3.xlsx").Length

或者查找目录中路径超过 260 个字符的所有文件：
Get-ChildItem -Path "C:\Users\JaneDoe\OneDrive - Contoso" -Recurse | Where-Object { $_.FullName.Length -gt 260 } | Select-Object FullName, @{Name="PathLength";Expression={$_.FullName.Length}} | fl

在 macOS 上

在 Finder 中右键点按 (或按住 Control 键) 文件，然后选择“ 获取信息”。
“位置”字段显示完整的文件夹路径。为总计添加文件名长度。您还可以使用终端来检查路径长度：
echo -n "/Users/janedoe/Library/CloudStorage/OneDrive-Contoso/Projects/file.xlsx" | wc -c

在 OneDrive 网页版上

在浏览器中导航到文件。
痕迹导航轨迹和 URL 反映了文件路径。请注意，特殊字符是 URL 编码的，计入 400 个字符的限制。

注意

文件和文件夹名称中的特殊字符、空格和重音字符在 SharePoint 中采用 URL 编码， (例如，空格变为 %20) 。这些编码表单计入 400 个字符的限制，因此在浏览器中显短的路径可能使用比预期更多的字符。

在路径长度限制内工作的提示

使用更短的文件和文件夹名称

名称越短，路径中为文件夹深度留出更多空间。例如：

“QBR 说明 - 2026 年 1 月”而不是“季度业务审查会议记录 - 2026 年 1 月”
“Eng & Tech”而不是“Department of Engineering and Technology”

保持浅层文件夹结构

每个嵌套级别都会将字符添加到路径。与其使用深度嵌套的文件夹（如项目 > 2026 > 年第 1 > 季度客户工作 > Contoso > 可交付结果>>最终批准），不如考虑更扁平的结构（如项目 > 2026 年第 1 季度 Contoso > 最终可交付结果）。

使共享库的快捷方式保持易于管理

在将快捷方式添加到共享 SharePoint 库或 Teams 频道文件夹之前，请检查库的文件夹结构嵌套的深度。如果库已经有长路径，请考虑仅同步一个子文件夹而不是整个库，或者要求库所有者平展结构。添加快捷方式后，还可以在 OneDrive 中重命名快捷方式以使用更短的名称。

根据需要从 Web 重命名

如果文件或文件夹的路径过长而无法在文件资源管理器中使用，请转到 OneDrive 网站或 SharePoint 网站，并在其中进行重命名。路径足够短后，文件将正常同步到桌面。

将常用文件放置在靠近根的位置

存储在靠近 OneDrive 文件夹顶部的 Files 具有较短的路径。请考虑将常用文件保存在只有一两级深度的文件夹结构中。

注意 OneDrive 根文件夹长度

例如，OneDrive 同步文件夹路径 (， C:\Users\YourName\OneDrive - Organization Name) 在文件路径开始之前就使用了字符。组织名称越长，文件和文件夹可用的字符越少。 IT 管理员可以通过使用“为 OneDrive 文件夹设置自定义名称”组策略缩短其组织的此文件夹名称。