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

应用对象

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 Finder	1,024 个字符	单个文件或文件夹名称限制为 255 个字符。具有多字节 Unicode 字符的路径在文件系统级别可能超过 1,024 个字节，即使字符计数似乎在限制内也是如此。
已启用 windows 文件系统 (长路径)	32,767 个字符	若要使用较长路径，必须启用 LongPathAware 组策略设置。即便如此，每个应用程序都必须单独选择加入以支持扩展长度路径。文件资源管理器和 Office 桌面应用当前未选择加入，因此仅启用策略不会更改大多数用户的 260 个字符限制。
第三方应用	各不相同	第三方应用程序可能有其自己的路径长度限制，与操作系统无关。如果在非Microsoft软件中遇到与路径相关的错误，请与应用开发人员联系。

在何处可能会遇到路径长度问题

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

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

计算机上未显示的文件夹

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

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

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

SharePoint 快捷方式和同步库

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

从迁移Files

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

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

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

即使不到 260 个字符，Office 临时文件也会失败

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 上

右键单击“ (”或“Control”单击“) Finder 中的文件，然后选择” 获取信息”。
“ Where” 字段显示完整的文件夹路径。为总计添加文件名长度。还可以使用终端检查路径长度：
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”而不是“工程技术系”

使文件夹结构保持浅表

每个嵌套级别都会向路径添加字符。考虑一个更扁平的结构，如 Projects 2026-Q1 Contoso 最终可交付结果，而不是像 Projects > 2026-Q1 >>>>>>Contoso > 最终可交付结果这样的深层嵌套文件夹。>

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

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

在需要时从 Web 重命名

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

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

Files更靠近 OneDrive 文件夹顶部的存储路径较短。考虑将最常用的文件保留在只有一个或两个级别深的文件夹结构中。

请注意 OneDrive 根文件夹长度

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