解除 Windows 10 的 260 字符路径限制(MAX_PATH)

Windows 默认把路径长度限制在 260 个字符(MAX_PATH),目录层级深一点的工程(典型如 UE/Unity 项目打包)经常撞上这个墙,报路径过长。Windows 10(1607)及更新版本可以开关掉这个限制。

背景见微软文档 Naming Files, Paths, and Namespaces。

方法一:改注册表

1. 打开注册表编辑器(regedit.exe)。
2. 定位到 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem。
3. 双击 LongPathsEnabled。
4. 值设为 1,确定。
5. 重新打包项目即可(实测不一定要重启机器)。

方法二:组策略

gpedit.msc → 计算机配置 → 管理模板 → 系统 → 文件系统 → 启用 Win32 长路径,设为"已启用"。本质和方法一改的是同一个开关。

一个前提

改之前最好先和写代码的人确认一句:程序里有没有自己写死的路径长度限制。如果是应用代码里硬编码了 260,改系统配置没用,只能去缩短路径名。系统开关只解决 Win32 API 这一层的限制。