windows 11长路径限制需通过启用win32长路径解除:专业版用gpedit.msc启用“启用win32长路径”并重启;家庭版需在注册表hkey_local_machine\system\currentcontrolset\control\filesystem下新建或修改dword值longpathsenabled为1;所有版本可用powershell命令一键写入,均须重启生效。

当你在 Windows 11 中复制一个来自 node_modules 或构建产物的深层嵌套文件夹时,资源管理器突然弹出“路径太长”错误,或重命名文件时卡死无响应,说明当前完整路径已突破系统默认的 260 字符 MAX_PATH 限制——这并非文件损坏,而是内核级硬性拦截,必须修改系统底层策略才能彻底解除。
专业版/企业版/教育版:用组策略启用长路径
第一步:按 Win + R 输入 gpedit.msc 并回车,打开本地组策略编辑器。
第二步:依次展开左侧树形菜单:计算机配置 → 管理模板 → 系统 → 文件系统。
第三步:在右侧列表中找到“启用 Win32 长路径”,双击打开。
第四步:勾选“已启用”,点击“确定”保存。这一步操作起来很简单,但【必须重启电脑才生效】,否则所有后续操作仍会失败。
家庭版用户:手动修改注册表
方法一:按 Win + R 输入 regedit,以管理员身份运行注册表编辑器。
方法二:导航至路径:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem。
方法三:右键右侧空白处 → 新建 → DWORD (32位) 值,命名为 LongPathsEnabled。
方法四:双击该值,将“数值数据”设为 1(十进制),点击“确定”。
【若该键已存在但值为 0,直接双击改写即可,无需删除重建】
所有版本通用:PowerShell 一键写入注册表
① 右键“开始”按钮 → 选择“终端(管理员)”。
② 在弹出的 UAC 提示中点击“是”。
③ 粘贴并执行以下命令:
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
④ 若返回结果中包含 LongPathsEnabled 和 1,说明写入成功。
⑤ 关闭终端,重启计算机。
立即验证是否生效
重启后,打开文件资源管理器,尝试复制或重命名原先报错的那个长路径文件。若不再弹出“路径太长”提示,且操作能正常完成,说明设置已生效。











