>

Windows 开启长路径支持(解决"路径太长"报错)

通过注册表 LongPathsEnabled=1 解除 260 字符路径限制,处理 node_modules、解压深层目录等超长路径问题。

Windows注册表文件管理员路径中风险
在管理员命令行运行上面的 reg add 命令,把 HKLM\...\FileSystem\LongPathsEnabled 设为 1,然后重启电脑。

01命令

命令
$ reg add "HKLM\SYSTEM\CurrentControlSet\Control\FileSystem" /v LongPathsEnabled /t REG_DWORD /d 1 /f

02作用说明

老的 Win32 接口把路径限制在 260 个字符(MAX_PATH),所以解压压缩包或删除 node_modules 时常会报"路径太长"。把 LongPathsEnabled 设为 1 后,支持长路径的程序可以使用约 32000 字符的路径;前提是程序自身声明支持(git 需要另外执行 git config core.longpaths true)。robocopy 和 \\?\ 前缀可以针对单条命令绕过限制,不必改注册表。

03风险

风险中风险
使用条件Elevated (admin) prompt; restart required; the application itself must be long-path aware.
!注意: 改注册表需要重启电脑;不支持长路径的老程序依然会报错,这个设置不是对所有软件都有效。

04撤销

撤销
$ reg add "HKLM\SYSTEM\CurrentControlSet\Control\FileSystem" /v LongPathsEnabled /t REG_DWORD /d 0 /f

05来源

  • Maximum File Path Limitation
    Microsoft Learn · vendor-doc · 2026-09-17
    依据: Documents the 260-character MAX_PATH limit and the LongPathsEnabled registry key that lifts it for long-path-aware apps.

最后验证: 2026-09-18 · 分类: 文件与文件夹

06相关方案

用 chkdsk 检查磁盘文件系统错误
Windows文件系统诊断

在不停机的前提下诊断卷上的 NTFS 文件系统错误和坏扇区,包括正在运行的系统盘。

低风险 ✓ 2026-09-17
用 robocopy /MIR 镜像文件夹做精确备份
Windows文件系统终端

robocopy 是 Windows 内置的健壮复制工具,/MIR 可以让目标目录与源目录保持完全一致的镜像,且支持断点续传。

高风险 ✓ 2026-09-17
用 takeown 和 icacls 夺回文件所有权
Windows文件系统安全

两步命令把自己设为被锁定文件树的所有者并授予完全控制权限,是修复「拒绝访问」的标准做法。

高风险 ✓ 2026-09-17