最大路径长度限制

  • 项目

在 Windows API (（以下段落) 中介绍的一些例外情况）中，路径的最大长度为 MAX_PATH，定义为 260 个字符。 本地路径按以下顺序构建：驱动器号、冒号、反斜杠、用反斜杠分隔的名称组件以及终止 null 字符。 例如，驱动器 D 上的最大路径为“D：\some 256 个字符的路径字符串<NUL>”，其中“<NUL>”表示当前系统代码页的不可见终止 null 字符。 (此处使用的字符 <> 是为了直观明了，不能是有效路径 string 的一部分。)

例如，如果将具有长文件名的 git 存储库克隆到本身具有长名称的文件夹，则可能会达到此限制。

注意

Windows API 中的文件 I/O 函数将“/”转换为“\”作为将名称转换为 NT 样式名称的一部分，除非使用“\\？\”前缀，如以下部分所述。

Windows API 具有许多函数，这些函数还具有 Unicode 版本，允许扩展路径的最大总路径长度为 32，767 个字符。 这种类型的路径由由反斜杠分隔的组件组成，每个组件最多为 GetVolumeInformation 函数的 lpMaximumComponentLength 参数中返回的值， (此值通常为 255 个字符) 。 若要指定扩展长度路径，请使用“\\？\”前缀。 例如，“\\？\D：\long path”。

注意

最大路径为 32，767 个字符是近似值，因为系统可能会在运行时将“\\？\”前缀扩展为较长的字符串，并且此扩展适用于总长度。

“\\？\”前缀还可用于根据 UNC) 通用命名约定 (构造的路径。 若要使用 UNC 指定此类路径，请使用“\\？\UNC\”前缀。 例如，“\\？\UNC\server\share”，其中“server”是计算机的名称，“share”是共享文件夹的名称。 这些前缀不用作路径本身的一部分。 它们指示应以最少的修改将路径传递给系统，这意味着不能使用正斜杠来表示路径分隔符，不能使用句点表示当前目录，也不能使用双点表示父目录。 由于不能将“\？\”前缀与相对路径一起使用，因此相对路径始终限制为 总共MAX_PATH 个字符。

Windows 文件 I/O API 函数无需对路径和文件名字符串执行任何 Unicode 规范化，因为文件系统将路径和文件名视为 WCHAR的不透明序列。 在对相关 Windows 文件 I/O API 函数的任何调用外部，执行应用程序所需的任何规范化时，都应牢记这一点。

使用 API 创建目录时，指定的路径不能太长，无法追加 8.3 文件名 (即目录名称不能超过 MAX_PATH 减 12) 。

shell 和文件系统有不同的要求。 可以使用 Windows API 创建 shell 用户界面无法正确解释的路径。

在 Windows 10 版本 1607 及更高版本中启用长路径

从 Windows 10 版本 1607 开始，从常见的 Win32 文件和目录函数中删除了MAX_PATH限制。 但是，必须选择加入新行为。

若要启用新的长路径行为，必须满足以下两个条件：

  • 注册表项 Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled (Type: REG_DWORD) 必须存在，并且设置为 1。 第一次调用受影响的 Win32 文件或目录函数后，系统 (将按进程) 缓存密钥的值， (请参阅下面的函数) 列表。 在进程的生存期内，不会重新加载注册表项。 为了使系统上的所有应用都能识别密钥的值，可能需要重新启动，因为某些进程可能在设置密钥之前启动。

还可以将此代码复制到 .reg 可为你设置此代码的文件，或使用具有提升权限的终端窗口中的 PowerShell 命令：

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem]
"LongPathsEnabled"=dword:00000001

注意

还可以通过 组策略 来控制Computer Configuration > Administrative Templates > System > Filesystem > Enable Win32 long paths此注册表项。

  • 应用程序清单还必须包含 longPathAware 元素。

    <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings xmlns:ws2="http://schemas.microsoft.com/SMI/2016/WindowsSettings">
        <ws2:longPathAware>true</ws2:longPathAware>
    </windowsSettings>
</application>

如果选择加入长路径行为，这些目录管理功能不再具有 MAX_PATH 限制：CreateDirectoryW、CreateDirectoryExW GetCurrentDirectoryW RemoveDirectoryW SetCurrentDirectoryW。

选择加入长路径行为时，这些是不再具有 MAX_PATH 限制的文件管理功能：CopyFileW、CopyFile2、CopyFileExW、CreateFileW、CreateFile2、CreateHardLinkW、CreateSymbolicLinkW、DeleteFileW、 FindFirstFileW、FindFirstFileExW、FindNextFileW、GetFileAttributesW、GetFileAttributesExW、SetFileAttributesW、GetFullPathNameW、GetLongPathNameW、MoveFileW、MoveFileExW、MoveFileWithProgressW、ReplaceFileW、SearchPathW、FindFirstFileNameW、FindNextFileNameW、FindFirstStreamW、FindNextStreamW、GetCompressedFileSizeW、GetFinalPathNameByHandleW。