Windows 路径长度上限
约 280 字小于 1 分钟
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
,需管理员权限。