260 字符限制从哪来
MAX_PATH 这个 260 字符限制来自早期 Win32 API 的设计：盘符加冒号加反斜杠再加 255 个字符的路径，绝大多数老程序都按这个长度分配缓冲区。Windows 10 1607 与 Server 2016 起系统提供了长路径支持开关，但这是「系统允许」而不是「应用一定支持」——程序本身要声明长路径感知，工具也要更新版本，否则深目录仍会报「文件名或扩展名太长」。
基本信息
| 适用平台 | Windows 10 1607 与 Windows Server 2016 及以后支持开关 |
|---|---|
| 注册表位置 | HKLM\SYSTEM\CurrentControlSet\Control\FileSystem 下的 LongPathsEnabled |
| 组策略路径 | 计算机配置 → 管理模板 → 系统 → 文件系统 → 启用 Win32 长路径 |
| 生效方式 | 修改后需重启（部分场景需应用自身也支持） |
| 命令行绕过 | 使用 \\?\ 前缀给出完整路径（不支持相对路径） |
| 权限要求 | 修改注册表与策略需要管理员 |
典型使用场景
- 前端工程目录：node_modules 嵌套极深，解压或安装时报路径过长
- 构建产物迁移：从 Linux 迁到 Windows 后深目录复制失败
- 备份与归档：老备份工具跳过超长路径下的文件，恢复时缺文件
- 软件卸载残留：删除深目录时资源管理器直接报错
- 磁盘迁移：跨盘拷贝深层目录屡次失败，需确认工具是否支持长路径
常用示例
常用示例
# 查看当前是否已启用长路径
Get-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name LongPathsEnabled
# 开启（管理员执行，重启后全面生效）
Set-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name LongPathsEnabled -Value 1
# 组策略方式（域环境统一下发）
# 计算机配置 -> 管理模板 -> 系统 -> 文件系统 -> 启用 Win32 长路径
# 统计目录树中最长路径长度，用于评估是否需要处理
$max = (Get-ChildItem 'D:\Project' -Recurse -File -ErrorAction SilentlyContinue |
ForEach-Object { $_.FullName.Length } | Measure-Object -Maximum).Maximum
'{0} 字符' -f $max几种应对手段对照
| 手段 | 适用场景 | 注意 |
|---|---|---|
| LongPathsEnabled 注册表 | 本机统一解除限制 | 应用也需支持，未声明的老程序仍会失败 |
| 组策略启用长路径 | 域内批量下发 | 需 1607 以上系统，生效常需重启 |
| \\?\ 前缀 | 命令行临时访问深路径 | 必须完整路径、不支持相对路径，部分工具不认 |
| 8.3 短名 | 老工具临时访问 | 目录需未关闭短名生成，且不易阅读 |
| robocopy 等新工具 | 大批量迁移复制 | 对长路径支持较好，迁移优先选它 |
长路径支持是链路问题：操作系统、API、应用三者都支持才彻底解决。只改了注册表就期待所有软件恢复正常，通常会在某个不支持的老工具上重新碰壁。
深目录在删除操作上也常失败：资源管理器与部分老旧命令删除超长路径时直接报错，可先用支持长路径的工具重命名上层目录缩短路径，再删除，效率更高。
迁移与清理的可行做法
迁移与清理的可行做法
REM 用 robocopy 做长路径迁移（对新路径支持较好）
REM robocopy D:\Src E:\Dst /E /COPY:DAT /R:1 /W:1 /XJ /NP /LOG:D:\copy.log
REM 清理深目录：先缩短上层名称，再逐层删除
REM Rename-Item -LiteralPath 'D:\Project\a\b\c' -NewName 'c2'
REM 需要查看具体超长路径时，用支持长路径的工具枚举并导出清单启用长路径后要留意老备份软件的清单：部分工具仍按 260 字符截断或跳过，备份「成功」但缺少深路径文件，恢复时才发现，审计时应抽样验证深目录是否真在备份集内。