当前位置：首页 > news >正文

最大路径长度限制

news 来源：原创 2024/5/10 0:05:54

在 Windows API (（以下段落) 中讨论的一些例外情况）中，路径的最大长度为 MAX _ PATH， 定义为 260 个字符。按以下顺序构造本地路径：驱动器号、冒号、反杠、用反杠分隔的名称组件和终止 null 字符。例如，驱动器 D 上的最大路径为"D：某些 \ 256 个字符的路径字符串 < > NUL"，其中 < "NUL"表示当前系统代码页的不可见终止 > null 字符。 (此处 < > 字符集，用于视觉清晰，不能是有效路径字符串的一)

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

备注

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

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

备注

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

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

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

使用 API 创建目录时，指定的路径不能过长，因此不能追加 8.3 文件名 (也就是说，目录名称不能超过 MAX _ PATH 减 12) 。

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

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

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

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

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

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

cmd
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、CreateSymb一LinkW、DeleteFileW、FindFirstFileW、FindFirstFileExW、FindNextFileW、GetFileAttributesW、 GetFileAttributesExW、SetFileAttributesW、GetFullPathNameW、GetLongPathNameW、MoveFileW、MoveFileExW、MoveFileWithProgressW、ReplaceFileW、SearchPathW、FindFirstFileNameW、FindNextFileNameW、FindFirstStreamW、FindNextStreamW、GetCompressedFileSizeW、GetFinalPathNameByHandleW。