windows 11 默认路径长度限制为260字符,需启用长路径支持:组策略中启用“启用 win32 长路径”或家庭版用powershell设置longpathsenabled=1;git需单独执行git config --system core.longpaths true;临时可用\?前缀绕过限制。

当你在 Windows 11 中复制、移动或解压大型项目(比如 Node.js 依赖包、Unity 工程、PSD 嵌套素材库)时,系统突然弹出“文件名对目标文件夹可能过长”,这不是磁盘空间不足,也不是权限问题,而是 Windows 默认路径长度被卡死在 260 字符——而你的实际路径早已突破这个老古董限制。
启用系统级长路径支持
这一步是所有后续操作的前提,不做就永远绕不开报错。它告诉 Windows 内核:允许应用程序使用真正的 NTFS 路径能力(最高 32767 字符),而不是继续套用 DOS 时代的 260 字符缓冲区。
1、按下 Win + R 打开运行框,输入 gpedit.msc 回车(家庭版用户跳至方法二);
2、依次展开:计算机配置 → 管理模板 → 系统 → 文件系统;
3、双击右侧“启用 Win32 长路径”,选择“已启用”,点击确定;
4、重启资源管理器或直接重启电脑——不重启,新策略不会加载进当前会话。
⚠️ 家庭版无组策略编辑器?用 PowerShell 替代:以管理员身份运行 PowerShell,执行:
Set-ItemProperty -Path "HKLM:SYSTEMCurrentControlSetControlFileSystem" -Name "LongPathsEnabled" -Value 1 -Type DWord
为 Git 单独开启长路径
即使系统级已放开,Git for Windows 默认仍走旧 API 路径,clone 或 checkout 深层目录时照样报错 “filename too long”。必须显式告诉 Git:别再怕长名字。
方法一:全局启用(推荐)
在任意位置右键打开“Git Bash”,执行:
git config --system core.longpaths true
方法二:仅对当前仓库生效
进入项目根目录后执行:
git config core.longpaths true
注意:--system 参数需管理员权限,若提示权限拒绝,请右键 Git Bash → “以管理员身份运行”后再试。
手动触发长路径模式(应急用)
当某次复制/解压失败,又不想改系统设置或等重启时,可临时绕过限制——本质是让 Windows 跳过 MAX_PATH 校验,直连 NTFS 驱动层。
第一步:把目标文件夹路径复制下来,例如 D:workproject
ode_modules@types
eact-router-domlib;
第二步:在路径最前面加上 \?,变成:\?D:workproject
ode_modules@types
eact-router-domlib;
第三步:把这个带前缀的路径粘贴进资源管理器地址栏并回车——此时你进入的是“长路径视图”,所有操作(复制、新建、重命名)都自动启用长路径协议。
⚠️ 这个前缀不能省略斜杠,也不能加在 UNC 路径(如 \servershare)上,只适用于本地驱动器路径。











