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

我会带着你远行 2024-02-17 09:20 21阅读 0赞

## 最大路径长度限制 ##

*  项目
 *  2023/06/13
 *  9 个参与者

反馈

在 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 命令：

*  [注册表 (.reg) 文件][_.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`此注册表项。

*  [应用程序清单][Link 1]还必须包含 `longPathAware` 元素。
    
    XML复制
    
        <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。

[GetVolumeInformation]: https://learn.microsoft.com/zh-cn/windows/desktop/api/FileAPI/nf-fileapi-getvolumeinformationa
[_.reg_]: https://learn.microsoft.com/zh-cn/windows/win32/fileio/maximum-file-path-limitation?tabs=registry#tabpanel_1_registry
[PowerShell]: https://learn.microsoft.com/zh-cn/windows/win32/fileio/maximum-file-path-limitation?tabs=registry#tabpanel_1_powershell
[Link 1]: https://learn.microsoft.com/zh-cn/windows/win32/sbscs/application-manifests