Skip to content

Windows 路径长度上限

约 282 字小于 1 分钟

Windows

2025-02-26

Windows 默认路径长度上限为 260 个字符。如果文件路径(包括各级文件夹名称和文件名)超过此限制,会直接报错: invalid path。

验证路径是否超长:

  • 右键文件 -> 选择“属性” -> 查看“位置”后的完整路径长度。

如果路径类似:

C:\...\docs\issue\Node(v17+)报错Error:error:0308010C:digital envelope routines::unsupported.md

总长度很可能超过 260 个字符。

解决方法:

缩短路径层级:

将文件移动到更靠近根目录的路径。

缩短文件夹和文件名:

将文件名简化。

启用 Windows 长路径支持(推荐):

按下 Win + R,输入 regedit 打开注册表编辑器。

导航到:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem

右键空白区域 -> 新建 -> DWORD (32-bit) Value -> 命名为 LongPathsEnabled。

双击新建的项,将值设为 1。

重启电脑生效。

注意:此方法适用于 Windows 10/11,需管理员权限。